Skip to main content
GET
Get Token Holder List by Contract Address
Effective July 1, 2026, the maximum records returned per request will be reduced from 10,000 to 1,000 for Free tier API users. See the full list of affected endpoints.
This is a PRO endpoint, available to the Standard Plan and above

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:tokenholderlist
required

Set to tokenholderlist for this endpoint.

contractaddress
string
required

Contract address of the ERC-20 token.

page
integer

Page number for pagination.

offset
integer

Number of records per page. Use the page parameter for subsequent records.