{"openapi":"3.1.0","info":{"title":"Multi-Chain Gas Fees API","version":"1.0.0","description":"Live multi-chain EVM gas-fee oracle — the gas estimate every wallet, bridge and dApp needs — computed straight from each network's public JSON-RPC node. Using EIP-1559 fee history it derives the next block's base fee and slow, standard and fast priority-fee tiers from the recent reward percentiles, and returns per tier the priority fee, the suggested max fee and the resulting total gas price, all in gwei. It also estimates the cost of a transaction — a plain transfer or any gas limit you pass — in the chain's native coin. Supports Ethereum, Polygon, BSC, Arbitrum, Optimism, Base and Avalanche. Live, no key, no cache. Distinct from price, market-cap and on-chain TVL APIs — this is the real-time gas-price layer.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/gasfees-api","description":"oanor gateway"}],"tags":[{"name":"Gas"},{"name":"Estimate"},{"name":"Chains"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/gas":{"get":{"operationId":"get_v1_gas","tags":["Gas"],"summary":"Gas estimate for a chain","description":"","parameters":[{"name":"chain","in":"query","required":false,"description":"Chain: ethereum|polygon|bsc|arbitrum|optimism|base|avalanche","schema":{"type":"string"},"example":"ethereum"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Ethereum","chain":"ethereum","tiers":{"fast":{"max_fee_gwei":1.065,"gas_price_gwei":0.937,"priority_fee_gwei":0.809},"slow":{"max_fee_gwei":0.264,"gas_price_gwei":0.135,"priority_fee_gwei":0.007},"standard":{"max_fee_gwei":0.327,"gas_price_gwei":0.198,"priority_fee_gwei":0.07}},"native":"ETH","fee_type":"eip1559","base_fee_gwei":0.128},"meta":{"timestamp":"2026-06-09T03:02:38.832Z","request_id":"ec343707-9b2e-43d7-9a52-b192c9cc5681"},"status":"ok","message":"Gas fees retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/estimate":{"get":{"operationId":"get_v1_estimate","tags":["Estimate"],"summary":"Transaction cost in native coin","description":"","parameters":[{"name":"chain","in":"query","required":false,"description":"Chain","schema":{"type":"string"},"example":"ethereum"},{"name":"tier","in":"query","required":false,"description":"Speed: slow|standard|fast","schema":{"type":"string"},"example":"fast"},{"name":"gas_limit","in":"query","required":false,"description":"Gas units (default 21000 transfer)","schema":{"type":"string"},"example":"21000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Ethereum","note":"default = a plain native transfer (21000 gas)","tier":"fast","chain":"ethereum","native":"ETH","gas_limit":21000,"cost_label":"0.000019679 ETH","cost_native":1.9679e-5,"gas_price_gwei":0.937},"meta":{"timestamp":"2026-06-09T03:02:38.958Z","request_id":"e531b69a-2dde-4641-9c83-24cb03c01531"},"status":"ok","message":"Estimate retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/chains":{"get":{"operationId":"get_v1_chains","tags":["Chains"],"summary":"List supported chains and aliases","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":7,"chains":[{"key":"ethereum","name":"Ethereum","native":"ETH","fee_type":"eip1559"},{"key":"polygon","name":"Polygon","native":"POL","fee_type":"eip1559"},{"key":"bsc","name":"BNB Smart Chain","native":"BNB","fee_type":"legacy"},{"key":"arbitrum","name":"Arbitrum One","native":"ETH","fee_type":"eip1559"},{"key":"optimism","name":"Optimism","native":"ETH","fee_type":"eip1559"},{"key":"base","name":"Base","native":"ETH","fee_type":"eip1559"},{"key":"avalanche","name":"Avalanche C-Chain","native":"AVAX","fee_type":"eip1559"}],"aliases":{"op":"optimism","arb":"arbitrum","bnb":"bsc","eth":"ethereum","pol":"polygon","avax":"avalanche","matic":"polygon","binance":"bsc","avalanche_c":"avalanche","arbitrum_one":"arbitrum"}},"meta":{"timestamp":"2026-06-09T03:02:39.050Z","request_id":"b9024aac-0866-47db-8544-47d1b024f179"},"status":"ok","message":"Chains retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chains":["ethereum","polygon","bsc","arbitrum","optimism","base","avalanche"],"source":"Public chain RPC (publicnode) eth_feeHistory + eth_gasPrice (live)","service":"gasfees-api","endpoints":{"GET /v1/gas":"Gas estimate for a chain (chain=ethereum|polygon|bsc|arbitrum|optimism|base|avalanche): base fee + slow/standard/fast tiers in gwei.","GET /v1/meta":"This document.","GET /v1/chains":"List supported chains and aliases.","GET /v1/estimate":"Transaction cost in native coin (chain, gas_limit default 21000, tier=slow|standard|fast)."},"description":"Live multi-chain EVM gas-fee oracle from each network's public JSON-RPC: next-block base fee plus slow / standard / fast tiers (priority fee, suggested max fee, total gas price) in gwei, and a transaction cost estimate in the native coin. Supports Ethereum, Polygon, BSC, Arbitrum, Optimism, Base and Avalanche. Live, no key. The gas estimate every wallet, bridge and dApp needs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:39.162Z","request_id":"ad9f34d4-0de1-4dfc-9934-d7143122178d"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":15000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1000,"monthly_call_quota":200000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":1000000,"rps_limit":40,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":6900,"monthly_call_quota":5000000,"rps_limit":120,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/gasfees-api"}