Blocks

Get Block Rewards by BlockNo

Returns the block reward and 'Uncle' block rewards.

https://api.basescan.org/api
   ?module=block
   &action=getblockreward
   &blockno=1846106
   &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":"1846106",
      "timeStamp":"1690481559",
      "blockMiner":"0x4200000000000000000000000000000000000011",
      "blockReward":"0",
      "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 mined.

https://api.basescan.org/api
   ?module=block
   &action=getblockcountdown
   &blockno=1856106
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

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

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "CurrentBlock":"1846146",
      "CountdownBlock":"1856106",
      "RemainingBlock":"9960",
      "EstimateTimeInSec":"19935.0"
   }
}

Get Block Number by Timestamp

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

https://api.basescan.org/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1690481683
   &closest=before
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Get Daily Average Block Size

Returns the daily average block size within a date range.

https://api.basescan.org/api
   ?module=stats
   &action=dailyavgblocksize
   &startdate=2023-08-01
   &enddate=2023-08-02
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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": "2023-08-01",
      "unixTimeStamp": "1690848000",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2023-08-02",
      "unixTimeStamp": "1690934400",
      "blockSize_bytes": 0
    }
  ]
}

Get Daily Block Count and Rewards

Returns the number of blocks validated daily and the amount of block rewards.

https://api.basescan.org/api
   ?module=stats
   &action=dailyblkcount
   &startdate=2023-08-01
   &enddate=2023-08-02
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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": "2023-08-01",
      "unixTimeStamp": "1690848000",
      "blockSize_bytes": 0
    },
    {
      "UTCDate": "2023-08-02",
      "unixTimeStamp": "1690934400",
      "blockSize_bytes": 0
    }
  ]
}

Get Daily Block Rewards

Returns the amount of block rewards distributed to validators daily.

https://api.basescan.org/api
   ?module=stats
   &action=dailyblockrewards
   &startdate=2023-08-01
   &enddate=2023-08-02
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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": "2023-08-01",
      "unixTimeStamp": "1690848000",
      "blockRewards_Eth": "29.342876545277035327"
    },
    {
      "UTCDate": "2023-08-02",
      "unixTimeStamp": "1690934400",
      "blockRewards_Eth": "26.520254682077361269"
    }
  ]
}

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

Returns the daily average of time needed for a block to be successfully validated.

https://api.basescan.org/api
   ?module=stats
   &action=dailyavgblocktime
   &startdate=2023-08-01
   &enddate=2023-08-02
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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": "2023-08-01",
      "unixTimeStamp": "1690848000",
      "blockTime_sec": "0.00"
    },
    {
      "UTCDate": "2023-08-02",
      "unixTimeStamp": "1690934400",
      "blockTime_sec": "0.00"
    }
  ]
}