API PRO Endpoints
The following is a complete list of additional API endpoints available under the API PRO subscription.
To upgrade your API plan, kindly visit BscScan APIs.
Returns the historical BNB balance of an address at a certain block height.
https://api.bscscan.com/api?module=account&action=balancehistory&address=0x0DB011018728D1B91dDB3C77933a40B9B68C9fa7&blockno=2000000&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
address | the |
blockno | the |
Sample Response
{"status":"1","message":"OK-Missing/Invalid API Key, rate limit of 1/5sec applied","result":[{"account":"0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1","balance":"37700000000000001"},{"account":"0x4bF01a5A576bE1254C5E19fbE5EB195D6cFBeBdD","balance":"4999777740000000000"},{"account":"0x70F657164e5b75689b64B7fd1fA275F334f28e18","balance":"57443177693229716"}]}
📖 Tip: The result is returned in wei.
Convert BNB units using our Unit Converter.
Returns the daily average block size within a date range.
https://api.bscscan.com/api?module=stats&action=dailyavgblocksize&startdate=2021-08-01&enddate=2021-08-31&sort=asc&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
startdate | the starting date in |
enddate | the ending date in |
sort | the sorting preference, use |
Sample Response
{"status":"1","message":"OK","result":[{"UTCDate":"2021-08-01","unixTimeStamp":"1627776000","blockSize_bytes":96364},{"UTCDate":"2021-08-02","unixTimeStamp":"1627862400","blockSize_bytes":94832},{"UTCDate":"2021-08-31","unixTimeStamp":"1630368000","blockSize_bytes":90159}]}
Returns the number of blocks validated daily and the amount of block rewards.
https://api.bscscan.com/api?module=stats&action=dailyblkcount&startdate=2021-08-01&enddate=2021-08-31&sort=asc&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
startdate | the starting date in |
enddate | the ending date in |
sort | the sorting preference, use |
Sample Response
{"status":"1","message":"OK","result":[{"UTCDate":"2021-08-01","unixTimeStamp":"1627776000","blockCount":27783,"blockRewards_Eth":"9216.309553593894910979"},{"UTCDate":"2021-08-02","unixTimeStamp":"1627862400","blockCount":27941,"blockRewards_Eth":"8474.944904178535758101"},{"UTCDate":"2021-08-31","unixTimeStamp":"1630368000","blockCount":28357,"blockRewards_Eth":"7213.736543000372715456"}]}
Returns the amount of block rewards distributed to validators daily.
https://api.bscscan.com/api?module=stats&action=dailyblockrewards&startdate=2021-08-01&enddate=2021-08-31&sort=asc&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
startdate | the starting date in |
enddate | the ending date in |
sort | the sorting preference, use |
Sample Response
{"status":"1","message":"OK","result":[{"UTCDate":"2021-08-01","unixTimeStamp":"1627776000","blockRewards_Eth":"0"},{"UTCDate":"2021-08-02","unixTimeStamp":"1627862400","blockRewards_Eth":"0"},{"UTCDate":"2021-08-31","unixTimeStamp":"1630368000","blockRewards_Eth":"0"}]}
Returns the daily average of time needed for a block to be successfully validated.
https://api.bscscan.com/api?module=stats&action=dailyavgblocktime&startdate=2021-08-01&enddate=2021-08-31&sort=asc&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
startdate | the starting date in |
enddate | the ending date in |
sort | the sorting preference, use |
Sample Response
{"status":"1","message":"OK","result":[{"UTCDate":"2021-08-01","unixTimeStamp":"1627776000","blockTime_sec":"3.11"},{"UTCDate":"2021-08-02","unixTimeStamp":"1627862400","blockTime_sec":"3.09"},{"UTCDate":"2021-08-31","unixTimeStamp":"1630368000","blockTime_sec":"3.05"}]}
Returns project information and social media links of a BEP-20 token.
https://api.bscscan.com/api?module=token&action=tokeninfo&contractaddress=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
contractaddress | the |
Sample Response
{"status":"1","message":"OK","result":[{"contractAddress":"0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82","tokenName":"PancakeSwap Token","symbol":"Cake","divisor":"18","tokenType":"ERC20","totalSupply":"431889535.843059000000000000","blueCheckmark":"true","description":"PancakeSwap is a yield farming project whereby users can get FLIP (LP token) for staking and get CAKE token as reward. CAKE holders can swap CAKE for SYRUP for additional incentivized staking.","website":"https://pancakeswap.finance/","email":"[email protected]","blog":"https://medium.com/@pancakeswap","reddit":"","slack":"","facebook":"","twitter":"https://twitter.com/pancakeswap","bitcointalk":"","github":"https://github.com/pancakeswap","telegram":"https://t.me/PancakeSwap","wechat":"","linkedin":"","discord":"","whitepaper":"","tokenPriceUSD":"23.9300000000"}]}
Returns the BEP-20 tokens and amount held by an address.
https://api.bscscan.com/api?module=account&action=addresstokenbalance&address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf&page=1&offset=100&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
address | the |
page | the |
offset | the number of transactions displayed per page |
Sample Response
{"status":"1","message":"OK","result":[{"TokenAddress":"0xfcb5DF42e06A39E233dc707bb3a80311eFD11576","TokenName":"www.METH.co.in","TokenSymbol":"METH","TokenQuantity":"1337000","TokenDivisor":"18"},{"TokenAddress":"0xdf1f0026374d4bcc490be5e316963cf6df2fff19","TokenName":"InnovativeBioresearchCoin","TokenSymbol":"INNBC","TokenQuantity":"2000000000","TokenDivisor":"6"},{"TokenAddress":"0x78e1936f065fd4082387622878c7d11c9f05ecf4","TokenName":"JNTR/b","TokenSymbol":"JNTR/b","TokenQuantity":"163000000000000000000","TokenDivisor":"18"},{"TokenAddress":"0x12e34cdf6a031a10fe241864c32fb03a4fdad739","TokenName":"FREE coin BSC","TokenSymbol":"FREE","TokenQuantity":"21144000000000000000000","TokenDivisor":"18"},{"TokenAddress":"0xef5ceb00ae3eb617773016b4ca886b61fa4e027e","TokenName":"BURNING","TokenSymbol":"BURN","TokenQuantity":"50000000000000000","TokenDivisor":"18"}]}
Returns the BEP-721 tokens and amount held by an address.
https://api.bscscan.com/api?module=account&action=addresstokennftbalance&address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf&page=1&offset=100&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
address | the |
page | the |
offset | the number of transactions displayed per page |
Sample Response
{"status":"1","message":"OK","result":[{"TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1","TokenName":"Pancake Lottery Ticket","TokenSymbol":"PLT","TokenQuantity":"18"},{"TokenAddress":"0xdf7952b35f24acf7fc0487d01c8d5690a60dba07","TokenName":"Pancake Bunnies","TokenSymbol":"PB","TokenQuantity":"1"}]}
Returns the BEP-721 token inventory of an address, filtered by contract address.
https://api.bscscan.com/api?module=account&action=addresstokennftinventory&address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf&contractaddress=0x5e74094cd416f55179dbd0e45b1a8ed030e396a1&page=1&offset=100&apikey=YourApiKeyToken
Query Parameters
Parameter | Description |
address | the |
contractaddress | the |
page | the |
offset | the number of transactions displayed per page |
Sample Response
{"status":"1","message":"OK","result":[{"TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1","TokenId":"5077"},{"TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1","TokenId":"7543"},{"TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1","TokenId":"7544"},{"TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1","TokenId":"7545"},{"TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1","TokenId":"121878"},{"TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1","TokenId":"121879"}]}
