get_token_holder_snapshot
Read · No sign-in
Get a token's holder snapshot
How concentrated a token's holders are: the total holder count, the share of supply held by the top 10/50/100/200 wallets and how many wallets hold half the supply. Refreshed about daily from a market-data vendor; fetchedAt says when. It lists no wallet addresses. Counts of flagged wallets (snipers, bundlers, insiders) are unavailable, so quality is empty. For a coin launched on Chain Daddy, openBlock says who bought in its opening blocks ("bundled at open"); it is absent when those blocks were not seen.
A token page id is unique per chain, not across chains; symbol and chainId in the answer say which token it describes. 404 means no token page, or no snapshot yet.
| Reads or changes | Reads only |
| Sign-in | No |
| Calls | GET /api/v2/registration/{id}/holders (API Explorer) |
Input
JSON Schema, as the server serves it.
{
"additionalProperties": false,
"properties": {
"id": {
"description": "The token page's id (the registration's numeric token id)",
"format": "int64",
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
}Example
A tools/call request:
{
"name": "get_token_holder_snapshot",
"arguments": {
"id": 1
}
}