What’s inside
| Field group | Examples |
|---|---|
| Table | rank, address, balance, shareOfSupply, entityLabel, costBasisUsd |
| Distribution | giniCoefficient, top10Share, top100Share |
| Changes | changesLast24h (additions, exits, net rank movement) |
| Classification | bucket — whale / shrimp / contract / exchange / liquidity-pool |
Coverage & freshness
- Available on every chain in Supported Chains.
- Holder balances refreshed within seconds of matching transfer events.
- Distribution metrics recomputed every 5 minutes.
Access
REST
/v2/token/{chain}/{tokenAddress}/holders, /v2/token/{chain}/{tokenAddress}/topholders.WebSocket
dex-token-holding:{chain}_{tokenAddress} — holder distribution and balance-tag counts streamed live. SDK: client.stream.subscribeTokenHolders.GraphQL
Join Holders with Wallets for enriched rows.
SDK / MCP
tokens_analyze tool for agents — returns holder list, top-N concentration, Gini and bucket classification in one call.Common use cases
- Detect whale accumulation or distribution
- Airdrop eligibility snapshots
- Concentration-risk scoring for token due-diligence
- Chart top-10 share over time
Billing
Per-call 1 read unit; large holder tables paginated.Next
Wallets
Drill into any holder for full profile and PnL.
Smart Money
Detect when smart-money cohorts appear in the holder list.