Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the Etherscan APIs page.
Get Estimation of Confirmation Time
Returns the estimated time, in seconds, for a transaction to be confirmed on the blockchain.
https://api.etherscan.io/v2/api
?chainid=1
&module=gastracker
&action=gasestimate
&gasprice=2000000000
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
| Parameter | Description |
|---|
| the price paid per unit of gas, in wei |
Sample Response
{
"status":"1",
"message":"OK",
"result":"9227"
}
📝 Note: The result is returned in seconds.
Get Gas Oracle
Returns the current Safe, Proposed and Fast gas prices.
Post EIP-1559 🔥 changes :
Safe/Proposed/Fast gas price recommendations are now modeled as Priority Fees.
New field suggestBaseFee , the baseFee of the next pending block
New field gasUsedRatio, to estimate how busy the network is
Learn more about the gas changes in EIP-1559.
https://api.etherscan.io/v2/api
?chainid=1
&module=gastracker
&action=gasoracle
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"LastBlock":"13053741",
"SafeGasPrice":"20",
"ProposeGasPrice":"22",
"FastGasPrice":"24",
"suggestBaseFee":"19.230609716",
"gasUsedRatio":"0.370119078777807,0.8954731,0.550911766666667,0.212457033333333,0.552463633333333"
}
}
⛽ Note: The gas prices are returned in Gwei.
Returns the historical daily average gas limit of the Ethereum network.
https://api.etherscan.io/v2/api
?chainid=1
&module=stats
&action=dailyavggaslimit
&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-01-31 |
| 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",
"gasLimit":"8001360"
},
{
"UTCDate":"2019-02-27",
"unixTimeStamp":"1551225600",
"gasLimit":"8001071"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"gasLimit":"8001137"
}
]
}
Returns the total amount of gas used daily for transctions on the Ethereum network.
https://api.etherscan.io/v2/api
?chainid=1
&module=stats
&action=dailygasused
&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-01-31 |
| 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",
"gasUsed":"32761450415"
},
{
"UTCDate":"2019-02-27",
"unixTimeStamp":"1551225600",
"gasUsed":"32657440136"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"gasUsed":"33081119561"
}
]
}
Returns the daily average gas price used on the Ethereum network.
https://api.etherscan.io/v2/api
?chainid=1
&module=stats
&action=dailyavggasprice
&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-01-31 |
| 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",
"maxGasPrice_Wei":"60814303896257",
"minGasPrice_Wei":"432495",
"avgGasPrice_Wei":"13234562600"
},
{
"UTCDate":"2019-02-27",
"unixTimeStamp":"1551225600",
"maxGasPrice_Wei":"42000000000000",
"minGasPrice_Wei":"1000000",
"avgGasPrice_Wei":"16334617513"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"maxGasPrice_Wei":"237222222222257",
"minGasPrice_Wei":"100000000",
"avgGasPrice_Wei":"18834674068"
}
]
}
