Skip to main content
GET
https://api.etherscan.io
/
v2
/
api
curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=topholders&contractaddress=0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9&offset=100&apikey=YourApiKeyToken"

{
  "status": "1",
  "message": "Ok",
  "result": [
    {
      "TokenHolderAddress": "0x4da27a545c0c5b758a6ba100e3a049001de870f5",
      "TokenHolderQuantity": "2696124.3026660371030000",
      "TokenHolderAddressType": "C"
    },
    {
      "TokenHolderAddress": "0xa700b4eb416be35b2911fd5dee80678ff64ff6c9",
      "TokenHolderQuantity": "1650828.8050095955930000",
      "TokenHolderAddressType": "C"
    }
  ]
}
This is a PRO endpoint, available to any paid tier
This historical endpoint is throttled to 2 calls/s
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.
curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=topholders&contractaddress=0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9&offset=100&apikey=YourApiKeyToken"

{
  "status": "1",
  "message": "Ok",
  "result": [
    {
      "TokenHolderAddress": "0x4da27a545c0c5b758a6ba100e3a049001de870f5",
      "TokenHolderQuantity": "2696124.3026660371030000",
      "TokenHolderAddressType": "C"
    },
    {
      "TokenHolderAddress": "0xa700b4eb416be35b2911fd5dee80678ff64ff6c9",
      "TokenHolderQuantity": "1650828.8050095955930000",
      "TokenHolderAddressType": "C"
    }
  ]
}