{"uid":"cap_Wm_6-73c33ulc-4pHb7a3","slug":"ethereum-gas-telemetry-03aa9548","name":"Ethereum Gas Telemetry","description":"Ethereum EIP-1559 gas per recent block: base fee (gwei), gas used ratio, and priority fee (tip) percentiles at 10/50/90 from eth_feeHistory, plus the next block's base fee. Gas used by contract is not included (this RPC does not give it).","url":"https://api.chainmarket-api.workers.dev/api/crypto/ethereum-gas-telemetry?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"blockCount":{"type":"string","description":"How many recent blocks, 1 to 20 (default 5)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"blocks":[{"baseFeeGwei":0.071402703,"blockNumber":26254462,"gasUsedRatioPct":28.83,"priorityFeeGwei":{"p10":0.001,"p50":0.02656767,"p90":1}},{"baseFeeGwei":0.067623505,"blockNumber":26254463,"gasUsedRatioPct":26.15,"priorityFeeGwei":{"p10":0.000002456,"p50":0.00029472,"p90":1}}],"source":"https://ethereum-rpc.publicnode.com","checkedAt":"2026-10-23T09:35:54.739Z","blockCount":5,"oldestBlock":26254462,"nextBaseFeeGwei":0.06955529}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M6Dley4x0fs0zt21_WbkE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-block Ethereum gas fee telemetry including base fee, gas used ratio, and priority fee percentiles for recent blocks","exampleAgentPrompt":"What are the current Ethereum gas fees — show me base fee, priority fee percentiles, and the expected next base fee across the last 5 blocks so I can decide whether to submit my transaction now.","exampleUseCases":[{"title":"Optimal transaction timing for DeFi trader","prompt":"Check Ethereum gas telemetry for the last 10 blocks and tell me what the p10 and p90 priority fees look like — I want to know if now is a good time to submit a swap or if I should wait for lower fees."},{"title":"Gas cost estimator for on-chain agent","prompt":"Fetch Ethereum gas data for the most recent 3 blocks — I need the base fee and the median priority fee so I can estimate how much my smart contract call will cost right now."},{"title":"Network congestion monitoring dashboard","prompt":"Pull Ethereum gas telemetry for the last 20 blocks and give me the gas used ratio and base fee trend so I can see if the network is getting more or less congested over time."}],"resultDescription":"Returns a JSON object containing an array of recent blocks (up to 20), each with blockNumber, baseFeeGwei, gasUsedRatioPct, and priorityFeeGwei percentiles (p10, p50, p90). Also includes nextBaseFeeGwei (the projected next base fee), total blockCount, oldestBlock number, the source RPC URL, and a checkedAt ISO timestamp.","failureModes":["Invalid blockCount value (outside 1-20 range) may return an error or be clamped to defaults","Upstream PublicNode RPC unavailability could cause a failed fetch — no charge on failure","Stale data if the public RPC node is lagging behind chain head","Network timeout if the Cloudflare Worker or upstream RPC is slow"],"whenToPreferThis":"Choose this endpoint when you need real-time Ethereum gas fee data across multiple recent blocks with percentile-level priority fee breakdown (p10/p50/p90) and next-base-fee prediction — without requiring an API key or signup. Prefer this over raw RPC calls when you want pre-parsed, structured gas telemetry with no infrastructure setup, paying only $0.002 USDC per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:43:33.443Z","isFirstParty":false,"canonicalSlug":"ethereum-gas-telemetry-03aa9548"}