Expose whoami

dune/dune.go

@@ -128,6 +128,9 @@ type DuneClient interface {
 
 	// SearchDatasetsByContractAddress finds decoded datasets associated with a smart contract address
 	SearchDatasetsByContractAddress(req models.SearchDatasetsByContractAddressRequest) (*models.SearchDatasetsResponse, error)
+
+	// WhoAmI returns the identity associated with the current API key
+	WhoAmI() (*models.WhoAmIResponse, error)
 }
 
 type duneClient struct {
@@ -165,6 +168,7 @@ var (
 	archiveQueryURLTemplate                    = "%s/api/v1/query/%d/archive"
 	searchDatasetsURLTemplate                  = "%s/api/v1/datasets/search"
 	searchDatasetsByContractAddressURLTemplate = "%s/api/v1/datasets/search-by-contract"
+	whoamiURLTemplate                          = "%s/api/whoami"
 )
 
 var ErrorRetriesExhausted = errors.New("retries have been exhausted")

dune/whoami.go

@@ -0,0 +1,28 @@
+package dune
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/duneanalytics/duneapi-client-go/models"
+)
+
+func (c *duneClient) WhoAmI() (*models.WhoAmIResponse, error) {
+	reqURL := fmt.Sprintf(whoamiURLTemplate, c.env.Host)
+	req, err := http.NewRequest("GET", reqURL, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	resp, err := httpRequest(c.env.APIKey, req)
+	if err != nil {
+		return nil, err
+	}
+
+	var whoamiResp models.WhoAmIResponse
+	if err := decodeBody(resp, &whoamiResp); err != nil {
+		return nil, err
+	}
+
+	return &whoamiResp, nil
+}

models/whoami.go

@@ -0,0 +1,10 @@
+package models
+
+// WhoAmIResponse represents the response from the /api/whoami endpoint.
+// It identifies the user or team associated with the current API key.
+type WhoAmIResponse struct {
+	CustomerID string `json:"customer_id"` // e.g. "user_123" or "team_456"
+	CreatedBy  int    `json:"created_by"`  // integer user ID of the key creator
+	APIKeyID   string `json:"api_key_id"`  // ULID of the API key
+	Handle     string `json:"handle"`      // username or team handle
+}