Token Holder Snapshots
Holder distribution, rankings, and concentration metrics for tracked ERC-20 tokens
Token holder snapshots for top ERC-20 assets on Ethereum (MVP scope), with holder rankings, concentration summaries, and inequality metrics for tokenomics analysis, treasury surveillance, and governance risk monitoring.
x402 API — $0.02-$0.04/query Snowflake — $0.03-$0.06/query Databricks — $0.024-$0.048/query
Use cases
- ✓ Token concentration and whale dominance analysis
- ✓ Governance decentralization scoring
- ✓ Treasury and vesting unlock monitoring
- ✓ Holder migration over time
- ✓ Risk checks before large trades
Response fields
| Field | Type | Description |
|---|---|---|
| token_address | string | ERC-20 contract address |
| token_symbol | string | Token symbol |
| holder_address | string | Holder wallet address |
| balance | number | Token balance |
| percentage_of_supply | number | Share of total supply |
| rank | integer | Holder rank in snapshot |
| chain | string | Blockchain network |
Example queries
Top holders for a token
GET /api/v1/holders/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?chain=ethereum&limit=100Returns top ranked holders for the latest snapshot
Concentration metrics
GET /api/v1/holders/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/concentrationReturns gini coefficient and top holder percentages
Free stats
GET /api/v1/holders/statsReturns tracked token count and indexed holders