{"uid":"cap_wsi0iSIuzl05hFGeBEnmG","slug":"lotus-network-api-base-l2-gas-preflight-905e3fcc","name":"Lotus Network API – Base L2 Gas Preflight","description":"Read-only Base L2 gas conditions computed directly from chain data: current base fee, recent percentiles, realised volatility, congestion state, and an 80% forecast range for a chosen horizon. This is supporting context for timing a transaction, not a trade instruction. Every figure is reproducible from public Base RPC data.","url":"https://lotusnetworkapi.com/api/v1/gas/preflight","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","properties":{"horizonMinutes":{"type":"integer","description":"Forecast horizon in minutes (1-60)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"block":{"type":"number"},"chain":{"type":"string"},"recent":{"type":"object","description":"medianGwei, p10Gwei, p90Gwei, volatility, blocks"},"current":{"type":"object","description":"baseFeeGwei, congestion, gasUsedRatio"},"success":{"type":"boolean"},"forecast":{"type":"object","description":"centerGwei, lowGwei, highGwei, targetBlock, interval"},"observedAt":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"block":24881003,"chain":"base-mainnet","recent":{"blocks":300,"p10Gwei":0.0119,"p90Gwei":0.0181,"medianGwei":0.0138,"volatility":0.041},"current":{"congestion":"calm","baseFeeGwei":0.0142,"gasUsedRatio":0.31},"success":true,"forecast":{"method":"mean-reverting log random walk on realised block volatility","lowGwei":0.0106,"highGwei":0.0182,"interval":0.8,"centerGwei":0.0139,"targetBlock":24881153,"horizonMinutes":5},"observedAt":"2026-07-30T04:12:00.000Z"}},"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_0E3vwTSPEkFp_qvJxWrB1","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 current Base L2 gas conditions (base fee, recent percentiles, volatility, congestion state) plus a probabilistic 80% forecast range for a chosen horizon in minutes.","exampleAgentPrompt":"Before I submit this Base transaction, can you pull a gas preflight for the next 20 minutes — I want to see the current base fee, congestion level, and the 80% forecast range so I can decide whether to send it now or wait?","exampleUseCases":[{"title":"DeFi transaction timing decision","prompt":"I'm about to execute a swap on Base — can you check the current gas conditions and forecast for the next 15 minutes so I can decide if now is a good time or if I should wait for fees to drop?"},{"title":"Monitoring Base congestion before mint","prompt":"I have an NFT mint coming up on Base. Pull a gas preflight for the next 30 minutes — I need the congestion state, current base fee, and the low-to-high forecast range before I commit."},{"title":"Automated agent gas gating","prompt":"Before the agent submits that on-chain action, run a gas preflight on Base with a 10-minute horizon and tell me if the network is congested and what the p10 to p90 fee range looks like right now."}],"resultDescription":"A JSON object containing: the current Base block number, observed timestamp, current base fee in Gwei, gas used ratio, congestion label; recent statistics (median, p10, p90 in Gwei, realised volatility, block count); and a forecast object (center, low, high Gwei estimates, target block, and interval) representing an 80% confidence range for the requested horizon.","failureModes":["Invalid horizonMinutes value outside 1–60 range returns a validation error","RPC connectivity issues may cause stale or unavailable chain data","If Base chain is experiencing an outage, the endpoint may return an error or degraded response","Payment failure (x402 protocol) will block access before any data is returned"],"whenToPreferThis":"Choose this endpoint when an AI agent needs real-time, statistically grounded Base L2 gas intelligence — especially when deciding whether to execute or defer a transaction. It is distinct from generic Ethereum mainnet gas APIs because it reads directly from Base chain RPC data and provides probabilistic forecast ranges with volatility context, not just a spot price. Prefer it over wallet-embedded gas estimators when the agent needs structured, machine-readable forecast data with percentile breakdowns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:46:31.098Z","isFirstParty":false}