Skip to main content
GET
https://api.etherscan.io
/
v2
/
api
curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action="/?originalUrl=https%3A%2F%2Fdocs.etherscan.io%2Ftokenholderlist%26amp%3Bcontractaddress%3D0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d%26amp%3Bpage%3D1%26amp%3Boffset%3D10%26amp%3Bapikey%3DYourApiKeyToken%26quot%3B%253C%2Fspan">

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenHolderAddress": "0xa5b7d615c99f011a22f16f5809890ca6900200a3",
      "TokenHolderQuantity": "2"
    },
    {
      "TokenHolderAddress": "0x0412a1d25fbdcabc536603198330021ccb13240b",
      "TokenHolderQuantity": "3385700"
    }
  ]
}
This is a PRO endpoint, available to the Standard Plan and above

​
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:"tokenholderlist"
Set to tokenholderlist for this endpoint.
​
contractaddress
string
default:"0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d"
Contract address of the ERC-20 token.
​
page
integer
default:"1"
Page number for pagination.
​
offset
integer
default:"10"
Number of records per page.
curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action="/?originalUrl=https%3A%2F%2Fdocs.etherscan.io%2Ftokenholderlist%26amp%3Bcontractaddress%3D0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d%26amp%3Bpage%3D1%26amp%3Boffset%3D10%26amp%3Bapikey%3DYourApiKeyToken%26quot%3B%253C%2Fspan">

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenHolderAddress": "0xa5b7d615c99f011a22f16f5809890ca6900200a3",
      "TokenHolderQuantity": "2"
    },
    {
      "TokenHolderAddress": "0x0412a1d25fbdcabc536603198330021ccb13240b",
      "TokenHolderQuantity": "3385700"
    }
  ]
}