Skip to main content
GET
/
gateway
/
v1
/
token
/
holders
Token Holders
curl --request GET \
  --url https://api.ask.surf/gateway/v1/token/holders
{
  "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": "<string>"
}

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

OK

data
object[] | null
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

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