{"uid":"cap_INTeMNPkXPF5xvAt5rBBz","slug":"saylor-innovations-data-desk-evm-gas-fee-history-3b396c80","name":"Saylor Innovations Data Desk – EVM Gas Fee History","description":"EVM gas fee history - base fee, priority tip percentiles, trend and congestion for a chain over the last N blocks with the USD cost of a transfer","url":"https://saylorinnovations.com/api/gas/history?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":["chain"],"properties":{"chain":{"type":"string","description":"ethereum, base, arbitrum, optimism, polygon, bsc, avalanche or linea"},"blocks":{"type":"string","description":"optional 2-100 recent blocks, default 20"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["chain","base_fee_gwei"],"properties":{"chain":{"type":"string","description":"Blockchain the data is for"},"trend":{"type":"string","description":"Direction of recent change"},"checked_at":{"type":["string","null"],"description":"Time the check was run (UTC)"},"congestion":{"type":"string"},"base_fee_gwei":{"type":"object","description":"Base fee per gas in gwei"},"blocks_sampled":{"type":["number","null"],"description":"Blocks sampled"},"priority_tip_gwei":{"type":"object","description":"Priority tip, in gwei"},"base_fee_trend_pct":{"type":["number","null"],"description":"Base fee trend, as a percentage"},"native_transfer_cost":{"type":"object","description":"Native transfer cost"},"series_base_fee_gwei":{"type":"array","items":{"type":"number"},"description":"Series base fee, in gwei"},"next_block_base_fee_gwei":{"type":"number","description":"Next block base fee, in gwei"},"avg_block_utilization_pct":{"type":["number","null"],"description":"Avg block utilization, as a percentage"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_5JIcjOsR2wJLi0s5HkKrl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns EVM gas fee history including base fee, priority tip percentiles, trend, congestion level, and USD transfer cost for a given chain over recent blocks","exampleAgentPrompt":"What are the gas fees looking like on Ethereum right now — base fee, priority tips, and whether it's trending up or down — and how much would a simple transfer cost in USD? Sample the last 50 blocks.","exampleUseCases":[{"title":"DeFi transaction timing optimizer","prompt":"Check the gas fee history on Arbitrum over the last 30 blocks — is congestion high, and is the base fee trending up or down? I want to know if now is a good time to submit my transaction."},{"title":"Multi-chain gas cost dashboard","prompt":"Pull gas fee data for Base, Optimism, and Polygon — give me the base fee, priority tip percentiles, and USD cost of a native transfer on each so I can compare which chain is cheapest right now."},{"title":"Gas spike alerting for automation","prompt":"Get the last 100 blocks of gas history on Ethereum and tell me the current congestion level, average block utilization, and base fee trend percentage — I'm trying to detect if we're in a gas spike."}],"resultDescription":"A JSON object containing: the chain name, base fee stats in gwei (min/max/avg), priority tip percentiles in gwei, trend direction string (e.g. rising/falling/stable), congestion label, next block base fee estimate, average block utilization percentage, base fee trend as a percentage, a block-by-block base fee series array, the number of blocks sampled, the native transfer cost in USD, and a timestamp of when the check was run.","failureModes":["Unsupported chain name returns an error — must be one of: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, linea","Blocks parameter outside 2–100 range is rejected","Chain RPC unavailability may result in stale or missing data","Payment failure (x402) prevents the response from being returned","Missing required 'chain' query parameter returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need historical gas fee context — trends, percentiles, and congestion levels — rather than just a single point-in-time gas price quote. It is especially useful for agents that need to decide when to submit transactions, compare gas costs across multiple EVM chains, or build gas dashboards. The USD transfer cost output makes it immediately actionable without requiring additional token price lookups. Prefer this over raw RPC calls when you want structured, pre-computed analytics over a configurable recent window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:36:40.492Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-data-desk-evm-gas-fee-history-3b396c80"}