ASasksurf
Token

Token Holders

Returns top token holders for a contract address.

Included fields: wallet address, balance, and percentage.

Lookup: by address and chain. Supports EVM chains and Solana.

get/gateway/v1/token/holders

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

addressstring required

Token CONTRACT ADDRESS — 0x-prefixed hex for EVM chains, base58 for Solana. This is NOT a ticker symbol (e.g. do NOT pass USDC or BTC). To resolve a ticker symbol to a contract address, call GET /v1/search/token?q={symbol}&chain={chain} and use the address whose chain is supported by this endpoint. This endpoint has no symbol parameter.

Example:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
chain'ethereum' | 'polygon' | 'bsc' | 'solana' | 'avalanche' | 'arbitrum' | 'optimism' | 'base' required

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

Example:ethereum
limitinteger

Results per page

Example:20
offsetinteger

Pagination offset

includestring

Comma-separated enrichments to attach to each holder. Currently valid: labels — adds a full label record alongside the flat entity_name / entity_type fields.

Example:labels

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseTokenHolderItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.