Get Historical ERC20-Token Account Balance by BlockNo

GET

api

curl --request GET \
  --url https://api.etherscan.io/v2/api

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

This is a PRO endpoint, available to the Standard Plan and above

This endpoint is throttled to 2 calls/second regardless of API Pro tier.

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.

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

⌘I