eth_feeHistory | Conduit Documentation

curl -X POST https://rpc.plume.org/YOUR_API_KEY \
     -H "Content-Type: application/json" \
     -d '{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x5",
    "latest",
    [
      25,
      50,
      75
    ]
  ],
  "id": 1
}'

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "baseFeePerGas": [
      "0xe8d4a51000",
      "0xe8d4a51000",
      "0xe8d4a51000",
      "0xe8d4a51000",
      "0xe8d4a51000",
      "0xe8d4a51000"
    ],
    "gasUsedRatio": [
      0.000035268333333333336,
      0.000035268333333333336,
      0.00007705833333333333,
      0.00015409666666666666,
      0.00022733583333333333
    ],
    "oldestBlock": "0x28401ce",
    "reward": [
      [
        "0x0",
        "0x0",
        "0x0"
      ],
      [
        "0x0",
        "0x0",
        "0x0"
      ],
      [
        "0x0",
        "0x0",
        "0x0"
      ],
      [
        "0x0",
        "0x0",
        "0x0"
      ],
      [
        "0x0",
        "0x0",
        "0x0"
      ]
    ]
  }
}

Returns the base fee per gas, gas used ratio, blob base fee per gas (EIP-4844), blob gas used ratio (EIP-4844), and optionally per-block reward percentiles for the requested block range. Used to estimate appropriate gas prices and tip values.

The response arrays are sized relative to blockCount:

baseFeePerGas and blobBaseFeePerGas have length blockCount + 1 (one extra entry for the next block).
gasUsedRatio and blobGasUsedRatio have length blockCount.
reward (when rewardPercentiles is provided) has length blockCount; each entry is an array with one value per requested percentile.

⚡ Compute Units: 10 CU

Request

This endpoint expects an object.

blockCountstringRequiredformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Number of blocks in the requested range (1-1024). Hex-encoded.

newestBlockenum or stringRequired

Highest block of the requested range, or one of "latest", "earliest", "pending", "finalized", "safe"

rewardPercentileslist of doublesOptional

Optional. Array of monotonically increasing percentile values [0, 100]. When provided, the response includes reward with the effective priority fee at each percentile for each block.

Response

Fee history object

oldestBlockstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Lowest block number of the returned range.

baseFeePerGaslist of strings

Base fee per gas for each block, plus the next block's base fee. Length = blockCount + 1.

gasUsedRatiolist of doubles

Ratio of gas used to gas limit for each block. Length = blockCount.

blobBaseFeePerGaslist of stringsOptional

EIP-4844 blob base fee per gas for each block, plus the next block's. Length = blockCount + 1. Returned by post-Dencun nodes.

blobGasUsedRatiolist of doublesOptional

EIP-4844 ratio of blob gas used to the per-block target for each block. Length = blockCount. Returned by post-Dencun nodes.

rewardlist of lists of stringsOptional

Effective priority fee (tip) per gas at each requested percentile, per block. Only present when rewardPercentiles is supplied. Outer length = blockCount, inner length = rewardPercentiles.length.