Skip to main content
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.

​
What’s inside

​
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.