更新时间:2024-03-06 GMT+08:00

eth_feeHistory

简介

返回历史消耗的Gas信息的集合。该API所消耗的计算单元为17。

参数说明

参数

类型

说明

区块数量

String/Integer

请求范围内的块数。在单个查询中可以请求 1 到 1024 个块。如果不是所有块都可用,它将返回小于请求的范围。

最新区块编号

String

想要查询的区块的十六进制的编号,或者是字符串 "earliest"、"latest"、"pending"。

奖励百分位数

Integer

可选参数,单调递增的百分位值列表,从每个区块的每种 gas 的有效优先费中采样,按升序排列,并按所使用的 gas 进行加权。

返回值

  • oldestBlock:以十六进制数表示的返回范围中最早的区块编号。
  • baseFeePerGas:数组,内容为每个 gas 的一系列区块基本费用,包括额外的区块值。额外的值是返回范围中最新块之后的下一个块。对于EIP-1559之前创建的块返回零。
  • gasUsedRatio:数组,内容为每个区块gas使用比率。计算方式为gasUsed和gasLimit的比率。
  • reward:来自单个区块的每个Gas数据点的有效优先费数组。如果块为空,则返回所有零。

请求样式

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]] }'