Skip to main content
GET
Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo
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.

Authorizations

apikey
string
query
required

Your Etherscan API key.

Query Parameters

chainid
string
required

Chain ID to query, eg 1 for Ethereum, 8453 for Base from our supported chains.

module
string
default:stats
required

Set to stats for this endpoint.

action
string
default:tokensupplyhistory
required

Set to tokensupplyhistory for this endpoint.

contractaddress
string
required

Contract address of the ERC-20 token.

blockno
integer
required

Block number to check total supply for.