Blocks

Get Block Rewards by BlockNo

Returns the block reward.

https://api.lineascan.build/api
   ?module=block
   &action=getblockreward
   &blockno=113405
   &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": "113405",
    "timeStamp": "1691030455",
    "blockMiner": "0x0000000000000000000000000000000000000000",
    "blockReward": "2100746776611956",
    "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.lineascan.build/api
   ?module=block
   &action=getblockcountdown
   &blockno=213406
   &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": "113416",
    "CountdownBlock": "213406",
    "RemainingBlock": "99990",
    "EstimateTimeInSec": "1209894.0"
  }
}

Get Block Number by Timestamp

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

https://api.lineascan.build/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1690982101
   &closest=after
   &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": "109431"
}

Get Daily Average Block Size

Returns the daily average block size within a date range.

https://api.lineascan.build/api
   ?module=stats
   &action=dailyavgblocksize
   &startdate=2024-05-15
   &enddate=2024-06-01
   &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": "2024-05-15",
      "unixTimeStamp": "1715731200",
      "blockSize_bytes": 7120
    },
    {
      "UTCDate": "2024-05-16",
      "unixTimeStamp": "1715817600",
      "blockSize_bytes": 7280
    },
    {
      "UTCDate": "2024-05-17",
      "unixTimeStamp": "1715904000",
      "blockSize_bytes": 7894
    },
    {
      "UTCDate": "2024-05-18",
      "unixTimeStamp": "1715990400",
      "blockSize_bytes": 6781
    },
    {
      "UTCDate": "2024-05-19",
      "unixTimeStamp": "1716076800",
      "blockSize_bytes": 6374
    },

Get Daily Block Count and Rewards

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

https://api.lineascan.build/api
   ?module=stats
   &action=dailyblkcount
   &startdate=2024-05-15
   &enddate=2024-06-01
   &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": "2024-05-15",
      "unixTimeStamp": "1715731200",
      "blockCount": 28799,
      "blockRewards_Eth": "5.05948173591574772"
    },
    {
      "UTCDate": "2024-05-16",
      "unixTimeStamp": "1715817600",
      "blockCount": 28797,
      "blockRewards_Eth": "4.673198581533348096"
    },
    {
      "UTCDate": "2024-05-17",
      "unixTimeStamp": "1715904000",
      "blockCount": 28793,
      "blockRewards_Eth": "5.177073187195568938"
    },
    {
      "UTCDate": "2024-05-18",
      "unixTimeStamp": "1715990400",
      "blockCount": 28791,
      "blockRewards_Eth": "4.19397142412936982"
    },
    {
      "UTCDate": "2024-05-19",
      "unixTimeStamp": "1716076800",
      "blockCount": 28794,
      "blockRewards_Eth": "4.830417484820715669"
    },

Get Daily Block Rewards

Returns the amount of block rewards distributed to validators daily.

https://api.lineascan.build/api
   ?module=stats
   &action=dailyblockrewards
   &startdate=2024-05-15
   &enddate=2024-06-01
   &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": "2024-05-15",
      "unixTimeStamp": "1715731200",
      "blockRewards_Eth": "0"
    },
    {
      "UTCDate": "2024-05-16",
      "unixTimeStamp": "1715817600",
      "blockRewards_Eth": "0"
    },
    {
      "UTCDate": "2024-05-17",
      "unixTimeStamp": "1715904000",
      "blockRewards_Eth": "0"
    },
    {
      "UTCDate": "2024-05-18",
      "unixTimeStamp": "1715990400",
      "blockRewards_Eth": "0"
    },

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

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

https://api.lineascan.build/api
   ?module=stats
   &action=dailyavgblocktime
   &startdate=2024-05-15
   &enddate=2024-06-01
   &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": "2024-05-15",
      "unixTimeStamp": "1715731200",
      "blockTime_sec": "3.00"
    },
    {
      "UTCDate": "2024-05-16",
      "unixTimeStamp": "1715817600",
      "blockTime_sec": "3.00"
    },
    {
      "UTCDate": "2024-05-17",
      "unixTimeStamp": "1715904000",
      "blockTime_sec": "3.00"
    },
    {
      "UTCDate": "2024-05-18",
      "unixTimeStamp": "1715990400",
      "blockTime_sec": "3.00"
    },