Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the Etherscan APIs page.
Get Block And Uncle Rewards by BlockNo
Returns the block reward and 'Uncle' block rewards.
https://api.etherscan.io/api
?module=block
&action=getblockreward
&blockno=2165403
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the integer block number to check block rewards for eg. 12697906 |
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"blockNumber":"2165403",
"timeStamp":"1472533979",
"blockMiner":"0x13a06d3dfe21e0db5c016c03ea7d2509f7f8d1e3",
"blockReward":"5314181600000000000",
"uncles":[
{
"miner":"0xbcdfc35b86bedf72f0cda046a3c16829a2ef41d1",
"unclePosition":"0",
"blockreward":"3750000000000000000"
},
{
"miner":"0x0d0c9855c722ff0c78f21e43aa275a5b8ea60dce",
"unclePosition":"1",
"blockreward":"3750000000000000000"
}
],
"uncleInclusionReward":"312500000000000000"
}
}
Get Estimated Block Countdown Time by BlockNo
Returns the estimated time remaining, in seconds, until a certain block is mined.
https://api.etherscan.io/api
?module=block
&action=getblockcountdown
&blockno=16701588
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the integer block number to estimate time remaining to be mined eg. 12697906 |
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"CurrentBlock":"12715477",
"CountdownBlock":"16701588",
"RemainingBlock":"3986111",
"EstimateTimeInSec":"52616680.2"
}
}
Get Block Number by Timestamp
Returns the block number that was mined at a certain timestamp.
https://api.etherscan.io/api
?module=block
&action=getblocknobytime
×tamp=1578638524
&closest=before
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the integer representing the Unix timestamp in seconds. |
| the closest available block to the provided timestamp, either before or after |
Sample Response
{
"status":"1",
"message":"OK",
"result":"12712551"
}
Returns the daily average block size within a date range.
https://api.etherscan.io/api
?module=stats
&action=dailyavgblocksize
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
| the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"blockSize_bytes":20373
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"blockSize_bytes":25117
}
]
}
Returns the number of blocks mined daily and the amount of block rewards.
https://api.etherscan.io/api
?module=stats
&action=dailyblkcount
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
| the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"blockCount":4848,
"blockRewards_Eth":"14929.464690870590355682"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"blockCount":4366,
"blockRewards_Eth":"12808.485512162356907132"
}
]
}
Returns the amount of block rewards distributed to miners daily.
https://api.etherscan.io/api
?module=stats
&action=dailyblockrewards
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
| the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"blockRewards_Eth":"15300.65625"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"blockRewards_Eth":"12954.84375"
}
]
}
Returns the daily average of time needed for a block to be successfully mined.
https://api.etherscan.io/api
?module=stats
&action=dailyavgblocktime
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
| the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"blockTime_sec":"17.67"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"blockTime_sec":"19.61"
}
]
}
Returns the number of 'Uncle' blocks mined daily and the amount of 'Uncle' block rewards.
https://api.etherscan.io/api
?module=stats
&action=dailyuncleblkcount
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
| the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"uncleBlockCount":287,
"uncleBlockRewards_Eth":"729.75"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"uncleBlockCount":288,
"uncleBlockRewards_Eth":"691.5"
}
]
}