Tokens

Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the Scrollscan APIs page.

Get ERC20-Token TotalSupply by ContractAddress

Returns the current amount of an ERC-20 token in circulation.

https://api.scrollscan.com/api
   ?module=stats
   &action=tokensupply
   &contractaddress=0x06efdbff2a14a7c8e15944d1f4a48f9f95f663a4
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token

Response

Sample Response

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

📈 Tip : The result is returned in the token's smallest decimal representation.

Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398

Get ERC20-Token Account Balance for TokenContractAddress

Returns the current balance of an ERC-20 token of an address.

https://api.scrollscan.com/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4
   &address=0x1e4c8489f9d876293c36b730107e89e0f2a0cb04
   &tag=latest&apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
address	the string representing the address to check for token balance

Response

Sample Response

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

📈 Tip : The result is returned in the token's smallest decimal representation.

Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398