{"uid":"cap_wsAwWw9PAG73qh1d7G1jE","slug":"evm-gas-apitoll-cloud-2cf70775","name":"EVM Gas Fee Snapshot API","description":"Multi-chain EVM gas price oracle for AI agents — 17 chains (Ethereum, Base, Arbitrum, Optimism, Polygon, BNB, Avalanche…). One x402 call returns slow/standard/fast EIP-1559 tiers as DROP-IN maxFeePerGas + maxPriorityFeePerGas in wei (plug straight into a viem/ethers tx, no conversion, exact even on sub-gwei L2s), plus base fee, head block, and fullness, from a live eth_feeHistory call. Pass ?chain= to switch chains.","url":"https://evm-gas.apitoll.cloud/v1/evm/gas","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":{"enum":["ethereum","base","optimism","arbitrum","polygon","avalanche","gnosis","linea","scroll","blast","mode","opbnb","celo","bsc","fantom","zksync","mantle"],"type":"string","description":"Target EVM chain id. One of: ethereum, base, optimism, arbitrum, polygon, avalanche, gnosis, linea, scroll, blast, mode, opbnb, celo, bsc, fantom, zksync, mantle. Also accepts common aliases (eth, arb, op, matic, avax, bnb). Default: ethereum."},"blocks":{"type":"integer","maximum":50,"minimum":1,"description":"Recent blocks to sample for percentile reward (1..50, clamped)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"caip2":{"type":"string"},"chain":{"enum":["ethereum","base","optimism","arbitrum","polygon","avalanche","gnosis","linea","scroll","blast","mode","opbnb","celo","bsc","fantom","zksync","mantle"],"type":"string"},"stats":{"type":"object","properties":{"ts":{"type":"string","format":"date-time"},"blocks_sampled":{"type":"integer"},"median_fullness_pct":{"type":"number"}}},"tiers":{"type":"object","properties":{"fast":{"type":"object","properties":{"maxFeePerGas":{"type":"string"},"max_fee_gwei":{"type":"number"},"max_priority_gwei":{"type":"number"},"maxPriorityFeePerGas":{"type":"string"}}},"slow":{"type":"object","properties":{"maxFeePerGas":{"type":"string"},"max_fee_gwei":{"type":"number"},"max_priority_gwei":{"type":"number"},"maxPriorityFeePerGas":{"type":"string"}}},"standard":{"type":"object","properties":{"maxFeePerGas":{"type":"string"},"max_fee_gwei":{"type":"number"},"max_priority_gwei":{"type":"number"},"maxPriorityFeePerGas":{"type":"string"}}}},"description":"Slow (p10) / standard (p50) / fast (p90) EIP-1559 fee tiers. Each carries human gwei (max_fee_gwei/max_priority_gwei) AND DROP-IN wei (maxFeePerGas/maxPriorityFeePerGas, BigInt-ready) to plug straight into a viem/ethers tx."},"gas_note":{"type":"string"},"gas_model":{"enum":["eip1559","mostly-legacy","non-standard"],"type":"string"},"chain_name":{"type":"string"},"base_fee_wei":{"type":"string","description":"Base fee in wei (exact, BigInt-ready decimal string)."},"block_number":{"type":"integer"},"base_fee_gwei":{"type":"number","description":"Base fee for the next block (gwei, human-readable)."}}}}}}},"responseSchema":{"type":"json","example":{"caip2":"eip155:1","chain":"ethereum","stats":{"ts":"2026-05-28T15:42:30.000Z","blocks_sampled":20,"median_fullness_pct":45.5},"tiers":{"fast":{"maxFeePerGas":"14831000000","max_fee_gwei":14.831,"max_priority_gwei":2.2,"maxPriorityFeePerGas":"2200000000"},"slow":{"maxFeePerGas":"12631000000","max_fee_gwei":12.631,"max_priority_gwei":0.001,"maxPriorityFeePerGas":"1000000"},"standard":{"maxFeePerGas":"13731000000","max_fee_gwei":13.731,"max_priority_gwei":1.1,"maxPriorityFeePerGas":"1100000000"}},"gas_model":"eip1559","chain_name":"Ethereum mainnet","base_fee_wei":"8421000000","block_number":21403217,"base_fee_gwei":8.421}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","blocks":5}}},"response":{"caip2":"eip155:1","chain":"ethereum","stats":{"ts":"2026-06-10T04:34:07.424Z","blocks_sampled":5,"median_fullness_pct":54.03},"tiers":{"fast":{"max_fee_gwei":0.2895,"max_priority_gwei":0.1},"slow":{"max_fee_gwei":0.1899,"max_priority_gwei":0.0004},"standard":{"max_fee_gwei":0.1906,"max_priority_gwei":0.0011}},"gas_model":"eip1559","chain_name":"Ethereum mainnet","block_number":25284684,"base_fee_gwei":0.1263}},"exampleRequest":{"chain":"ethereum","blocks":5},"tags":["x402"],"displayCostAmount":"0.001","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.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_2vy6RTTdx3_U2QR8mTeY7","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 real-time EIP-1559 gas fee tiers (slow/standard/fast), current base fee, latest block, and median block fullness for 17 EVM-compatible chains via direct RPC eth_feeHistory sampling.","exampleAgentPrompt":"What are the slow, standard, and fast gas fee tiers on Arbitrum right now — sample the last 10 blocks?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the chain name, CAIP-2 identifier, current base fee in gwei, latest block number, gas model type (eip1559/mostly-legacy/non-standard), slow/standard/fast priority fee tiers (p10/p50/p90), median block fullness percentage, number of blocks sampled, and a human-readable gas note with a timestamp.","failureModes":["Invalid or unsupported chain name returns 400 with validation error","blocks parameter out of range (>50 or <1) is clamped or rejected","RPC node unavailable for a specific chain may return 503 or timeout","Payment not provided or invalid x402 token returns 402 Payment Required","Malformed query parameters return schema validation error"],"whenToPreferThis":"Choose this endpoint when you need real-time, multi-tier EIP-1559 gas fee data across any of 17 EVM chains with a single lightweight GET call. Ideal for AI agents doing cross-chain transaction scheduling, fee estimation before submitting a transaction, or monitoring network congestion. Prefer over on-chain RPC calls when you don't maintain your own node infrastructure or need pre-computed percentile tiers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:36:22.745Z","isFirstParty":false}