Tokens

Get ERC20-Token TotalSupply by ContractAddress

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

https://api.basescan.org/api
   ?module=stats
   &action=tokensupply
   &contractaddress=0xa3044b2a9ae8073ecc4e277f6246b3b00fc93553
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the ERC-20 token

Get ERC20-Token Account Balance for TokenContractAddress

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

https://api.basescan.org/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0xa3044b2a9ae8073ecc4e277f6246b3b00fc93553
   &address=0x171f87d13c5819a819702637f2120db793f7bcca
   &tag=latest&apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Returns the historical amount of a ERC-20 token in circulation at a certain block height.

📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

https://api.basescan.org/api
   ?module=stats
   &action=tokensupplyhistory
   &contractaddress=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
   &blockno=10000000
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the ERC-20 token

blockno

the integer block number to check total supply for eg. 4000000

Returns the balance of a ERC-20 token of an address at a certain block height.

📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

https://api.basescan.org/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
   &address=0x1d147c866182f072c821eb1fa9817e87b9547861
   &blockno=11801569
   &apikey=YourApiKeyToken
ParameterDescription

contractaddress

the contract address of the ERC-20 token

blockno

the integer block number to check total supply for eg. 4000000

Address

Target address

Return the current ERC20 token holders and number of tokens held.

https://api.basescan.org/api
    ?module=account
    &action=addresstokenbalance
    &address=0xFd92F4e91d54B9EF91cc3f97C011a6aF0C2a7eDa
    &page=1
    &offset=2
    &apikey=YourApikeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

address

the string representing the address to check for Token Holdings

page

the integer page number, if pagination is enabled

offset

the number of transactions displayed per page

Return the current ERC20 token holders and number of tokens held.

https://api.basescan.org/api
    ?module=account
    &action=addresstokennftbalance
    &address=0x64baeb02876aa58078aa25c1c43b7a5492873559
    &page=1
    &offset=2
    &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

address

the string representing the address to check for Token Holdings

page

the integer page number, if pagination is enabled

offset

the number of transactions displayed per page

https://api.basescan.org/api
    ?module=account
    &action=addresstokennftinventory
    &address=0x64baeb02876aa58078aa25c1c43b7a5492873559
    &contractaddress=0x85e7df5708902be39891d59abef8e21ede91e8bf
    &page=1
    &offset=20
    &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

address

the string representing the address to check for inventory

contractaddress

the contract address of the ERC-721 token

page

the integer page number, if pagination is enabled

offset

the number of transactions displayed per page

Return the current ERC20 token holders and number of tokens held.

https://api.basescan.org/api
   ?module=token
   &action=tokenholderlist
   &contractaddress=0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb&
   &page=1
   &offset=10
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

contractaddress

the contract address of the ERC-20 token

page

the integer page number, if pagination is enabled

offset

the number of transactions displayed per page

Returns project information and social media links of an ERC-20/ERC-721 token.

📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

https://api.basescan.org/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the ERC-20/ERC-721 token to retrieve token info

Last updated