{"openapi":"3.1.0","info":{"title":"Hive Engine API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hiveengine-api","description":"oanor gateway"}],"tags":[{"name":"Token"},{"name":"Market"},{"name":"Holders"},{"name":"Trades"},{"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/token":{"get":{"operationId":"get_v1_token","tags":["Token"],"summary":"Token registry record","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Hive-Engine token symbol","schema":{"type":"string"},"example":"LEO"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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/market":{"get":{"operationId":"get_v1_market","tags":["Market"],"summary":"Live DEX market metrics in HIVE","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Hive-Engine token symbol","schema":{"type":"string"},"example":"LEO"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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/richlist":{"get":{"operationId":"get_v1_richlist","tags":["Holders"],"summary":"Largest holders with stake and delegations","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Hive-Engine token symbol","schema":{"type":"string"},"example":"LEO"},{"name":"limit","in":"query","required":false,"description":"Max holders (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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":0},{"rank":6,"stake":2832.422,"account":"shadowspub","balance":0.5,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":7,"stake":0,"account":"neal.leo","balance":0,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":8,"stake":0,"account":"wildhomesteading","balance":4.815,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":9,"stake":411.92,"account":"raserrano","balance":0.114,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":10,"stake":0,"account":"kamlesh","balance":0,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":11,"stake":0,"account":"tarekadam","balance":5.927,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":12,"stake":15500,"account":"ahmadmanga","balance":1403.594,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":13,"stake":0,"account":"roger.remix","balance":54.746,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":14,"stake":0,"account":"gtg","balance":6.303,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":15,"stake":80.249,"account":"gorayii","balance":9656.419,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":16,"stake":31094.576,"account":"neoxian","balance":24.207,"delegations_in":0,"delegations_out":6000,"pending_unstake":0},{"rank":17,"stake":4059.525,"account":"sgt-dan","balance":14.494,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":18,"stake":0,"account":"kubbyelizabeth","balance":30233.554,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":19,"stake":0,"account":"aniestudio","balance":0,"delegations_in":0,"delegations_out":0,"pending_unstake":0},{"rank":20,"stake":0,"account":"dlease","balance":284.251,"delegations_in":0,"delegations_out":0,"pending_unstake":0}]},"meta":{"timestamp":"2026-06-11T16:46:59.533Z","request_id":"6a06b45a-d13d-444a-9189-7b396c7a4d2b"},"status":"ok","message":"Richlist 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/trades":{"get":{"operationId":"get_v1_trades","tags":["Trades"],"summary":"Most recent fills on the HIVE market","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Hive-Engine token symbol","schema":{"type":"string"},"example":"LEO"},{"name":"limit","in":"query","required":false,"description":"Max trades (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"seller":"mister-omortson","quantity":12.447,"timestamp":"2026-06-10T20:47:09.000Z","volume_hive":2.2443518}]},"meta":{"timestamp":"2026-06-11T16:46:59.665Z","request_id":"3e9ed984-2385-4493-92c8-5e596ff640cd"},"status":"ok","message":"Trades 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":"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-sidechain / on-chain-DEX view — per-token supply, holders and internal market — distinct from the single-venue exchange tickers, cross-exchange coin-markets and base-chain on-chain APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-11T16:46:59.782Z","request_id":"98ed715c-7224-4ff0-bf26-1ae22899507e"},"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":12500,"rps_limit":3,"hard_limit":true},{"slug":"trader","name":"Trader","price_cents_month":745,"monthly_call_quota":165000,"rps_limit":12,"hard_limit":true},{"slug":"growth","name":"Growth","price_cents_month":2240,"monthly_call_quota":720000,"rps_limit":30,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5330,"monthly_call_quota":2600000,"rps_limit":65,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hiveengine-api"}