Token Holders

GET /gateway/v1/token/holders

Token Holders

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/token/holders

200

{
  "data": [
    {
      "address": "<string>",
      "balance": "<string>",
      "entity_name": "<string>",
      "entity_type": "<string>",
      "percentage": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "https://example.com/schemas/DataResponseTokenHolderItem.json"
}

Query Parameters

address · string · required

Token contract address (0x-prefixed hex or Solana base58)

Example:

"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"

chain · enum<string> · required

Chain. Can be ethereum, polygon, bsc, solana, avalanche, arbitrum, optimism, or base.

Available options: ethereum, polygon, bsc, solana, avalanche, arbitrum, optimism, base

Example:

"ethereum"

limit · integer<int64> · default: 20

Results per page

Required range: 1 <= x <= 100

Example:

20

offset · integer<int64> · default: 0

Pagination offset (accepted for API consistency but currently ignored)

Required range: x >= 0

Example:

0

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseTokenHolderItem.json"