Ethereum
¿Listo para usar esto en producción?
El plan gratuito cubre proyectos personales. El pago por uso escala sin necesidad de tarjeta.
Ethereum
El plan gratuito cubre proyectos personales. El pago por uso escala sin necesidad de tarjeta.
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.| # | Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| 1 | blockCount | string | number | Sí | Number of blocks to include in the history window. Most providers cap this at 1024. |
| 2 | newestBlock | string | Sí | The most recent block to include in the window.Predeterminado: latest |
| 3 | rewardPercentiles | number[] | No | Array of percentile values (0–100) at which to sample priority fees from each block. Pass an empty array to omit reward data. |
| Tipo | Descripción |
|---|---|
| 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.
| Código | Mensaje | Causa |
|---|---|---|
-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.Parámetros
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.