LogoLogo
HomeMetadata APIAPI PROTwitter
Etherscan
Etherscan
  • Introduction
  • ✨Getting Started
    • Creating an Account
    • Getting an API key
    • Endpoint URLs
  • 🎯API Endpoints
    • Accounts
    • Contracts
    • Transactions
    • Blocks
    • Logs
    • Geth/Parity Proxy
    • Tokens
    • Gas Tracker
    • Stats
  • 🏆API PRO
    • Etherscan API PRO
    • API PRO Endpoints
    • Metadata API
  • 🧑‍🍳Recipes
    • Get All USDT Transfers from Binance
    • Get the Latest Moonbird NFT Transfers
    • List ETH deposits to Arbitrum Bridge
  • 📖Tutorials
    • Signing Raw Transactions
    • Read/Write Smart Contracts
    • Integrating Google Sheets
  • ✅Contract Verification
    • What's Contract Verification
    • Multichain Verification
    • Supported Chains
    • Common Verification Errors
    • Contract Verification Plugins
  • 🔧Misc Tools & Utilities
    • Libraries
  • 🤝Support
    • FAQ
    • Rate Limits
    • Common Error Messages
    • Getting Help
  • Visit Etherscan.io
Powered by GitBook
On this page
  • Get Estimation of Confirmation Time
  • Get Gas Oracle
  • Get Daily Average Gas Limit
  • Get Ethereum Daily Total Gas Used
  • Get Daily Average Gas Price
  1. API Endpoints

Gas Tracker

PreviousTokensNextStats

Last updated 2 months ago

Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the 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/api
   ?module=gastracker
   &action=gasestimate
   &gasprice=2000000000
   &apikey=YourApiKeyToken

Try this endpoint in your

Query Parameters

Parameter
Description

gasprice

the price paid per unit of gas, in wei

Tip: Easily convert Ethereum units using our

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

https://api.etherscan.io/api
   ?module=gastracker
   &action=gasoracle
   &apikey=YourApiKeyToken 

No parameters required.

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"
   }
}

Returns the historical daily average gas limit of the Ethereum network.

 https://api.etherscan.io/api
    ?module=stats
    &action=dailyavggaslimit
    &startdate=2019-02-01
    &enddate=2019-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Query Parameters

Parameter
Description

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2019-02-28

sort

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/api
    ?module=stats
    &action=dailygasused
    &startdate=2019-02-01
    &enddate=2019-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Query Parameters

Parameter
Description

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2019-02-28

sort

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/api
    ?module=stats
    &action=dailyavggasprice
    &startdate=2019-02-01
    &enddate=2019-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Query Parameters

Parameter
Description

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2019-02-28

sort

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"
      }
   ]
}

Try this endpoint in your

Note: The gas prices are returned in Gwei.

Get Daily Average Gas Limit

Try this endpoint in your

Get Ethereum Daily Total Gas Used

Try this endpoint in your

Get Daily Average Gas Price

Try this endpoint in your

🎯
⛽
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
📖
📝
🔥
Etherscan APIs
browser
unit converter.
gas changes in EIP-1559.