ankr_getTokenHolders
List wallet holders of an ERC-20 token, ranked by balance
POST/?ankr_getTokenHolders
Returns wallet addresses that hold the specified ERC-20 token, with each holder's human-readable balance and the raw integer balance (value × 10^decimals). Holders are returned ranked by balance, descending.
Pass contractAddress of the token plus the blockchain it lives on. Paginate with pageSize (default 10000, max 10000) and the nextPageToken echoed in each response.
Part of the Token API product (700 compute units per call, $0.00007 at base rate).
Request
Responses
- 200
- 400
- 401
- 429
- 500
Success. JSON-RPC result carries holder list plus token decimals and total holder count. JSON-RPC errors are returned with HTTP 200; check the response body for an error key.
Bad Request — malformed JSON-RPC envelope or invalid params. The gateway rejects before the JSON-RPC layer processes the call.
Unauthorized — missing or invalid API key in the server URL path. Verify that {API_KEY} is set to a valid project key.
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.
Server error — unexpected condition. Retry with exponential backoff; if it persists, file a ticket at https://www.ankr.com/support/.