Tokens

Get BEP-20 Token CirculatingSupply by ContractAddress

Returns the current circulating supply of a BEP-20 token.

https://api.bscscan.com/api
   ?module=stats
   &action=tokenCsupply
   &contractaddress=0xe9e7cea3dedca5984780bafc599bd69add087d56
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the BEP-20 token

Get BEP-20 Token TotalSupply by ContractAddress

Returns the total supply of a BEP-20 token.

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

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the BEP-20 token

Get BEP-20 Token Account Balance by ContractAddress

Returns the current balance of a BEP-20 token of an address.

https://api.bscscan.com/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0xe9e7cea3dedca5984780bafc599bd69add087d56
   &address=0x89e73303049ee32919903c09e8de5629b84f59eb
   &tag=latest
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the BEP-20 token

address

the string representing the address to check for token balance

Returns the historical amount of a BEP-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.bscscan.com/api
   ?module=stats
   &action=tokensupplyhistory
   &contractaddress=0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51
   &blockno=4000000
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the BEP-20 token

blockno

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

Returns the balance of a BEP-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.bscscan.com/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51
   &address=0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a
   &blockno=4000000
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the BEP-20 token

address

the string representing the address to check for balance

blockno

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

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

https://api.bscscan.com/api
   ?module=token
   &action=tokenholderlist
   &contractaddress=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82
   &page=1
   &offset=10
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the BEP-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 a BEP-20/BEP-721 token.

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

https://api.bscscan.com/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

contractaddress

the contract address of the BEP-20/BEP721 token to retrieve token info

Returns the BEP-20 tokens and amount held by an address.

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

https://api.bscscan.com/api
   ?module=account
   &action=addresstokenbalance
   &address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
   &page=1
   &offset=100
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

address

the string representing the address to check for balance

page

the integer page number, if pagination is enabled

offset

the number of transactions displayed per page

Returns the BEP-721 tokens and amount held by an address.

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

https://api.bscscan.com/api
   ?module=account
   &action=addresstokennftbalance
   &address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
   &page=1
   &offset=100
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

address

the string representing the address to check for balance

page

the integer page number, if pagination is enabled

offset

the number of transactions displayed per page

Returns the BEP-721 token inventory of an address, filtered by contract address.

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

https://api.bscscan.com/api
   ?module=account
   &action=addresstokennftinventory
   &address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
   &contractaddress=0x5e74094cd416f55179dbd0e45b1a8ed030e396a1
   &page=1
   &offset=100
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Query Parameters

ParameterDescription

address

the string representing the address to check for inventory

contractaddress

the string representing the BEP-721 token contractaddress to check for inventory

page

the integer page number, if pagination is enabled

offset

the number of records displayed per page limited to 1000 records per query, use the page parameter for subsequent records

Last updated