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.

Get Historical BNB Balance for a Single Address by BlockNo

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
Request
Response
Request

Query Parameters

Parameter

Description

address

the strings representing the addresses to check for balance, separated by , commas

blockno

the integer block number to check balance for eg. 2000000

Response

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.

Get Daily Average Block Size

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
Request
Response
Request

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2021-08-01

enddate

the ending date in yyyy-MM-dd format, eg. 2021-08-31

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

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
}
]
}

Get Daily Block Count and Rewards

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
Request
Response
Request

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2021-08-01

enddate

the ending date in yyyy-MM-dd format, eg. 2021-08-31

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

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"
}
]
}

Get Daily Block Rewards

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
Request
Response
Request

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2021-08-01

enddate

the ending date in yyyy-MM-dd format, eg. 2021-08-31

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

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"
}
]
}

Get Daily Average Time for A Block to be Included in the Binance Smart Chain

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
Request
Response
Request

Query Parameters

Parameter

Description

startdate

the starting date in yyyy-MM-dd format, eg. 2021-08-01

enddate

the ending date in yyyy-MM-dd format, eg. 2021-08-31

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

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"
}
]
}

Get Token Info by ContractAddress

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
Request
Response
Request

Query Parameters

Parameter

Description

contractaddress

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

Response

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"
}
]
}

Get Address BEP20 Token Holding

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
Request
Response
Request

Query Parameters

Parameter

Description

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

Response

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"
}
]
}

Get Address ERC721 Token Holding

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
Request
Response
Request

Query Parameters

Parameter

Description

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

Response

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"
}
]
}

Get Address ERC721 Token Inventory By Contract Address

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
Request
Response
Request

Query Parameters

Parameter

Description

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 transactions displayed per page

Response

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"
}
]
}