Skip to main content
GET
Get ERC20-Token TotalSupply by ContractAddress

Authorizations

apikey
string
query
required

Enter your Etherscan API key, or set one up if you don't have one.

Query Parameters

chainid
string
required

Chain ID to query, eg 1 for Ethereum, 42161 for Arbitrum from our supported chains.

module
string
default:stats
required

Set to stats for this endpoint.

action
string
default:tokensupply
required

Set to tokensupply for this endpoint.

contractaddress
string
required

Contract address of the ERC-20 token.

Response

200 - application/json

Successful response

status
string

1 if the request returned data, 0 otherwise. A status of 0 can indicate an error or a valid request that returned no records.

message
string

OK on success, otherwise an error description such as NOTOK. See common error messages.

result
string

Total supply of the token, in the token's smallest unit.