eth_feeHistory

Get historical gas fee information for a range of blocks

Defined in EIP-1559

Returns a collection of historical gas information from which you can recompute gas costs and estimate future gas prices.

Parameters

blockCount · string · required

Number of blocks in the requested range, as a hexadecimal string.

newestBlock · string · required

Highest block number in the requested range (hexadecimal) or “latest”.

rewardPercentiles · array · required

Array of percentile values to sample from each block’s effective priority fees.

Returns

result · object

Fee history data object containing gas information.

Show Fee history object properties

oldestBlock · string

Lowest block number in the range (hexadecimal).

baseFeePerGas · array

Array of block base fees per gas (hexadecimal strings).

gasUsedRatio · array

Array of block gas utilization ratios (numbers between 0 and 1).

reward · array

Array of effective priority fee per gas data points for each block (optional).

Request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": ["0x5", "latest", [20, 70]]
}

Success Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "oldestBlock": "0x1",
    "baseFeePerGas": [
      "0x3b9aca00",
      "0x3ba1f3e2",
      "0x3a6db1e6"
    ],
    "gasUsedRatio": [
      0.5265,
      0.4858,
      0.6124
    ],
    "reward": [
      [
        "0x3b9aca00",
        "0x3b9aca00"
      ],
      [
        "0x3ba1f3e2",
        "0x3b9aca00"
      ],
      [
        "0x3a6db1e6",
        "0x3b9aca00"
      ]
    ]
  }
}

Error Handling

Code	Message	Description
-32602	Invalid params	Invalid block count, block number, or percentiles
4100	Requested method not supported	The method is not supported by the wallet

This method is useful for implementing dynamic fee estimation algorithms and understanding network congestion patterns.