Blocks

Get Block Rewards by BlockNo

Returns the block reward awarded for validating a certain block.

https://api-testnet.bscscan.com/api
   ?module=block
   &action=getblockreward
   &blockno=12380347
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
blockno	the integer block number to check block rewards for eg. 12697906

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "blockNumber":"12380347",
      "timeStamp":"1631687500",
      "blockMiner":"0x35552c16704d214347f29fa77f77da6d75d7c752",
      "blockReward":"1486690000000000",
      "uncles":[
         
      ],
      "uncleInclusionReward":"0"
   }
}

​​ ⌛ Tip : The timestamp field is denoted in Unix timestamp.

Get Estimated Block Countdown Time by BlockNo

Returns the estimated time remaining, in seconds, until a certain block is validated.

https://api-testnet.bscscan.com/api
   ?module=block
   &action=getblockcountdown
   &blockno=15380347
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
blockno	the integer block number to estimate time remaining to be validated eg. 12697906

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "CurrentBlock":"12380387",
      "CountdownBlock":"15380347",
      "RemainingBlock":"2999960",
      "EstimateTimeInSec":"8999895.0"
   }
}

Get Block Number by Timestamp

Returns the block number that was validated at a certain timestamp.

https://api-testnet.bscscan.com/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1601510400
   &closest=before
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

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

⌛ Tip : Convert a regular date-time to a Unix timestamp.

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":"2380234"
}