# Hedera Network & Nodes API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/hederanetwork-api/..." ``` ## Pricing - **Free** (Free) — 8,400 calls/Mo, 3 req/s - **Starter** ($8/Mo) — 164,000 calls/Mo, 10 req/s - **Pro** ($27/Mo) — 880,000 calls/Mo, 25 req/s - **Scale** ($81/Mo) — 5,300,000 calls/Mo, 60 req/s ## Endpoints ### Nodes #### `GET /v1/nodes` — List the council consensus nodes **Parameters:** - `limit` (query, optional, string) — Page size (1-100) Example: `30` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hederanetwork-api/v1/nodes?limit=30" ``` **Response:** ```json { "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", …(truncated, see openapi.json for full schema) ``` ### Rate #### `GET /v1/exchangerate` — The network HBAR/USD rate (current + next) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hederanetwork-api/v1/exchangerate" ``` **Response:** ```json { "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 } ``` ### Fees #### `GET /v1/fees` — The current network gas fee schedule **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hederanetwork-api/v1/fees" ``` **Response:** ```json { "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 } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hederanetwork-api/v1/meta" ``` **Response:** ```json { "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 } ``` --- Marketplace page: https://www.oanor.com/api/hederanetwork-api OpenAPI spec: https://www.oanor.com/api/hederanetwork-api/openapi.json