Gnosisscan
HomeTwitterKnowledge Base
  • Introduction
  • ✨Getting Started
    • Creating an Account
    • Getting an API key
    • Endpoint URLs
  • 🎯API Endpoints
    • Accounts
    • Contracts
    • Transactions
    • Blocks
    • Logs
    • Geth Proxy
    • Tokens
    • Stats
  • 📖Tutorials
    • Signing Raw Transactions
    • Read/Write Smart Contracts
    • Verifying Contracts Programmatically
  • 🏆API PRO
    • API PRO
    • Using API PRO
  • 🤝Support
    • FAQ
    • Rate Limits
    • Common Error Messages
    • Getting Help
  • Visit Gnosisscan.io
Powered by GitBook
On this page
  • Get ERC20-Token TotalSupply by ContractAddress
  • Get ERC20-Token Account Balance for TokenContractAddress
  1. API Endpoints

Tokens

PreviousGeth ProxyNextStats

Last updated 2 years ago

Get ERC20-Token TotalSupply by ContractAddress

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

https://api.gnosisscan.io/api
   ?module=stats
   &action=tokensupply
   &contractaddress=0xE2e73A1c69ecF83F464EFCE6A5be353a37cA09b2
   &apikey=YourApiKeyToken

Try this endpoint in your

Query Parameters

Parameter
Description

contractaddress

the contract address of the ERC-20 token

Sample Response

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

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.gnosisscan.io/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0xE2e73A1c69ecF83F464EFCE6A5be353a37cA09b2
   &address=0xe8da64d7ee4252285e7cad911addd79c26c7538f
   &tag=latest&apikey=YourApiKeyToken

Query Parameters

Parameter
Description

contractaddress

the contract address of the ERC-20 token

address

the string representing the address to check for token balance

Sample Response

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

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

Try this endpoint in your

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

🎯
📈
🔗
📈
browser
🔗
browser