ankr_getTokenHoldersCount

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

POST 
/?ankr_getTokenHoldersCount

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).

Request

Responses

200

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.

400

Bad Request — malformed JSON-RPC envelope or invalid params. The gateway rejects before the JSON-RPC layer processes the call.

401

Unauthorized — missing or invalid API key in the server URL path. Verify that {API_KEY} is set to a valid project key.

429

Too Many Requests — the API key has exceeded its rate or quota limits. Back off and retry; consider upgrading the Premium tier for higher limits.

500

Server error — unexpected condition. Retry with exponential backoff; if it persists, file a ticket at https://www.ankr.com/support/.