Returns historical base fees and priority fee percentiles for a range of blocks.
Returns historical gas information for a range of blocks, including base fees and the distribution of priority fees. Useful for building fee estimation strategies.
Parameters
string | number
required
Number of blocks to return. Can be a decimal or hexadecimal integer. Maximum is typically 1024.
string
required
The highest block to include, as a block number in hex or a block tag ("latest", "pending", etc.).
array
required
Array of percentile values (0–100) to sample from each block’s priority fees. Example: [25, 50, 75] returns the 25th, 50th, and 75th percentile priority fees.
Returns
object
Show Fee History Fields
string
The oldest block number in the result set (hex).
array
Array of base fees per gas for each block, plus one extra entry for the next pending block. Length = blockCount + 1.
array
Array of gas used / gas limit ratios for each block (0.0 to 1.0). Length = blockCount.
array
Array of base fees per blob gas for each block, plus one extra for the next pending block (EIP-4844). Always "0x1" on Base currently. Length = blockCount + 1.
array
Array of blob gas used ratios for each block (0.0 to 1.0). Used to adjust the blob base fee (EIP-4844). Length = blockCount.
array
2D array of priority fee percentiles per block, matching the requested percentile values.