# Hive Witnesses & Consensus API > The Hive blockchain's delegated-proof-of-stake consensus — the witness election — live from the public Hive RPC nodes, no key, nothing cached. Hive is secured by 20 elected witnesses plus a rotating backup, voted in by HIVE holders with their staked (vested) weight; witnesses produce the blocks, publish the HBD price feed and set the chain parameters. The Hive content reader covers accounts, posts and communities, but not the witness consensus; this opens it. Rank the witnesses by vote weight, each with its vote total converted to HIVE Power, missed block count, running node version, published HBD price feed and the chain parameters it sets. Look up a single witness by account for its votes, rank and production. And read a live network overview — the head block, the current witness producing it, witness participation over the last 128 slots, the total vesting (staking) fund and the HIVE-per-MVESTS rate. The consensus-and-governance layer for Hive wallets, witness dashboards, voters and analytics. Live from api.hive.blog and peer nodes. ## 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/hivewitness-api/..." ``` ## Pricing - **Free** (Free) — 7,250 calls/Mo, 3 req/s - **Starter** ($10/Mo) — 143,000 calls/Mo, 9 req/s - **Pro** ($33/Mo) — 795,000 calls/Mo, 22 req/s - **Business** ($92/Mo) — 5,200,000 calls/Mo, 55 req/s ## Endpoints ### Witnesses #### `GET /v1/witness` — One witness by account: votes, rank, missed, parameters **Parameters:** - `account` (query, optional, string) — Hive witness account (omit for the top witness) Example: `blocktrades` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hivewitness-api/v1/witness?account=blocktrades" ``` **Response:** ```json { "data": { "url": "https://blocktrades.us", "note": "A single Hive witness: its vote weight (in HIVE Power), rank, missed blocks, node version, published HBD price feed and the chain parameters it sets. Omit account for the top witness.", "rank": 7, "owner": "blocktrades", "source": "Hive RPC", "created": "2016-03-30T00:04:33", "votes_hp": 96800208, "is_active": true, "last_block": 107270473, "votes_vests": 157048441862.97507, "total_missed": 3730, "price_feed_hbd": 0.049, "running_version": "1.28.3", "hbd_interest_rate": 1200, "maximum_block_size": 65536, "account_creation_fee": "3.000 HIVE" }, "meta": { "timestamp": "2026-06-14T17:04:37.156Z", "request_id": "d4621521-760c-4fb2-87c6-00200649b473" }, "status": "ok", "message": "Witness retrieved successfully", "success": true } ``` #### `GET /v1/witnesses` — Witnesses ranked by vote weight, with HP, missed blocks, version, price feed **Parameters:** - `limit` (query, optional, string) — Max witnesses (1-100) Example: `21` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hivewitness-api/v1/witnesses?limit=21" ``` **Response:** ```json { "data": { "note": "Hive witnesses ranked by vote weight. The top 20 (plus a rotating backup) produce blocks. votes_hp is the staked HIVE Power backing the witness; total_missed counts skipped block slots; price_feed_hbd is the witness's published HBD price.", "count": 21, "source": "Hive RPC", "witnesses": [ { "url": "https://hive.blog/hive-174578/@ocd/original-content-decentralized-hive-statement", "rank": 1, "owner": "ocd-witness", "votes_hp": 100522708, "is_active": true, "last_block": 107270471, "votes_vests": 163087817149.97232, "total_missed": 1381, "price_feed_hbd": 0.049, "running_version": "1.28.3", "hbd_interest_rate": 1200, "maximum_block_size": 65536, "account_creation_fee": "3.000 HIVE" }, { "url": "https://gtg.openhive.network", "rank": 2, "owner": "gtg", "votes_hp": 99926055, "is_active": true, "last_block": 107270462, "votes_vests": 162119808506.45044, "total_missed": 989, "price_feed_hbd": 0.049, "running_version": "1.28.3", "hbd_interest_rate": 1000, "maximum_block_size": 65536, …(truncated, see openapi.json for full schema) ``` ### Network #### `GET /v1/network` — Live consensus overview: head block, current witness, participation, vesting fund **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hivewitness-api/v1/network" ``` **Response:** ```json { "data": { "note": "Live Hive consensus overview: the head block, the witness producing it, witness participation over the last 128 slots, the total vesting (staking) fund and the HIVE-per-MVESTS rate used to value witness votes.", "source": "Hive RPC", "hp_per_mvest": 616.372, "current_supply": "554077461.964 HIVE", "hbd_print_rate": 0, "current_witness": "smooth.witness", "head_block_number": 107270475, "current_hbd_supply": "32822094.202 HBD", "total_vesting_shares": 341214804515.7273, "total_vesting_fund_hive": 210315133.784, "witness_participation_pct": 100 }, "meta": { "timestamp": "2026-06-14T17:04:37.451Z", "request_id": "119a7493-c881-4734-9c75-4c863f932603" }, "status": "ok", "message": "Network retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hivewitness-api/v1/meta" ``` **Response:** ```json { "data": { "sample": { "votes_hp": 100522708, "top_witness": "ocd-witness" }, "source": "public Hive RPC nodes (api.hive.blog and peers), keyless", "service": "hivewitness-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/network": "Live consensus overview: head block, current witness, participation, vesting fund.", "GET /v1/witness": "One witness by account: votes, rank, missed, parameters (account; omit for top).", "GET /v1/witnesses": "Witnesses ranked by vote weight, with HP, missed blocks, version, price feed (limit)." }, "description": "Read the Hive blockchain's delegated-proof-of-stake consensus live from the public Hive RPC nodes: rank witnesses by vote weight (in HIVE Power) with their missed blocks, node version, price feed and chain parameters; look up a single witness by account; and read a live network overview (head block, current witness, participation, vesting fund). The consensus-and-governance layer for Hive wallets, witness dashboards and voters. Live, short cache only.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-14T17:04:37.645Z", "request_id": "d986e819-55e3-4358-a664-6fcaf0551c89" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/hivewitness-api OpenAPI spec: https://www.oanor.com/api/hivewitness-api/openapi.json