Blocks
Endpoints with 
are under the API Pro subscription. To upgrade your API plan, browse through the BscScan APIs page.
Returns the block reward awarded for validating a certain block.
https://api.bscscan.com/api
?module=block
&action=getblockreward
&blockno=2170000
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
blockno |
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"blockNumber":"2170000",
"timeStamp":"1605182836",
"blockMiner":"0x68bf0b8b6fb4e317a0f9d6f03eaf8ce6675bc60d",
"blockReward":"13657915000000000",
"uncles":[
],
"uncleInclusionReward":"0"
}
}
Returns the estimated time remaining, in seconds, until a certain block is validated.
https://api.bscscan.com/api
?module=block
&action=getblockcountdown
&blockno=11926850
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
blockno |
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"CurrentBlock":"10526852",
"CountdownBlock":"10926850",
"RemainingBlock":"399998",
"EstimateTimeInSec":"1240008.8"
}
}
Returns the block number that was validated at a certain timestamp.
https://api.bscscan.com/api
?module=block
&action=getblocknobytime
×tamp=1601510400
&closest=before
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
timestamp | the integer representing the Unix timestamp in seconds. |
closest | the closest available block to the provided timestamp, either before or after |
Sample Response
{
"status":"1",
"message":"OK",
"result":"946206"
}
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"
}
]
}
Last modified 2mo ago