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

Authorizations

apikey
string
query
required

Your Etherscan API key.

Query Parameters

chainid
string
required

Chain ID to query, eg 1 for Ethereum, 8453 for Base from our supported chains.

module
string
default:token
required

Set to token for this endpoint.

action
string
default:topholders
required

Set to topholders for this endpoint.

contractaddress
string
required

Contract address of the ERC-20 token.

offset
integer

Number of top holders to return, up to 1000.