{"uid":"cap_egSbl2dM6v0VkjMbCq6iZ","slug":"base-gas-price-oracle-x402-466e2d8c","name":"Base Gas Price Oracle (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/v1/gas?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","properties":{"gas_limit":{"type":"integer","maximum":30000000,"minimum":21000,"examples":[21000,150000],"description":"Gas units to price (default 21000)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"block":37000000,"chain":"base","tiers":{"fast":{"est_cost_usd":0.0007,"max_fee_gwei":0.025,"max_priority_fee_gwei":0.01},"slow":{"est_cost_usd":0.0005,"max_fee_gwei":0.006,"max_priority_fee_gwei":0.001},"standard":{"est_cost_usd":0.0005,"max_fee_gwei":0.011,"max_priority_fee_gwei":0.001}},"sources":["https://mainnet.base.org"],"chain_id":8453,"tx_fields":{"gas":"0x5208","type":"0x2","maxFeePerGas":"0xa7d8c0","maxPriorityFeePerGas":"0xf4240"},"congestion":0.42,"updated_at":"2026-10-29T13:30:00Z","base_fee_gwei":0.005,"gas_price_gwei":0.006,"recommended_tier":"standard","gas_price_wei_hex":"0x5b8d80","est_transfer_cost_eth":1.26e-7,"max_priority_fee_gwei":0.001,"max_priority_fee_wei_hex":"0xf4240"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t4xvbaiTGFCP6y3FgXY1j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current Base network gas prices across slow/standard/fast tiers with estimated USD costs, congestion level, and EIP-1559 fee fields, paid per-call via x402 micropayment.","exampleAgentPrompt":"What are the current gas fees on Base right now — give me the slow, standard, and fast tiers with estimated USD costs, and tell me which tier you'd recommend for a standard ETH transfer of 21000 gas units?","exampleUseCases":[{"title":"Pre-trade gas cost check","prompt":"Before I submit this swap on Base, what's the current standard gas fee in gwei and how much will it cost in USD for 150000 gas units?"},{"title":"Congestion-aware transaction timing","prompt":"Is the Base network congested right now? I want to know the congestion level and whether I should wait before sending my transaction."},{"title":"Trading bot EIP-1559 parameter fetch","prompt":"Give me the maxFeePerGas and maxPriorityFeePerGas hex values I should use for a fast Base transaction right now — my bot needs to set these fields before broadcasting."}],"resultDescription":"JSON object containing: current block number, chain ID (8453), base fee in gwei, gas price in gwei, congestion score (0–1), recommended tier, per-tier breakdown (slow/standard/fast) with max_fee_gwei, max_priority_fee_gwei, and est_cost_usd, plus ready-to-use EIP-1559 tx fields (hex-encoded maxFeePerGas, maxPriorityFeePerGas, gas, type), estimated transfer cost in ETH, data sources, and timestamp.","failureModes":["Payment not attached or insufficient USDC → 402 Payment Required with payment instructions","RPC upstream failure from mainnet.base.org → 502/503 with error message","gas_limit below 21000 or above 30000000 → 400 validation error","Network timeout if Base RPC is slow → 504 Gateway Timeout","Stale data if upstream RPC is lagging — check updated_at field"],"whenToPreferThis":"Use this endpoint when your agent operates on the Base L2 network and needs real-time, tiered gas price data with USD cost estimates before submitting transactions. Prefer it over generic Ethereum gas oracles because it is Base-specific (chain_id 8453), returns EIP-1559 hex fields ready for tx construction, and requires no API key — only a $0.001 USDC micropayment via x402. Best for autonomous trading agents, DeFi bots, or on-chain workflow orchestrators that need to make cost-aware decisions at runtime.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:28.952Z","isFirstParty":false,"canonicalSlug":"base-gas-price-oracle-x402-1a4b40b0"}