POST
/
efb0a5eccd2caa5135eb54eba6f7f300
curl --request POST \
  --url https://optimism-mainnet.core.chainstack.com/efb0a5eccd2caa5135eb54eba6f7f300 \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "id": 1,
  "params": [
    1024,
    "latest",
    [
      10,
      20,
      30
    ]
  ]
}'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": {
    "oldestBlock": "<string>",
    "baseFeePerGas": [
      "<string>"
    ],
    "gasUsedRatio": [
      123
    ],
    "reward": [
      [
        "<string>"
      ]
    ]
  }
}

Optimism API method eth_feeHistory retrieves historical gas fee data, providing insights into gas price trends and block utilization over time. This method is valuable for estimating transaction fees and understanding network congestion.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • blockCount — the number of blocks to include in the history.
  • newestBlock — the newest block (by number or one of the strings "earliest", "latest", or "pending") to include in the history.
  • rewardPercentiles — an array of percentiles to calculate effective priority fees over the requested blocks.

​
Response

  • result — an object containing:
    • oldestBlock — the oldest block number in the history.
    • baseFeePerGas — an array of base fees per gas for each block.
    • gasUsedRatio — an array of ratios of gas used to gas limit for each block.
    • reward — an array of arrays containing the priority fees at the specified percentiles for each block.

​
Use case

The eth_feeHistory method is essential for:

  • Wallets and interfaces providing users with data-driven gas price suggestions.
  • Applications and services monitoring Optimism network congestion and optimizing transaction fee estimates.
  • Analysts studying Optimism gas fee trends and block space utilization.

Body

application/json

Response

200 - application/json

Historical gas fee data

The response is of type object.