eth_feeHistory

Returns historical gas information on MegaETH for fee estimation.

Use Cases

• Fee prediction - Estimate future gas prices based on history
• Gas analytics - Analyze fee trends over time
• Optimal timing - Find best times for transactions on high-frequency trading, real-time gaming, instant payments, and latency-sensitive applications

Block Range Limit

Block Range Limit

On MegaETH, eth_feeHistory queries are subject to a maximum block range of 10,000 blocks. This means the blockCount parameter cannot exceed 10,000 blocks per request.

For querying larger block ranges, split your requests into batches:

// Example: Query in 10,000-block batches
const MAX_RANGE = 10000;
const totalBlocks = 50000;
const newestBlock = await provider.getBlockNumber();

const allFeeHistory = [];

for (let i = 0; i < totalBlocks; i += MAX_RANGE) {
  const blockCount = Math.min(MAX_RANGE, totalBlocks - i);
  const feeHistory = await provider.send('eth_feeHistory', [
    blockCount,
    newestBlock - i,
    []
  ]);
  allFeeHistory.push(feeHistory);
}

Parameters

Parameter	Type	Required	Description
blockCount	QUANTITY	Yes	Number of blocks in the range
newestBlock	QUANTITY|TAG	Yes	Highest block of the range
rewardPercentiles	Array	Yes	Percentiles to sample for priority fees

Request

{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": ["0x5", "latest", [25, 50, 75]],
  "id": 1
}

Code Examples

cURL

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

JavaScript

import { JsonRpcProvider, formatUnits } from 'ethers';

const provider = new JsonRpcProvider('https://api-megaeth-mainnet.n.dwellir.com/YOUR_API_KEY');

const feeHistory = await provider.send('eth_feeHistory', ['0xa', 'latest', [25, 50, 75]]);

console.log('Base fees:', feeHistory.baseFeePerGas.map(f => formatUnits(f, 'gwei')));
console.log('Reward (25th percentile):', feeHistory.reward.map(r => formatUnits(r[0], 'gwei')));

Python

from web3 import Web3

w3 = Web3(Web3.HTTPProvider('https://api-megaeth-mainnet.n.dwellir.com/YOUR_API_KEY'))

fee_history = w3.eth.fee_history(10, 'latest', [25, 50, 75])
print(f'Base fees: {[w3.from_wei(f, "gwei") for f in fee_history["baseFeePerGas"]]}')

Related Methods

• eth_gasPrice - Get current gas price
• eth_maxPriorityFeePerGas - Get priority fee