Skip to main content
GET
https://api.etherscan.io
/
v2
/
api
curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokenbalance&address=0x983e3660c0bE01991785F80f266A84B911ab59b0&page=1&offset=100&apikey=YourApiKeyToken" 
{  "status": "1",  "message": "OK",  "result": [  {  "TokenAddress": "0xffffffff2ba8f66d4e51811c5190992176930278",  "TokenName": "Furucombo",  "TokenSymbol": "COMBO",  "TokenQuantity": "1861606940000000000",  "TokenDivisor": "18",  "TokenPriceUSD": "0.000891470000000000"  },  {  "TokenAddress": "0x53a1e9912323b8016424d6287286e3b6de263f76",  "TokenName": "PUTIN Token",  "TokenSymbol": "PTT",  "TokenQuantity": "3500000000000000000000",  "TokenDivisor": "18",  "TokenPriceUSD": "0.000000000000000000"  }  ] } 
This is a PRO endpoint, available to the Standard Plan and above
This historical endpoint is throttled to 2 calls/s

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:"account"
Set to account for this endpoint.
action
string
default:"addresstokenbalance"
Set to addresstokenbalance for this endpoint.
address
string
default:"0x983e3660c0bE01991785F80f266A84B911ab59b0"
Address to check for token holdings.
page
integer
default:"1"
Page number for pagination.
offset
integer
default:"100"
Number of records per page.
curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokenbalance&address=0x983e3660c0bE01991785F80f266A84B911ab59b0&page=1&offset=100&apikey=YourApiKeyToken" 
{  "status": "1",  "message": "OK",  "result": [  {  "TokenAddress": "0xffffffff2ba8f66d4e51811c5190992176930278",  "TokenName": "Furucombo",  "TokenSymbol": "COMBO",  "TokenQuantity": "1861606940000000000",  "TokenDivisor": "18",  "TokenPriceUSD": "0.000891470000000000"  },  {  "TokenAddress": "0x53a1e9912323b8016424d6287286e3b6de263f76",  "TokenName": "PUTIN Token",  "TokenSymbol": "PTT",  "TokenQuantity": "3500000000000000000000",  "TokenDivisor": "18",  "TokenPriceUSD": "0.000000000000000000"  }  ] }