LogoLogo
HomeTwitterKnowledge BaseAPI PRO
BaseScan
BaseScan
  • Introduction
  • ✨Getting Started
    • Creating an Account
    • Getting an API key
    • Endpoint URLs
  • 🎯API Endpoints
    • Accounts
    • Contracts
    • Transactions
    • Blocks
    • Logs
    • Geth/Parity Proxy
    • Tokens
    • Stats
  • 🏆API PRO
    • BaseScan API PRO
    • API PRO Endpoints
  • 🤝Support
    • FAQ
    • Rate Limits
    • Common Error Messages
    • Common Verification Errors
    • Getting Help
  • Visit BaseScan.org
Powered by GitBook
On this page
  • Get Block Rewards by BlockNo
  • Get Estimated Block Countdown Time by BlockNo
  • Get Block Number by Timestamp
  • Get Daily Average Block Size
  • Get Daily Block Count and Rewards
  • Get Daily Block Rewards
  • Get Daily Average Time for A Block to be Included in the Base Chain
  1. API Endpoints

Blocks

PreviousTransactionsNextLogs

Last updated 1 year ago

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

Query Parameters

Parameter
Description

blockno

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

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

Query Parameters

Parameter
Description

blockno

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

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

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

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

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

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

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

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

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

the integer block number to check block rewards for eg.

Try this endpoint in your

the integer block number to estimate time remaining to be mined eg.

Try this endpoint in your

Get Daily Average Block Size

Try this endpoint in your

Get Daily Block Count and Rewards

Try this endpoint in your

Get Daily Block Rewards

Try this endpoint in your

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

Try this endpoint in your

🎯
🔗
⏳
browser
Unix timestamp.
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
12697906
12697906