eth_feeHistoryHTTP

Returns historical base fees and optional priority-fee percentiles for EIP-1559 gas estimation.

Chain EthereumTransport HTTPTry-it live

How to use

Pick an API key (or paste one) in the Try it panel.
Fill each parameter (order = params array index).
Send request — live against the gateway; counts toward daily quota.

Parameters

JSON-RPC positional arguments — order matches the array sent in params. Index badges below match array positions.

blockCountQUANTITYrequired

Requested number of blocks as a hex quantity. The upstream may return a shorter available range; use oldestBlock and the returned array lengths.

newestBlockQUANTITY|TAGrequired

Highest block of the range — usually "latest", or a hex block number.

params array (shape)

eth_feeHistory · paramsjson

1[
2  "0x2",
3  "latest",
4  [
5    25,
6    75
7  ]
8]

Try it

Live request via the gateway — counts toward your account's daily quota. Chain: ethereum

JSON mode

API key

Try-it runs with one of your own keys — sign in or create a free account first.

Parameters

0blockCountQUANTITYrequired

Requested number of blocks as a hex quantity. The upstream may return a shorter available range; use oldestBlock and the returned array lengths.

1newestBlockQUANTITY|TAGrequired

Highest block of the range — usually "latest", or a hex block number.

2rewardPercentilesArray<number>required

Percentiles from 0 to 100 in ascending order, weighted by gas used in each block. Pass [] when reward sampling is not needed; keep this third positional argument.

Paste a JSON array. Indent freely — we parse it into the params array.

Example request

eth_feeHistory · requestbash

1curl 'https://ethras.org/v1/ethereum/<YOUR_KEY>' \
2  -H 'Content-Type: application/json' \
3  -d '{
4    "id": 1,
5    "jsonrpc": "2.0",
6    "method": "eth_feeHistory",
7    "params": [
8      "0x4",
9      "latest",
10      [
11        25,
12        75
13      ]
14    ]
15  }'

Example response

Illustrative example: long hex values and object fields may be shortened for readability. Available fields depend on the network, client, protocol upgrade and transaction type.

eth_feeHistory · responsejson

1{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "result": {
5    "oldestBlock": "0x186a9f4",
6    "baseFeePerGas": [
7      "0x2540be400",
8      "0x24e160300"
9    ],
10    "gasUsedRatio": [
11      0.48
12    ],
13    "reward": [
14      [
15        "0x5f5e100",
16        "0x3b9aca00"
17      ]
18    ]
19  }
20}

Response fields

The result row describes the complete result; other rows describe its object fields or array elements. Indented rows describe nested members. For subscriptions,params.* rows describe later notifications rather than the initial reply.

Field	Type	Description
`oldestBlock`	`QUANTITY`	First block of the returned range.
`baseFeePerGas`	`QUANTITY[]`	Execution base fees in wei for the returned blocks, plus the derived fee for the following block (N + 1 entries). Zero for blocks before EIP-1559.
`gasUsedRatio`	`NUMBER[]`	Gas used divided by the block gas limit, one entry per returned block (N entries).
`reward`	`QUANTITY[][]`	Gas-weighted priority fees in wei: N rows, one column per requested percentile. May be omitted when percentiles is empty.
`baseFeePerBlobGas`	`QUANTITY[]`	Blob base fees in wei per blob gas, including the following block (N + 1 entries), where exposed by the network and upstream. Zero before EIP-4844.
`blobGasUsedRatio`	`NUMBER[]`	Blob gas used divided by the maximum blob gas per block (N entries), where the network and upstream expose blob-fee history.