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.
How customers use this
DAO governance analysis
Assess voter concentration before participating in a governance proposal. If a handful of wallets control the outcome, your vote may not matter — or the token may face governance attacks.
Rug risk detection for traders
Avoid tokens where the top 10 holders control more than 80% of supply. Extreme concentration means a single wallet can crash the price — check holder distribution before you buy.
Airdrop and token launch analysis
Check eligibility snapshots and holder distribution before token launches. Understand who holds what, how supply is distributed, and whether the airdrop is going to real users or sybil farms.
Sample data
Example responses from the API. Each query returns structured JSON.
GET /api/v1/holders/0xdAC17F958D2ee523a2206206994597C13D831ec7?limit=3
{
"token": "USDT",
"contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"holders": [
{ "address": "0x5754...a83f", "balance": 2891000000, "pct_supply": 4.21 },
{ "address": "0xf977...12c8", "balance": 1823000000, "pct_supply": 2.65 },
{ "address": "0x47ac...e9d1", "balance": 1234000000, "pct_supply": 1.80 }
]
}GET /api/v1/holders/0xdAC17F958D2ee523a2206206994597C13D831ec7/concentration
{
"token": "USDT",
"total_holders": 4812943,
"top_10_pct": 23.4,
"top_50_pct": 41.2,
"top_100_pct": 52.8,
"gini_coefficient": 0.89,
"snapshot_block": 21345678
}GET /api/v1/holders/stats
{
"tokens_tracked": 12489,
"total_holder_records": 891234567,
"chains_covered": 6,
"last_updated": "2025-12-01",
"snapshot_frequency": "daily"
}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