Query Details
This endpoint returns the top token holders for a given asset, along with enriched metadata. You can query by token name, symbol, or contract address + blockchain ID. Parametersasset
(required) — Asset name or contract address.symbol
(optional) — Token ticker symbol (e.g.,ETH
,BTC
). The API will attempt to resolve the asset by symbol. Symbols may be ambiguous; preferasset
as a contract address +blockchain
for exact results.blockchain
(required if using address) — Blockchain identifier (e.g.,1
for Ethereum,solana
for Solana).limit
— Number of results to return (default: 20).offset
— Pagination offset (default: 0).
- If a contract address is provided in
asset
, it takes precedence oversymbol
. - If using
symbol
, results may vary if multiple tokens share the same ticker.
Usage Examples
Query Response
The response returns a list of token holders with enriched metadata:- address — Wallet address of the holder
- amountRaw — Token balance in raw units (before applying decimals)
- amount — Token balance in formatted units
- chainId — Blockchain identifier (e.g.,
ethereum:1
,solana:solana
) - totalSupplyShare — Percentage of the total token supply held by this address
- amountUSD — USD equivalent of the token balance
- tag — Enriched label describing the address type (e.g.,
dev
,LP {SYMBOL0}/{SYMBOL1}
,holder
)
Query Parameters
Required range:
x <= 100