{"openapi":"3.1.0","info":{"title":"Hedera Network & Nodes API","version":"1.0.0","description":"Read Hedera's network layer live from the public Hedera Mirror Node — no key. Hedera runs on a permissioned set of council-operated consensus nodes; the Hedera on-chain reader resolves account, token and HBAR-supply state, but it does not surface the node set, the live HBAR/USD exchange rate the network itself uses, or the current network fee schedule. This opens that. List the consensus nodes with their node id, account, operator description (e.g. \"Hosted by Google | US\"), current and min/max stake in HBAR, rewarded vs not-rewarded stake and whether they decline rewards; read the live HBAR↔USD rate the network pins for fee calculation — current and next period, with a derived USD-per-HBAR price — the protocol's own oracle rate, not a market ticker; and read the current network gas fee schedule per transaction type. Stake is reported in HBAR (1 HBAR = 100,000,000 tinybars). The network / validator / economics layer for Hedera explorers, staking dashboards, wallets and analytics. Distinct from the Hedera on-chain reader (account / token / supply), the HCS topic reader and the HTS token browser. Live from the mirror node; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hederanetwork-api","description":"oanor gateway"}],"tags":[{"name":"Nodes"},{"name":"Rate"},{"name":"Fees"},{"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/nodes":{"get":{"operationId":"get_v1_nodes","tags":["Nodes"],"summary":"List the council consensus nodes","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Hedera council-operated consensus nodes — each with its node id, account, operator description (e.g. 'Hosted by Google | US'), current and min/max stake in HBAR, rewarded vs not-rewarded stake and whether it declines rewards. Hedera is a permissioned proof-of-stake network; this is its validator set. Paginate with limit.","count":25,"nodes":[{"node_id":0,"stake_hbar":450000000,"description":"Hosted by LG | Singapore","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.3","reward_rate_start":3376,"stake_rewarded_hbar":719416707,"stake_not_rewarded_hbar":1090786},{"node_id":1,"stake_hbar":450000000,"description":"Hosted by Swirlds | Iowa, USA","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.4","reward_rate_start":4808,"stake_rewarded_hbar":505295668,"stake_not_rewarded_hbar":19575},{"node_id":4,"stake_hbar":450000000,"description":"Hosted by Nomura | Tokyo, Japan","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.7","reward_rate_start":5399,"stake_rewarded_hbar":320596263,"stake_not_rewarded_hbar":234068690},{"node_id":5,"stake_hbar":450000000,"description":"Hosted by Google | Helsinki, Finland","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.8","reward_rate_start":4344,"stake_rewarded_hbar":558973316,"stake_not_rewarded_hbar":38797},{"node_id":6,"stake_hbar":450000000,"description":"Hosted by Zain Group | Kuwait City, Kuwait","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.9","reward_rate_start":5399,"stake_rewarded_hbar":116885126,"stake_not_rewarded_hbar":340608413},{"node_id":7,"stake_hbar":417961789,"description":"Hosted by Magalu | Sao Paulo, Brazil","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.10","reward_rate_start":5399,"stake_rewarded_hbar":239225708,"stake_not_rewarded_hbar":178736081},{"node_id":9,"stake_hbar":450000000,"description":"Hosted by DLA Piper | Helsinki, Finland","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.12","reward_rate_start":5399,"stake_rewarded_hbar":181840619,"stake_not_rewarded_hbar":342728332},{"node_id":10,"stake_hbar":450000000,"description":"Hosted by Tata Communications | Frankfurt, Germany","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.13","reward_rate_start":5399,"stake_rewarded_hbar":208551892,"stake_not_rewarded_hbar":380393193},{"node_id":11,"stake_hbar":450000000,"description":"Hosted by IBM | Texas, USA","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.14","reward_rate_start":5399,"stake_rewarded_hbar":444835636,"stake_not_rewarded_hbar":194355599},{"node_id":12,"stake_hbar":450000000,"description":"Hosted by Deutsche Telekom | Berlin, Germany","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.15","reward_rate_start":5399,"stake_rewarded_hbar":173138999,"stake_not_rewarded_hbar":385564213},{"node_id":15,"stake_hbar":447692676,"description":"Hosted by Dentons | Roubaix, France","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.18","reward_rate_start":5399,"stake_rewarded_hbar":75707299,"stake_not_rewarded_hbar":371985377},{"node_id":17,"stake_hbar":450000000,"description":"Hosted by Australian Payments Plus | Sydney, Australia","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.20","reward_rate_start":5399,"stake_rewarded_hbar":127980186,"stake_not_rewarded_hbar":620063248},{"node_id":18,"stake_hbar":443441142,"description":"Hosted by EDF | Paris, France","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.21","reward_rate_start":5399,"stake_rewarded_hbar":339693609,"stake_not_rewarded_hbar":103747533},{"node_id":19,"stake_hbar":450000000,"description":"Hosted by Shinhan Bank | London, UK","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.22","reward_rate_start":5399,"stake_rewarded_hbar":53351096,"stake_not_rewarded_hbar":645699380},{"node_id":20,"stake_hbar":450000000,"description":"Hosted by Chainlink Labs | Michigan, USA","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.23","reward_rate_start":2767,"stake_rewarded_hbar":879496193,"stake_not_rewarded_hbar":5371434},{"node_id":21,"stake_hbar":450000000,"description":"Hosted by LSE | Falkenstein, Germany","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.24","reward_rate_start":5399,"stake_rewarded_hbar":106399642,"stake_not_rewarded_hbar":358143312},{"node_id":22,"stake_hbar":434953450,"description":"Hosted by IIT Madras | Naaldwijk, Netherlands","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.25","reward_rate_start":5399,"stake_rewarded_hbar":123585270,"stake_not_rewarded_hbar":311368180},{"node_id":25,"stake_hbar":442936721,"description":"Hosted by Ubisoft | Quebec, Canada","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.28","reward_rate_start":5399,"stake_rewarded_hbar":123560299,"stake_not_rewarded_hbar":319376422},{"node_id":26,"stake_hbar":423891567,"description":"Hosted by Aberdeen Investments | London, UK","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.29","reward_rate_start":5399,"stake_rewarded_hbar":316477192,"stake_not_rewarded_hbar":107414375},{"node_id":30,"stake_hbar":427692377,"description":"Hosted by Mondelēz International | Mumbai, India","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.33","reward_rate_start":5399,"stake_rewarded_hbar":85692412,"stake_not_rewarded_hbar":341999965},{"node_id":31,"stake_hbar":450000000,"description":"Hosted by BitGo | Stockholm, Sweden","decline_reward":true,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.34","reward_rate_start":5399,"stake_rewarded_hbar":274177714,"stake_not_rewarded_hbar":303517922},{"node_id":32,"stake_hbar":446690252,"description":"Hosted by Arrow Electronics | Virginia, USA","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.35","reward_rate_start":5399,"stake_rewarded_hbar":172720552,"stake_not_rewarded_hbar":273969700},{"node_id":33,"stake_hbar":361900023,"description":"Hosted by Nairobi Securities Exchange | London, UK","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.36","reward_rate_start":5399,"stake_rewarded_hbar":161899592,"stake_not_rewarded_hbar":200000431},{"node_id":34,"stake_hbar":437271214,"description":"Hosted by Blockchain for Energy | Helsinki, Finland","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.37","reward_rate_start":5399,"stake_rewarded_hbar":318890571,"stake_not_rewarded_hbar":118380643},{"node_id":35,"stake_hbar":444374291,"description":"Hosted by Repsol | La Rioja, Spain","decline_reward":false,"max_stake_hbar":450000000,"min_stake_hbar":0,"node_account_id":"0.0.38","reward_rate_start":5399,"stake_rewarded_hbar":49374292,"stake_not_rewarded_hbar":394999999}],"source":"Hedera Mirror Node"},"meta":{"timestamp":"2026-06-14T17:04:01.418Z","request_id":"f45ec7e9-9265-4309-96cb-15b12f9b1de0"},"status":"ok","message":"Nodes 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/exchangerate":{"get":{"operationId":"get_v1_exchangerate","tags":["Rate"],"summary":"The network HBAR/USD rate (current + next)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"next":{"usd_per_hbar":0.07739433333333333,"cent_equivalent":232183,"expiration_time":1781463600,"hbar_equivalent":30000},"note":"The live HBAR↔USD exchange rate the Hedera network itself pins for fee calculation — the current and next period each as a cent/HBAR pair, plus a derived USD-per-HBAR price. This is the protocol's own oracle rate, not a market ticker.","source":"Hedera Mirror Node","current":{"usd_per_hbar":0.077422,"cent_equivalent":232266,"expiration_time":1781460000,"hbar_equivalent":30000},"timestamp":"1781456458.975673387"},"meta":{"timestamp":"2026-06-14T17:04:01.538Z","request_id":"3fdecb8f-5aef-49cb-9d8d-411c19884e39"},"status":"ok","message":"Exchange rate 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/fees":{"get":{"operationId":"get_v1_fees","tags":["Fees"],"summary":"The current network gas fee schedule","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fees":[{"gas":110,"transaction_type":"ContractCall"},{"gas":110,"transaction_type":"ContractCreate"},{"gas":110,"transaction_type":"EthereumTransaction"}],"note":"The current Hedera network fee schedule — the gas cost per transaction type (ContractCall, ContractCreate, EthereumTransaction, …) the network charges right now. Combine with the exchange rate to price transactions in USD.","count":3,"source":"Hedera Mirror Node","timestamp":"1781110800.597255900"},"meta":{"timestamp":"2026-06-14T17:04:01.687Z","request_id":"3ce14454-c42b-4934-b8f1-d9fac2f6feb1"},"status":"ok","message":"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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"usd_per_hbar":0.077422},"source":"public Hedera Mirror Node (mainnet-public.mirrornode.hedera.com), keyless","service":"hederanetwork-api","endpoints":{"GET /v1/fees":"The current network gas fee schedule per transaction type.","GET /v1/meta":"This document.","GET /v1/nodes":"The council consensus nodes: account, description, stake, rewards (limit).","GET /v1/exchangerate":"The network's HBAR/USD rate, current + next, with derived USD price."},"description":"Read Hedera's network layer live from the public Hedera Mirror Node: list the council-operated consensus nodes with stake and reward settings, read the live HBAR/USD exchange rate the network pins for fees, and read the current network gas fee schedule. The validator / network / economics layer for Hedera explorers, staking dashboards and analytics. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:04:01.777Z","request_id":"7b8a39ef-e5c0-4df1-b278-74d360de93fc"},"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":8400,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":790,"monthly_call_quota":164000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2720,"monthly_call_quota":880000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":8050,"monthly_call_quota":5300000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hederanetwork-api"}