{"openapi":"3.1.0","info":{"title":"Ethereum Supply & Burn API","version":"1.0.0","description":"Live Ethereum monetary-policy data — the total ETH supply, how much of it is being created versus destroyed, and the EIP-1559 fee burn that can make ether deflationary (the \"ultrasound money\" thesis), powered by the public ultrasound.money feed, no key, nothing stored. The supply endpoint returns the current circulating ETH supply and its net change over the last 5 minutes, hour, day, week and month — a negative change means more ETH was burned than issued, i.e. net deflation. The burn endpoint returns the ETH destroyed by the base-fee burn over each window in both ETH and USD, the live burn rate in ETH per minute and the current deflationary streak. The basefee endpoint returns the current base fee per gas, the blob base fee and the ETH price. The leaderboard endpoint ranks the apps and contracts burning the most ETH right now. Track ETH issuance, the burn and whether ether is deflating as live JSON. This is the ETH supply / issuance / burn cut — distinct from the gas-fee, on-chain and price APIs in the catalogue.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ethburn-api","description":"oanor gateway"}],"tags":[{"name":"Supply"},{"name":"Burn"},{"name":"BaseFee"},{"name":"Leaderboard"},{"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/supply":{"get":{"operationId":"get_v1_supply","tags":["Supply"],"summary":"ETH supply and net change over windows","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"net_change_eth is issuance minus burn over the window; negative means net deflation (more ETH burned than created).","chain":"Ethereum","source":"ultrasound.money","block_number":25295502,"net_change_eth":{"d1":2783.4,"d7":19175.05,"h1":109.9088,"m5":11.897,"d30":82439.69},"current_supply_eth":121771358.57},"meta":{"timestamp":"2026-06-11T16:46:43.185Z","request_id":"542d10ca-2ff7-43d3-9c52-1d5917ac7d2b"},"status":"ok","message":"Supply 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/burn":{"get":{"operationId":"get_v1_burn","tags":["Burn"],"summary":"ETH burned per window, rate, deflation","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Ethereum","source":"ultrasound.money","burned_eth":{"d7":539.4272,"h1":3.9726,"m5":0.2299,"all":4634878,"d30":1960,"h24":42.2576,"since_merge":2011568},"burned_usd":{"d7":881181,"h1":6529.17,"m5":377.53,"d30":3833722,"h24":69285,"since_merge":4548047208},"deflationary_streak":[],"burn_rate_eth_per_min":{"d7":0.05351,"h1":0.06621,"m5":0.04599,"d30":0.04536,"h24":0.02935}},"meta":{"timestamp":"2026-06-11T16:46:43.352Z","request_id":"b7cf4577-3d25-424e-88e7-eda71256960f"},"status":"ok","message":"Burn 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/basefee":{"get":{"operationId":"get_v1_basefee","tags":["BaseFee"],"summary":"Base fee per gas, blob fee, ETH price","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Ethereum","source":"ultrasound.money","base_fee_gwei":0.3442,"eth_price_usd":1639.67,"blob_base_fee_gwei":0.016535,"eth_price_24h_change_pct":-0.12},"meta":{"timestamp":"2026-06-11T16:46:43.458Z","request_id":"7882c7d0-c25e-4e6c-8db8-e9d94b095acf"},"status":"ok","message":"Base fee 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/leaderboard":{"get":{"operationId":"get_v1_leaderboard","tags":["Leaderboard"],"summary":"Top ETH-burning apps and contracts","description":"","parameters":[{"name":"period","in":"query","required":false,"description":"5m, 1h, 24h, 7d, 30d, all, since_merge","schema":{"type":"string"},"example":"24h"},{"name":"limit","in":"query","required":false,"description":"Max rows (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Apps and contracts that burned the most ETH (base fee) over the period.","count":25,"period":"24h","source":"ultrasound.money","leaderboard":[{"id":"eth-transfers","name":"ETH transfers","rank":1,"type":"eth-transfers","burned_eth":2.9603,"burned_usd":4857.22},{"id":"0xdac17f958d2ee523a2206206994597c13d831ec7","name":"Tether: USDT Stablecoin","rank":2,"type":"contract","burned_eth":2.9004,"burned_usd":4759.69},{"id":"0x00fe78205f5f0e63b8ad2b2ae5337f538a610e04","rank":3,"type":"contract","burned_eth":2.0074,"burned_usd":3292.87},{"id":"contract-creations","name":"new contracts","rank":4,"type":"contract-creations","burned_eth":1.8336,"burned_usd":2993.1},{"id":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","name":"Circle: USDC Token","rank":5,"type":"contract","burned_eth":1.3771,"burned_usd":2258.81},{"id":"0x0000000000000068f116a894984e2db1123eb395","name":"Seaport 1.6","rank":6,"type":"contract","burned_eth":1.0738,"burned_usd":1760.76},{"id":"0xba2b2ee76749f131d0303649d9bffc878488abce","rank":7,"type":"contract","burned_eth":1.0693,"burned_usd":1740.76},{"id":"0x00005ea00ac477b1030ce78506496e8c2de24bf5","name":"SeaDrop","rank":8,"type":"contract","burned_eth":0.832,"burned_usd":1366.8},{"id":"0x19917386eeae67b6ff7ddf07de4019fca40aa4ec","rank":9,"type":"contract","burned_eth":0.6951,"burned_usd":1139.71},{"id":"0xbdb3ba9ffe392549e1f8658dd2630c141fdf47b6","rank":10,"type":"contract","burned_eth":0.6631,"burned_usd":1087.04},{"id":"0xbbbbb048b1a85ca221058c45525095b6a68bbbbb","rank":11,"type":"contract","burned_eth":0.6602,"burned_usd":1082.91},{"id":"0x278d858f05b94576c1e6f73285886876ff6ef8d2","rank":12,"type":"contract","burned_eth":0.631,"burned_usd":1035.34},{"id":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","name":"Uniswap V2: Router 2","rank":13,"type":"contract","burned_eth":0.6097,"burned_usd":998.97},{"id":"0xae2001f7e21d5ecabf6234e9fdd1e76f50f74962","rank":14,"type":"contract","burned_eth":0.5961,"burned_usd":976.82},{"id":"0x28b1dc1a5e3699a428bc51d234dfab7c9cb2a183","rank":15,"type":"contract","burned_eth":0.5231,"burned_usd":858.21},{"id":"0x0000000071727de22e5e9d8baf0edac6f37da032","rank":16,"type":"contract","burned_eth":0.5062,"burned_usd":830.17},{"id":"0x66a9893cc07d91d95644aedd05d03f95e1dba8af","rank":17,"type":"contract","burned_eth":0.4724,"burned_usd":775.79},{"id":"0xf00d3e96dd2ad20181a90c9f12125c3f4310fc0d","rank":18,"type":"contract","burned_eth":0.4604,"burned_usd":750.68},{"id":"0x51c72848c68a965f66fa7a88855f9f7784502a7f","rank":19,"type":"contract","burned_eth":0.416,"burned_usd":680.66},{"id":"0xb300000b72deaeb607a12d5f54773d1c19c7028d","rank":20,"type":"contract","burned_eth":0.3656,"burned_usd":599.93},{"id":"0x7ec8a30a34b86927dc77b302603d1d53e640bef7","rank":21,"type":"contract","burned_eth":0.3382,"burned_usd":556.73},{"id":"0x9d1c0529884a60a941074e541188a4564a500e6c","rank":22,"type":"contract","burned_eth":0.3305,"burned_usd":547.04},{"id":"0x3d0f22bf11636cc9cb129e2b261eed35a487455c","rank":23,"type":"contract","burned_eth":0.3245,"burned_usd":532.4},{"id":"0x0000000000001ff3684f28c67538d4d072c22734","rank":24,"type":"contract","burned_eth":0.324,"burned_usd":531.32},{"id":"0xccc88a9d1b4ed6b0eaba998850414b24f1c315be","rank":25,"type":"contract","burned_eth":0.3217,"burned_usd":527.21}]},"meta":{"timestamp":"2026-06-11T16:46:43.570Z","request_id":"06e58d67-c7a0-4cd2-8845-ac0e07376ee2"},"status":"ok","message":"Leaderboard 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":{"note":"On-chain amounts are wei (1 ETH = 1e18 wei) converted to ETH; gas fees converted to Gwei. leaderboard period: 5m, 1h, 24h, 7d, 30d, all, since_merge.","source":"ultrasound.money (ultrasound.money/api, live)","service":"ethburn-api","endpoints":{"GET /v1/burn":"ETH burned per window (ETH + USD), burn rate in ETH/min, deflationary streak.","GET /v1/meta":"This document.","GET /v1/supply":"Current ETH supply and net change over 5m/1h/1d/7d/30d (negative = deflation).","GET /v1/basefee":"Current base fee per gas (Gwei), blob base fee and ETH price.","GET /v1/leaderboard":"Apps/contracts burning the most ETH (period=24h, limit=25)."},"eth_supply":121771358.57,"description":"Live Ethereum monetary-policy data: total ETH supply, net issuance versus the EIP-1559 fee burn that can make ether deflationary ('ultrasound money'), from ultrasound.money. The supply endpoint returns current ETH supply and its net change over 5m/1h/1d/7d/30d (negative = net deflation); the burn endpoint returns ETH destroyed by the base-fee burn per window in ETH and USD, the burn rate in ETH/min and the deflationary streak; the basefee endpoint returns the current base fee per gas, blob base fee and ETH price; the leaderboard endpoint ranks the apps and contracts burning the most ETH. Live, no key, nothing stored. The ETH supply / issuance / burn cut — distinct from the gas-fee, on-chain and price APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-11T16:46:43.648Z","request_id":"3a5bf3e9-493a-4b6e-aa71-7e933b174b78"},"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":19000,"rps_limit":3,"hard_limit":true},{"slug":"analyst","name":"Analyst","price_cents_month":845,"monthly_call_quota":205000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2390,"monthly_call_quota":890000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5510,"monthly_call_quota":3050000,"rps_limit":65,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ethburn-api"}