Comment on page
API PRO Endpoints
The following is a complete list of additional API endpoints available under the API PRO subscription.
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
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 |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1",
"balance":"37700000000000001"
},
{
"account":"0x4bF01a5A576bE1254C5E19fbE5EB195D6cFBeBdD",
"balance":"4999777740000000000"
},
{
"account":"0x70F657164e5b75689b64B7fd1fA275F334f28e18",
"balance":"57443177693229716"
}
]
}
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
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 |
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
Request
Response
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 |
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
Request
Response
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 |
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
Request
Response
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 |
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"
}
]
}
Return the current token holders and number of tokens held.
https://api.bscscan.com/api
?module=token
&action=tokenholderlist
&contractaddress=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82
&page=1
&offset=10
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
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 |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"TokenHolderAddress":"0x0000000000000000000000000000000000000000",
"TokenHolderQuantity":"0"
},
{
"TokenHolderAddress":"0x0000000000000000000000000000000000000001",
"TokenHolderQuantity":"1136630046187908600061"
},
{
"TokenHolderAddress":"0x0000000000000000000000000000000000001004",
"TokenHolderQuantity":"385642396146098637680574"
},
{
"TokenHolderAddress":"0x00000000100f9d75535cbf23f82e23db5558e8c1",
"TokenHolderQuantity":"25536632618506"
}
]
}
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
Request
Response
Query Parameters
Parameter | Description |
|---|---|
contractaddress | the contract address of the BEP-20 token |
blockno | the integer block number to check total supply for eg. 4000000 |
Sample Response
{
"status":"1",
"message":"OK",
"result":"21265524714464"
}
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 215241526476136819398Returns 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
Request
Response
Query Parameters
Parameter | Description |
|---|---|
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 |
Sample Response
{
"status":"1",
"message":"OK",
"result":"135499"
}
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 215241526476136819398Returns 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
Query Parameters
Parameter | Description |
|---|---|
contractaddress | the contract address of the BEP-20 token to retrieve token info |
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 historical daily average gas limit of the BNB Smart Chain network.
https://api.bscscan.com/api
?module=stats
&action=dailyavggaslimit
&startdate=2021-08-01
&enddate=2021-08-28
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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-28 |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"gasLimit":"77995057"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"gasLimit":"77477220"
},
{
"UTCDate":"2021-08-03",
"unixTimeStamp":"1627948800",
"gasLimit":"77163193"
}
]
}
Returns the total amount of gas used daily for transctions on the BNB Smart Chainnetwork.
https://api.bscscan.com/api
?module=stats
&action=dailygasused
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2021-01-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2021-02-28 |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-02-01",
"unixTimeStamp":"1612137600",
"gasUsed":"70672744503"
},
{
"UTCDate":"2021-02-02",
"unixTimeStamp":"1612224000",
"gasUsed":"73905877156"
},
{
"UTCDate":"2021-02-03",
"unixTimeStamp":"1612310400",
"gasUsed":"75696419315"
}
]
}
Returns the daily average gas price used on the BNB Smart Chain network.
https://api.bscscan.com/api
?module=stats
&action=dailyavggasprice
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Request
Query Parameters
Parameter | Description |
|---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2021-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2021-02-28 |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Returns the historical price of 1 BNB.
https://api.bscscan.com/api
?module=stats
&action=bnbdailyprice
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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-28 |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"value":"332.79"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"value":"330.72"
},
{
"UTCDate":"2021-08-30",
"unixTimeStamp":"1630281600",
"value":"460.05"
}
]
}
Tip : The
💰
value is represented in US Dollars ( USD ).Returns the historical amount of transaction fees paid to validators per day.
https://api.bscscan.com/api?
module=stats
&action=dailytxnfee
&startdate=2020-10-01
&enddate=2020-10-31
&apikey=YourApiKeyToken
&sort=asc
Request
Response
Query Parameters
Parameter | Description |
|---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2020-10-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2020-10-31 |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2020-10-01",
"unixTimeStamp":"1601510400",
"transactionFee_Eth":"356.764105308852361"
},
{
"UTCDate":"2020-10-02",
"unixTimeStamp":"1601596800",
"transactionFee_Eth":"270.806833010901929108"
},
{
"UTCDate":"2020-10-31",
"unixTimeStamp":"1604102400",
"transactionFee_Eth":"352.100068789871253431"
}
]
}
Returns the historical number of new BNB Smart Chain addresses created per day.
https://api.bscscan.com/api
?module=stats
&action=dailynewaddress
&startdate=2020-10-01
&enddate=2020-10-31
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2020-10-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2020-10-31 |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2020-10-01",
"unixTimeStamp":"1601510400",
"newAddressCount":3544
},
{
"UTCDate":"2020-10-02",
"unixTimeStamp":"1601596800",
"newAddressCount":6524
},
{
"UTCDate":"2020-10-31",
"unixTimeStamp":"1604102400",
"newAddressCount":8284
}
]
}
Returns the daily average gas used over gas limit percentage.
https://api.bscscan.com/api
?module=stats
&action=dailynetutilization
&startdate=2021-07-01
&enddate=2021-07-31
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2021-07-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2021-07-28 |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"networkUtilization":"0.7528"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"networkUtilization":"0.7051"
},
{
"UTCDate":"2021-08-30",
"unixTimeStamp":"1630281600",
"networkUtilization":"0.4893"
}
]
}
Returns the number of transactions performed on the BNB Smart Chain per day.
https://api.bscscan.com/api
?module=stats
&action=dailytx
&startdate=2021-07-01
&enddate=2021-07-31
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2021-07-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2021-07-28 |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"transactionCount":498856
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"transactionCount":541458
}
]
}
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
Request
Response
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 |
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.
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
Request
Response
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 |
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.
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
Request
Response
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 |
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"
}
]
}