eth_feeHistory | Monad

Monad API method that returns historical gas information, allowing you to track trends over time. Monad API method that returns historical gas information.

POST

eth_feeHistory

cURL

curl --request POST \
  --url https://monad-testnet.core.chainstack.com/9c5b265f20b3ea5df4f54f70eb74b800/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x4",
    "latest",
    [
      25,
      75
    ]
  ]
}
'

200

{
  "jsonrpc": "<string>",
  "id": 123,
  "result": {}
}

Monad API method that returns historical gas information, allowing you to track trends over time. This method is essential for building sophisticated gas estimation strategies based on recent network conditions.

Monad-specific behavior: Currently returns default values. This is temporary and will be updated with actual historical data in the future.

Get your 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 in the requested range (1 to 1024).
• newestBlock — the highest block of the requested range as a hexadecimal string or block tag.
• rewardPercentiles — an array of floating point values between 0 and 100 to sample the effective priority fees.

Response

• result — an object containing:
  • oldestBlock — the oldest block in the range
  • baseFeePerGas — array of base fees per gas for each block
  • gasUsedRatio — array of gas used ratios for each block
  • reward — array of arrays containing the requested percentile values of effective priority fees

eth_feeHistory code examples

ethers.js

const { ethers } = require("ethers");

const provider = new ethers.JsonRpcProvider("CHAINSTACK_NODE_URL");

async function getFeeHistory() {
  const feeHistory = await provider.send("eth_feeHistory", ["0x4", "latest", [25, 50, 75]]);
  console.log(`Oldest block: ${parseInt(feeHistory.oldestBlock, 16)}`);
  console.log("Base fees:", feeHistory.baseFeePerGas.map(fee => ethers.formatUnits(fee, "gwei") + " gwei"));
  console.log("Gas used ratios:", feeHistory.gasUsedRatio);
}

getFeeHistory();

Use case

A practical use case for eth_feeHistory is building a gas price oracle that analyzes historical trends to predict optimal gas prices, or creating dashboards that visualize network congestion over time.

Body

application/json

id · integer · default: 1

jsonrpc · string · default: 2.0

method · string · default: eth_feeHistory

params · array

Response

200 - application/json

Fee history for the requested block range.

jsonrpc · string

id · integer

result · object