> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validationcloud.io/llms.txt
> Use this file to discover all available pages before exploring further.

# eth_feeHistory

Returns transaction base fee per gas and effective priority fee per gas for the requested/supported block range.

This method will use `20` [Compute Units](/nodeapi/about/billing).

***

## **Parameters**

1. `blockCount`, String/Integer - The number of blocks in the requested range. Between 1 and 1024 blocks can be requested in a single query. It will return less than the requested range if not all blocks are available.
2. `newestBlock` - String - hexadecimal block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block-parameter).
3. `rewardPercentiles` - Array of integers - A list of percentile values (0 to 100) that go up in order, showing how much people are willing to pay to have their transactions processed quickly. These values are based on:

   1. Looking at each block in the time period you're interested in
   2. Ranking the transactions by how much extra tip they offered per unit of gas
   3. Calculating the typical tip amount for different levels (percentiles)
   4. Taking into account how much gas each transaction used

   This helps you understand what people are typically paying to get their transactions processed at different speed levels.

## Returns

`Object` - `oldestBlock` (the first block of the range), `baseFeePerGas` (one entry per block plus one for the next block), `gasUsedRatio` (one per block), and `reward` (one array per block holding the effective priority fee at each requested percentile).

```json theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
// Result
{
	"jsonrpc": "2.0",
	"result": {
		"baseFeePerGas": [
			"0xba43b7400",
			"0xba43b7400",
			"0xba43b7400",
			"0xba43b7400",
			"0xba43b7400"
		],
		"gasUsedRatio": [
			0.09815686,
			0.09815686,
			0.09815686,
			0.09815686
		],
		"baseFeePerBlobGas": [
			"0xba43b7400",
			"0xba43b7400",
			"0xba43b7400",
			"0xba43b7400",
			"0xba43b7400"
		],
		"blobGasUsedRatio": [
			0.0,
			0.0,
			0.0,
			0.0
		],
		"oldestBlock": "0x196b242",
		"reward": [
			[
				"0x0",
				"0x0"
			],
			[
				"0x0",
				"0x0"
			],
			[
				"0x0",
				"0x0"
			],
			[
				"0x0",
				"0x0"
			]
		]
	},
	"id": 1
}
```

<CodeGroup>
  ```bash title="mainnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
  curl https://mainnet.hyperliquid.validationcloud.io/v1/<YOUR_API_KEY_HERE>/evm \
      -X POST \
      -H "Content-Type: application/json" \
      -d '{"jsonrpc":"2.0","method":"eth_feeHistory","params":[4, "latest", [25, 75]],"id":1}'
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.