[Gas] klay_feeHistory
Returns historical gas information for a range of blocks.
NOTE: This API is effective after Kaia v1.8.0
JSONRPC: klay_feeHistory
Request
- application/json
Body
Array [
- IntegerBlockNumber
- HexadecimalBlockNumber
- BlockTag
]
params
undefined[]
required
Number of blocks in the requested range in hexadecimal. Between 1 (0x1) and 1024 (0x400) blocks can be requested in a single query. Less than requested may be returned if not all blocks are available.
BlockNumberOrTag
object
oneOf
the block number with type integer
number
the block number with type hexadecimal
string
the block tag [latest, pending, earliest]
string
An array of floating point values between 0 and 100.
Responses
- 200
Returns historical gas information for a range of blocks.
- application/json
- Schema
- Example (from schema)
Schema
error
object
A Number that indicates the error type that occurred. This MUST be an integer.
code | message | description |
---|---|---|
-32700 | Parse error | invalid JSON was received by the server. An error occurred on the server while parsing the JSON text. |
-32602 | Invalid params | Invalid method parameter(s). |
A String providing a short description of the error. The message SHOULD be limited to a concise single sentence.
A Primitive or Structured value that contains additional information about the error. This may be omitted. The value of this member is defined by the Server (e.g. detailed error information, nested errors etc.).
result
object
Lowest number block of returned range.
An array of block base fee 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-Magma blocks.
An array of block gas used ratios. Measures the network congestion level. These are calculated as the ratio of block gas used and KIP-71 MAX_BLOCK_GAS_USED_FOR_BASE_FEE. If the ratio is above 1, then 1 is returned.
A 2D array of effective priority fees per gas. reward[n][i]
is the rewardPercentiles[i]-th
percentile effective priority fees per gas among the transactions in the block oldestBlock + n
. Only returned if rewardPercentiles is specified.
{
"jsonrpc": "2.0",
"id": 0,
"error": {
"code": -32700,
"message": "Parse error",
"data": "string"
},
"result": {
"oldestBlock": "0xa5b",
"reward": [
[
"0x0",
"0x0",
"0x0"
],
[
"0x5d21dba00",
"0x5d21dba00",
"0x5d21dba00"
]
],
"baseFeePerGas": [
"0x0",
"...",
"0x0"
],
"gasUsedRatio": [
0,
"...",
0.0002963777000002964
]
}
}