Get Top Token Holders
Tokens
Get Top Token Holders
Returns the list of top holders for a specified ERC-20 token.
GET
Get Top Token Holders
This is a PRO endpoint, available to the Standard Plan and above.
HyperEVM (999) is not supported yet.

Authorizations
Enter your Etherscan API key, or set one up if you don't have one.
Query Parameters
Chain ID to query, eg 1 for Ethereum, 42161 for Arbitrum from our supported chains.
Set to token for this endpoint.
Set to topholders for this endpoint.
Contract address of the ERC-20 token.
Number of top holders to return, up to 1000.
Response
200 - application/json
Successful response
1 if the request returned data, 0 otherwise. A status of 0 can indicate an error or a valid request that returned no records.
OK on success, otherwise an error description such as NOTOK. See common error messages.