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.

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

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.

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

Example:ethereum

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

limitinteger

Results per page

Example:20

Results per page

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

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

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

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

Token Holders

Query parameters

Response

Example response

Changes