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, how many wallets hold half the supply, and counts of snipers, bundlers, insiders and sandwich traders. Refreshed about daily from a market-data vendor; fetchedAt says when.
Use it to judge distribution or risk. It never lists wallet addresses; for the people who subscribed to a token's updates, use the community member routes instead.
The mistake to avoid: a token page id is unique per chain, not across chains. Check that symbol and chainId in the answer are the token you meant. 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
}
}