Skip to main content
GET
https://api.etherscan.io
/
v2
/
api
curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=tokenbalancehistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&blockno=8000000&apikey=YourApiKeyToken"

{
  "status": "1",
  "message": "OK",
  "result": "135499"
}
This is a PRO endpoint, available to any paid tier
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:"tokenbalancehistory"
Set to tokenbalancehistory for this endpoint.
​
contractaddress
string
default:"0x57d90b64a1a57749b0f932f1a3395792e12e7055"
Contract address of the ERC-20 token.
​
address
string
default:"0xe04f27eb70e025b78871a2ad7eabe85e61212761"
Address to check for balance.
​
blockno
integer
default:"8000000"
Block number to check balance for.
curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=tokenbalancehistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&blockno=8000000&apikey=YourApiKeyToken"

{
  "status": "1",
  "message": "OK",
  "result": "135499"
}