Skip to content

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 changesReads only
Sign-inNo
CallsGET /api/v2/registration/{id}/holders (API Explorer)

Input ​

JSON Schema, as the server serves it.

json
{
  "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:

json
{
  "name": "get_token_holder_snapshot",
  "arguments": {
    "id": 1
  }
}

All MCP tools · Connect an AI app