Ethereum
Ethereum
Bereit, das in der Produktion aufzurufen?
Das Free-Tier deckt persönliche Projekte ab. Pay-as-you-go skaliert ohne Karte.
Ethereum
Das Free-Tier deckt persönliche Projekte ab. Pay-as-you-go skaliert ohne Karte.
eth_feeHistory returns a window of recent fee data from Ethereum mainnet: the protocol baseFeePerGas for each block (the portion of the fee that gets burned under EIP-1559), the gasUsedRatio showing how full each block was, and, when you ask for them, priority-fee tips sampled at the percentiles you specify. Since London the base fee floats with demand — rising when blocks run past the 50% target, falling when they're empty — so a few blocks of history is the raw material for picking sane maxFeePerGas and maxPriorityFeePerGas values on a type-2 transaction. Query it at https://ethereum.therpc.io/YOUR_API_KEY (chain ID 1) and feed the arrays into your fee oracle. All fee figures are in wei of ETH.
maxFeePerGas with headroom for a base-fee climb over the next few slots.baseFeePerGas array over a window so a wallet or explorer can show users whether fees are spiking or cooling.gasUsedRatio — values pinned near 1.0 across consecutive blocks mean the base fee is about to ratchet up; near zero means it's draining.reward arrays to gauge how aggressively others are tipping for priority inclusion, then size your own tip to land in the block you want.| # | Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|---|
| 1 | blockCount | string | number | Ja | Number of blocks to include in the history window. Most providers cap this at 1024. |
| 2 | newestBlock | string | Ja | The most recent block to include in the window.Standard: latest |
| 3 | rewardPercentiles | number[] | Nein | Array of percentile values (0–100) at which to sample priority fees from each block. Pass an empty array to omit reward data. |
| Typ | Beschreibung |
|---|---|
| object | Object with: `oldestBlock` (hex, starting block of the window), `baseFeePerGas` (array of hex wei — one per block plus the next predicted value), `gasUsedRatio` (array of floats 0–1 per block), `reward` (array of arrays — per-block percentile priority fees in hex wei; only present when `rewardPercen |
Try it live in the Ethereum playground.
| Code | Meldung | Ursache |
|---|---|---|
-32602 | invalid argument | blockCount is 0, out of range, or rewardPercentiles contains values outside 0–100. |
-32000 | block not found | `newestBlock` references a block that does not exist on this node. |
baseFeePerGas array has one more entry than the number of blocks you requested. That trailing element is the protocol-computed base fee for the next block — a forecast, not a mined value — so don't pair it with a real block's data.blockCount and percentile count. Providers cap the window (commonly 1024); for charts, request 100–200 blocks per call and stitch windows rather than pulling the full cap at once.Parameter
Hex or decimal integer, e.g. "0xa" or 10
"latest" | "safe" | "finalized" | hex block number
Array of percentile values (0–100) at which to sample priority fees from each block. Pass an empty array to omit reward data.