eth_feeHistory - Celo

Example code for the eth_feeHistory JSON-RPC method. Complete guide on how to use eth_feeHistory JSON-RPC in GetBlock Web3 documentation.

This method returns historical gas information on the Celo network, enabling accurate fee estimation for EIP-1559 style transactions. Celo maintains extremely low fees, typically under $0.01 per transaction.

Parameters

Parameter	Type	Required	Description
blockCount	string	Yes	Number of blocks to return (hex)
newestBlock	string	Yes	Newest block ("latest" or block number)
rewardPercentiles	array	No	Percentile values for priority fees

Request Example

cURL

curl -X POST https://go.getblock.io/<ACCESS-TOKEN>/ \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "method": "eth_feeHistory",
  "params": ["0x5", "latest", [25, 50, 75]]
}'

JavaScript (Axios)

Python

Response Example

{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "result": {
    "baseFeePerGas": ["0x5d21dba00", "0x5d21dba00", "0x5d21dba00"],
    "gasUsedRatio": [0.021, 0.045, 0.032],
    "oldestBlock": "0x1d9f2a4",
    "reward": [["0x0", "0x0", "0x0"], ["0x0", "0x0", "0x0"]]
  }
}

Reponse Definition

Field	Type	Description
baseFeePerGas	array	Base fee per gas for each block
gasUsedRatio	array	Gas used ratio for each block
oldestBlock	string	Oldest block number returned
reward	array	Priority fee percentiles

Use Cases

• Calculate optimal gas prices

• Implement EIP-1559 fee estimation

• Analyze network congestion

• Build fee prediction models

Error Handling

Error Code	Description
-32602	Invalid params
-32603	Internal error

SDK Integration

Ethers.js

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

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

const feeData = await provider.getFeeData();
console.log('Max Fee:', ethers.formatGwei(feeData.maxFeePerGas));
console.log('Priority Fee:', ethers.formatGwei(feeData.maxPriorityFeePerGas));