Skip to main content
GET
Get Top Token Holders
This is a PRO endpoint, available to the Standard Plan and above.
This endpoint is throttled to 2 calls/second regardless of API Pro tier.
HyperEVM (999) is not supported yet.
Token holders

Query parameters

apikey
string
default:"YourApiKeyToken"
Your Etherscan API key.
chainid
string
default:"1"
Chain ID to query, eg 1 for Ethereum, 8453 for Base from our supported chains.
module
string
default:"token"
Set to token for this endpoint.
action
string
default:"topholders"
Set to topholders for this endpoint.
contractaddress
string
default:"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"
Contract address of the ERC-20 token.
offset
integer
default:"100"
Number of top holders to return, up to 1000.