Token API

Get day-by-day holder count history for an ERC-20 token

Returns the per-day count of unique holders for the specified ERC-20 token, along with the total token amount on-chain at each snapshot. Useful for charting distribution trends or feeding token-analytics dashboards.

Pass contractAddress of the token plus the blockchain it lives on. The history is paginated; use pageSize (default 10000, max 10000) and pageToken to walk further back in time. latestHoldersCount is the most recent week's count.

Part of the Token API product (700 compute units per call, $0.00007 at base rate).

post/?ankr_getTokenHoldersCount

Request

Base URL
https://rpc.ankr.com/multichain/569ca1f392f7d3d0bb1073a1173ecb649af1d9249231fe59fa95db19d5ae41fe
Auth
none declared
TypeScript
https://skmtc.dev/ankr/apis/ankr-advanced-api/docs/%3Fankr_getTokenHoldersCount/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

idinteger required

Client-supplied request ID echoed in the response.

jsonrpc'2.0' required

method'ankr_getTokenHoldersCount' required

Example request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ankr_getTokenHoldersCount",
  "params": {
    "blockchain": "eth",
    "contractAddress": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852",
    "pageSize": 2
  }
}

Response

Success. JSON-RPC result carries the daily history and the latest holder count. JSON-RPC errors are returned with HTTP 200; check the response body for an error key.