{"uid":"cap_URzHLtAOzjT3cB31zEcaL","slug":"agent-data-tools-revmesh2074-workers-dev-ethereum-gas-price-history-e986ccc2","name":"Ethereum Gas Price History","description":"Gas price history on Ethereum (eth_feeHistory): base fee in gwei for each of the last N blocks (5-100, default 20), how full each block was, and the 10th, 50th and 90th percentile priority fees, with the low, average and high base fee over the window. Use to judge whether fees are rising, pick a priority fee or time a transaction; for the current price alone use eth_gas.","url":"https://agent-data-tools.revmesh2074.workers.dev/eth/gas-history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"blocks":{"type":"integer","description":"How many recent blocks, 5-100 (default 20)"}}},"responseSchema":{"type":"object","properties":{"chain":{"type":"string"},"blocks":{"type":"number"},"chainId":{"type":"number"},"history":{"type":"array","items":{"type":"object","properties":{"block":{"type":"number"},"baseFeeGwei":{"type":"number"},"gasUsedRatio":{"type":"number"},"priorityFeeGwei":{"type":"array","items":{"type":"number"}}}}},"toBlock":{"type":"number"},"fromBlock":{"type":"number"},"baseFeeGwei":{"type":"object","properties":{"low":{"type":"number"},"high":{"type":"number"},"next":{"type":"number"},"latest":{"type":"number"},"average":{"type":"number"}}},"priorityFeeGwei":{"type":"object","properties":{"p10":{"type":"number"},"p50":{"type":"number"},"p90":{"type":"number"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LtmtjnFZ9Bno7UN6x2tOK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Returns per-block base fee, block fullness, and priority fee percentiles for the last N Ethereum blocks, plus aggregate low/average/high summaries.","exampleAgentPrompt":"Can you pull the Ethereum gas price history for the last 50 blocks and tell me whether fees are trending up or down and what priority fee I should use?","exampleUseCases":[{"title":"Timing a large DeFi transaction","prompt":"I want to submit a big swap on Ethereum — can you check the gas fee history for the last 100 blocks and tell me whether fees are rising or if this is a good moment to go?"},{"title":"Choosing a priority fee tip","prompt":"I'm about to send an Ethereum transaction and need to pick a priority fee — can you pull the last 20 blocks of fee history and tell me what the 10th, 50th, and 90th percentile tips look like?"},{"title":"Monitoring gas congestion over time","prompt":"Check the Ethereum gas history for the last 100 blocks and tell me how full the blocks have been and whether the base fee has been climbing — I'm trying to decide if congestion is unusually high right now."}],"resultDescription":"A JSON object containing: the chain name and ID, the requested block range (fromBlock, toBlock), a per-block array with block number, base fee in gwei, gas used ratio, and a [p10, p50, p90] priority fee array; plus aggregate baseFeeGwei stats (low, average, high, latest, next) and priorityFeeGwei percentiles (p10, p50, p90) across the window.","failureModes":["blocks parameter out of range (< 5 or > 100) returns validation error","RPC node temporarily unavailable returns 5xx error","Network connectivity issues may cause timeouts","Payment not included or insufficient returns 402 response (first 25 calls free)"],"whenToPreferThis":"Use this endpoint when you need a historical window of Ethereum gas data to judge trends, pick an appropriate priority fee, or decide whether to wait before submitting a transaction. For just the current gas price without history, use the eth_gas endpoint instead. Prefer this over raw RPC calls when you want pre-computed percentiles and aggregates without parsing raw eth_feeHistory yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:35:20.438Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-ethereum-gas-price-history-e986ccc2"}