Blocks

Get Block And Uncle Rewards by BlockNo

Returns the block reward and 'Uncle' block rewards.

https://api.arbiscan.io/api
   ?module=block
   &action=getblockreward
   &blockno=131049
   &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":"131049",
      "timeStamp":"1626658757",
      "blockMiner":"0x0000000000000000000000000000000000000000",
      "blockReward":"391758400000000",
      "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.arbiscan.io/api
   ?module=block
   &action=getblockcountdown
   &blockno=22157153
   &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":"22157190",
      "CountdownBlock":"24157153",
      "RemainingBlock":"1999963",
      "EstimateTimeInSec":"600003.9"
   }
}

Get Block Number by Timestamp

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

https://api.arbiscan.io/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1661517573
   &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":"21403544"
}

Get Daily Average Block Size

Returns the daily average block size within a date range.

https://api.arbiscan.io/api
   ?module=stats
   &action=dailyavgblocksize
   &startdate=2021-08-01
   &enddate=2021-08-31
   &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":"2021-08-01",
         "unixTimeStamp":"1627776000",
         "blockSize_bytes":65856
      },
      {
         "UTCDate":"2021-08-02",
         "unixTimeStamp":"1627862400",
         "blockSize_bytes":62925
      },
      {
         "UTCDate":"2021-08-03",
         "unixTimeStamp":"1627948800",
         "blockSize_bytes":63967
      },
      {
         "UTCDate":"2021-08-04",
         "unixTimeStamp":"1628035200",
         "blockSize_bytes":59825
      }
   ]
}

Get Daily Block Count and Rewards

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

https://api.arbiscan.io/api
   ?module=stats
   &action=dailyblkcount
   &startdate=2021-08-01
   &enddate=2021-08-31
   &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":"2021-08-01",
          "unixTimeStamp":"1627776000",
          "blockCount":38385,
          "blockRewards_Eth":"13512.99629741489684839"
       },
       {
          "UTCDate":"2021-08-02",
          "unixTimeStamp":"1627862400",
          "blockCount":36898,
          "blockRewards_Eth":"10415.4627450065115572"
       },
       {
          "UTCDate":"2021-08-03",
          "unixTimeStamp":"1627948800",
          "blockCount":39485,
          "blockRewards_Eth":"21340.315061898381392963"
       },
       {
          "UTCDate":"2021-08-04",
          "unixTimeStamp":"1628035200",
          "blockCount":37536,
          "blockRewards_Eth":"12519.334060666034768668"
       }
    ]
 }

Get Daily Block Rewards

Returns the amount of block rewards distributed to validators daily.

https://api.arbiscan.io/api
   ?module=stats
   &action=dailyblockrewards
   &startdate=2021-08-01
   &enddate=2021-08-31
   &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":"2021-08-01",
          "unixTimeStamp":"1627776000",
          "blockRewards_Eth":"0"
       },
       {
          "UTCDate":"2021-08-02",
          "unixTimeStamp":"1627862400",
          "blockRewards_Eth":"0"
       },
       {
          "UTCDate":"2021-08-03",
          "unixTimeStamp":"1627948800",
          "blockRewards_Eth":"0"
       }
    ]
 }

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

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

https://api.arbiscan.io/api
   ?module=stats
   &action=dailyavgblocktime
   &startdate=2021-08-01
   &enddate=2021-08-31
   &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":"2021-08-01",
          "unixTimeStamp":"1627776000",
          "blockTime_sec":"2.26"
       },
       {
          "UTCDate":"2021-08-02",
          "unixTimeStamp":"1627862400",
          "blockTime_sec":"2.36"
       },
       {
          "UTCDate":"2021-08-03",
          "unixTimeStamp":"1627948800",
          "blockTime_sec":"2.19"
       }
    ]
 }