eth_feeHistory

Updated on 2024-11-14 GMT+08:00

View PDF

Introduction

This API returns historical gas information. It consumes 120 CUs.

Parameter Description

Parameter	Type	Description
Number of blocks	String/Integer	Number of blocks in the requested range. 1 to 1024 blocks can be requested in a single query. Less than requested may be returned if not all blocks are available.
Newest block number	String	A hexadecimal block number, or the string (earliest, latest, or pending).
Reward percentiles	Integer	(Optional) A monotonically increasing list of percentile values to sample from each block's effective priority fees per gas in ascending order, weighted by gas used.

Parameter

Type

Description

Number of blocks

String/Integer

Number of blocks in the requested range. 1 to 1024 blocks can be requested in a single query. Less than requested may be returned if not all blocks are available.

Newest block number

String

A hexadecimal block number, or the string (earliest, latest, or pending).

Reward percentiles

Integer

(Optional) A monotonically increasing list of percentile values to sample from each block's effective priority fees per gas in ascending order, weighted by gas used.

Return Value

oldestBlock: the lowest number block of the returned range encoded as hexadecimal.
baseFeePerGas: an array of block base fees per gas, including an extra block value. The extra value is the next block after the newest block in the returned range. Zeroes are returned for blocks created before EIP-1559.
gasUsedRatio: an array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit.
reward: an array of effective priority fees per gas data points from a single block. All zeroes are returned if the block is empty.

Request

curl https://your-http-endpoint/v1/<API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"id": 1, "jsonrpc": "2.0", "method": "eth_feeHistory", "params": ["0x5", "latest", [20,30]] }'

Parent topic: Shared Edition

Previous topic: eth_estimateGas

Next topic: eth_maxPriorityFeePerGas

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot