Skip to main content
GET
/
v2
/
api
Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo
curl --request GET \
  --url https://api.etherscan.io/v2/api
{
  "status": "1",
  "message": "OK",
  "result": "21265524714464"
}

Documentation Index

Fetch the complete documentation index at: https://docs.etherscan.io/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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:"stats"
Set to stats for this endpoint.
​
action
string
default:"tokensupplyhistory"
Set to tokensupplyhistory for this endpoint.
​
contractaddress
string
default:"0x57d90b64a1a57749b0f932f1a3395792e12e7055"
Contract address of the ERC-20 token.
​
blockno
integer
default:"8000000"
Block number to check total supply for.
{
  "status": "1",
  "message": "OK",
  "result": "21265524714464"
}