Skip to main content

eth_feeHistory RPC Method

Returns the collection of historical gas information.

Updated on
Feb 05, 2025

eth_feeHistory RPC Method

Parameters

blockCount
string
REQUIRED
The number of blocks in hexadecimal format
newestBlock
string
REQUIRED
The highest number block of the requested range in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators
rewardPercentiles
integer
REQUIRED
A list of percentile values with a monotonic increase in value. The transactions will be ranked by effective tip per gas for each block in the requested range, and the corresponding effective tip for the percentile will be calculated while taking gas consumption into consideration

Returns

oldestBlock
string
The lowest number block of the returned range encoded in hexadecimal format
baseFeePerGas
array
An array of block base fees per gas. This includes the next block after the newest of the returned range, because this value can be derived from the newest block. Zeroes are returned for pre-EIP-1559 blocks
gasUsedRatio
array
An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit
reward
array
(Optional) An array of effective priority fees per gas data points from a single block. All zeroes are returned if the block is empty
Request
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free