The Holders data product exposes per-token holder tables and distribution metrics, so you can answer “who owns this token?”, “how concentrated is it?” and “who just moved?” without scraping explorers.Documentation Index
Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
Use this file to discover all available pages before exploring further.
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.