{"uid":"cap_eGkWNZfE5sPyKmbIxMvSU","slug":"blockrun-ai-9d0e1ea5","name":"BlockRun.AI Gas Price","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/surf/onchain/gas-price","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"Required query param"}}},"responseSchema":null,"example":{"request":{"chain":"ethereum"},"response":{"data":{"chain":"ethereum","gas_price":"120636533","gas_price_gwei":0.120636533},"meta":{"cached":false,"credits_used":1},"$schema":"https://api.asksurf.ai/schemas/DataObjectResponseOnchainGasPriceItem.json"}},"exampleRequest":{"chain":"ethereum"},"tags":["x402"],"displayCostAmount":"0.0075","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0075/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OosFS7cXmzEW__TMKTjrk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current gas price for a specified blockchain network.","exampleAgentPrompt":"What's the current gas price on Ethereum right now?","exampleUseCases":[{"title":"Real-time fee optimization for DEX swaps","prompt":"Before I execute this token swap, can you check what gas fees are like on Polygon right now so I know if it's a good time to trade?"},{"title":"Multi-chain transaction cost comparison","prompt":"I need to bridge my assets across chains — compare the current gas prices on Ethereum, Arbitrum, and Base so I can pick the cheapest option."},{"title":"User-facing gas fee transparency widget","prompt":"Show me the live gas fees across all the major chains we support so our users can see network congestion levels before they initiate transactions."}],"resultDescription":"Returns the current gas price for the specified blockchain chain, likely including values such as base fee, priority fee, or gas price in gwei or native units.","failureModes":["Unsupported or unrecognized chain value returns an error","Missing required 'chain' query parameter returns a 400 bad request","Network or upstream data provider outage returns 5xx","Payment not completed or invalid x402 payment header returns 402"],"whenToPreferThis":"Use this endpoint when you need real-time gas price data for a specific blockchain network to estimate transaction costs, optimize timing of on-chain transactions, or surface fee information to users in a DeFi or Web3 application.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:47:56.834Z","isFirstParty":false}