# Hive Engine API > Live data from the Hive-Engine smart-contract sidechain — a Layer-2 token registry and decentralized exchange built on the Hive blockchain. Look up any Hive-Engine token's on-chain registry record (issuer, precision, max / current / circulating supply, staking status and total staked), read its live DEX market metrics (last price in HIVE, highest bid, lowest ask, 24h volume and the day's price change), pull the richlist of its largest holders with their liquid balance, staked amount and delegations, and stream the most recent fills on its HIVE market (buyer, seller, quantity, price and time). Symbols are Hive-Engine tokens such as LEO, BEE, SWAP.HIVE or SPS; prices and market volume are denominated in HIVE, the base-chain coin. This is the token-sidechain / on-chain-DEX view — per-token supply, holders and an internal order-book market — distinct from the single-venue exchange tickers, the cross-exchange coin-markets and the base-chain on-chain APIs in the catalogue. Live and read straight from a public Hive-Engine RPC node — nothing stored. ## 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/hiveengine-api/..." ``` ## Pricing - **Free** (Free) — 12,500 calls/Mo, 3 req/s - **Trader** ($7/Mo) — 165,000 calls/Mo, 12 req/s - **Growth** ($22/Mo) — 720,000 calls/Mo, 30 req/s - **Scale** ($53/Mo) — 2,600,000 calls/Mo, 65 req/s ## Endpoints ### Token #### `GET /v1/token` — Token registry record **Parameters:** - `symbol` (query, required, string) — Hive-Engine token symbol Example: `LEO` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hiveengine-api/v1/token?symbol=LEO" ``` **Response:** ```json { "data": { "url": "https://inleo.io", "icon": "https://images.hive.blog/DQmTcMRb769g2g5qfbsAVEGumuFj5gmo4oKpnqMQAp6QLNY/image.png?format=match&mode=fit", "name": "Leo", "chain": "Hive-Engine", "issuer": "leo.tokens", "source": "Hive-Engine", "supply": 1000000000, "symbol": "LEO", "precision": 3, "max_supply": 1000000000, "description": "NLEO is building a thriving creator economy that is centered around digital ownership, tokenization and communities. Our flagship application (inleo.io) features a \"twitter-like\" feeling on Web3. The underlying architecture is built entirely on a blockchain, providing users with immutable digital identities.", "total_staked": 13371200.071, "transactions": 4, "staking_enabled": true, "circulating_supply": 29632414.93, "delegation_enabled": true }, "meta": { "timestamp": "2026-06-11T16:46:59.213Z", "request_id": "beb4de02-8dcd-4090-a068-e4b661156eef" }, "status": "ok", "message": "Token retrieved successfully", "success": true } ``` ### Market #### `GET /v1/market` — Live DEX market metrics in HIVE **Parameters:** - `symbol` (query, required, string) — Hive-Engine token symbol Example: `LEO` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hiveengine-api/v1/market?symbol=LEO" ``` **Response:** ```json { "data": { "quote": "HIVE", "source": "Hive-Engine", "symbol": "LEO", "last_price": 0.20699902, "lowest_ask": 0.20699907, "highest_bid": 0.18032177, "last_day_price": 0.18031267, "volume_24h_hive": 5.81429449, "price_change_hive": 0.02668635, "price_change_percent": "14.80%" }, "meta": { "timestamp": "2026-06-11T16:46:59.364Z", "request_id": "8a04848b-1478-46a3-870f-fb6c9ad8c6bf" }, "status": "ok", "message": "Market retrieved successfully", "success": true } ``` ### Holders #### `GET /v1/richlist` — Largest holders with stake and delegations **Parameters:** - `symbol` (query, required, string) — Hive-Engine token symbol Example: `LEO` - `limit` (query, optional, string) — Max holders (1-100) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hiveengine-api/v1/richlist?symbol=LEO&limit=20" ``` **Response:** ```json { "data": { "count": 20, "source": "Hive-Engine", "symbol": "LEO", "holders": [ { "rank": 1, "stake": 291513.636, "account": "khaleelkazi", "balance": 352030.283, "delegations_in": 125.009, "delegations_out": 250000, "pending_unstake": 0 }, { "rank": 2, "stake": 0, "account": "clumsysilverdad", "balance": 1.656, "delegations_in": 0, "delegations_out": 0, "pending_unstake": 0 }, { "rank": 3, "stake": 1181.127, "account": "zekepickleman", "balance": 113.093, "delegations_in": 0, "delegations_out": 0, "pending_unstake": 0 }, { "rank": 4, "stake": 0, "account": "parisfoodhunter", "balance": 6.885, "delegations_in": 0, "delegations_out": 0, "pending_unstake": 0 }, { "rank": 5, "stake": 0, "account": "kashmirz", "balance": 5.913, "delegations_in": 0, "delegations_out": 0, "pending_unstake": …(truncated, see openapi.json for full schema) ``` ### Trades #### `GET /v1/trades` — Most recent fills on the HIVE market **Parameters:** - `symbol` (query, required, string) — Hive-Engine token symbol Example: `LEO` - `limit` (query, optional, string) — Max trades (1-100) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hiveengine-api/v1/trades?symbol=LEO&limit=20" ``` **Response:** ```json { "data": { "count": 5, "quote": "HIVE", "source": "Hive-Engine", "symbol": "LEO", "trades": [ { "type": "buy", "buyer": "hankanon", "price": 0.20699902, "seller": "bamdecs", "quantity": 13.635, "timestamp": "2026-06-11T16:35:39.000Z", "volume_hive": 2.82243164 }, { "type": "buy", "buyer": "hankanon", "price": 0.20699902, "seller": "bamdecs", "quantity": 0.95, "timestamp": "2026-06-11T16:35:39.000Z", "volume_hive": 0.19664907 }, { "type": "sell", "buyer": "bamende", "price": 0.18031621, "seller": "polish.hive", "quantity": 1.523, "timestamp": "2026-06-11T03:04:36.000Z", "volume_hive": 0.27462158 }, { "type": "sell", "buyer": "bamende", "price": 0.18031358, "seller": "thebighigg", "quantity": 1.532, "timestamp": "2026-06-10T22:37:36.000Z", "volume_hive": 0.2762404 }, { "type": "sell", "buyer": "bamende", "price": 0.18031267, …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hiveengine-api/v1/meta" ``` **Response:** ```json { "data": { "note": "symbol is a Hive-Engine token symbol (LEO, BEE, SWAP.HIVE, SPS). Prices and market volume are denominated in HIVE, the base-chain coin. Quantities are on-chain decimals.", "source": "Public Hive-Engine RPC (api.hive-engine.com/rpc, live JSON-RPC over the tokens & market contracts)", "service": "hiveengine-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/token": "Token registry record — issuer, precision, supply, staking (symbol=LEO).", "GET /v1/market": "Live DEX market metrics — last price in HIVE, bid/ask, 24h volume, day change (symbol=LEO).", "GET /v1/trades": "Most recent fills on the token's HIVE market (symbol=LEO, limit=20, max 100).", "GET /v1/richlist": "Largest holders of a token with balance, stake and delegations (symbol=LEO, limit=20, max 100)." }, "description": "Live data from the Hive-Engine smart-contract sidechain (a Layer-2 token registry and decentralized exchange on the Hive blockchain). The token endpoint returns a token's on-chain registry record (issuer, supply, staking); the market endpoint returns its live DEX market metrics (last price in HIVE, bid/ask, 24h volume, day change); the richlist endpoint returns the largest holders with balance, stake and delegations; the trades endpoint returns the most recent fills (buyer, seller, quantity, price, time). Live, no key, nothing stored. The token-sidechai …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/hiveengine-api OpenAPI spec: https://www.oanor.com/api/hiveengine-api/openapi.json