# Hyperliquid Perps DEX API > Live data from Hyperliquid — the leading on-chain perpetual-futures and spot DEX, running its own L1 order book — served from its public info API as clean JSON, no cache. Get every perpetual market with its mark, oracle and mid price, hourly funding rate (and the annualised rate), open interest in both base units and USD, 24h volume, 24h change and maximum leverage (sorted by volume); pull one perpetual market's full state by coin; list the spot markets with price, 24h volume and circulating supply; or read exchange-wide totals — open interest, 24h volume and market counts. Read live from Hyperliquid, nothing cached. This is Hyperliquid's own on-chain perps order-book, funding-rate and open-interest layer — distinct from centralised-exchange tickers, aggregate derivatives feeds and generic price APIs: the live data of the biggest decentralised perpetuals venue. ## 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/hyperliquid-api/..." ``` ## Pricing - **Free** (Free) — 1,000 calls/Mo, 3 req/s - **Starter** ($11/Mo) — 35,000 calls/Mo, 12 req/s - **Pro** ($31/Mo) — 180,000 calls/Mo, 28 req/s - **Business** ($73/Mo) — 920,000 calls/Mo, 55 req/s ## Endpoints ### Perps #### `GET /v1/perps` — Every perp market with mark price, funding, open interest, volume, leverage **Parameters:** - `limit` (query, optional, string) — Max markets (1-500) Example: `100` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hyperliquid-api/v1/perps?limit=100" ``` **Response:** ```json { "data": { "count": 100, "perps": [ { "coin": "BTC", "premium": -0.0002978807, "mid_price": 61406.5, "mark_price": 61405, "max_leverage": 40, "oracle_price": 61434, "open_interest": 31343.72984, "day_change_pct": -0.4604, "day_volume_usd": 2981716382.68, "funding_hourly": 6.7352e-6, "funding_apr_pct": 5.9, "open_interest_usd": 1924661730.83 }, { "coin": "ETH", "premium": -0.0006795997, "mid_price": 1617.45, "mark_price": 1617.5, "max_leverage": 25, "oracle_price": 1618.6, "open_interest": 732605.857, "day_change_pct": -1.3058, "day_volume_usd": 1368096459.95, "funding_hourly": -1.7921e-6, "funding_apr_pct": -1.5699, "open_interest_usd": 1184989973.7 }, { "coin": "HYPE", "premium": 0.0007680492, "mid_price": 53.4235, "mark_price": 53.424, "max_leverage": 10, "oracle_price": 53.382, "open_interest": 20340134.5, "day_change_pct": -7.2275, "day_volume_usd": 901465794.32, …(truncated, see openapi.json for full schema) ``` ### Perp #### `GET /v1/perp` — One perpetual market's full state by coin **Parameters:** - `coin` (query, required, string) — Perp symbol Example: `BTC` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hyperliquid-api/v1/perp?coin=BTC" ``` **Response:** ```json { "data": { "coin": "BTC", "source": "Hyperliquid", "premium": -0.0003043818, "mid_price": 61407.5, "mark_price": 61408, "max_leverage": 40, "oracle_price": 61436, "open_interest": 31343.72984, "day_change_pct": -0.4555, "day_volume_usd": 2981716382.68, "funding_hourly": 6.7352e-6, "funding_apr_pct": 5.9, "open_interest_usd": 1924755762.01 }, "meta": { "timestamp": "2026-06-10T22:58:03.311Z", "request_id": "d2d15d79-267f-416c-9632-0f11d79667dd" }, "status": "ok", "message": "Perp retrieved successfully", "success": true } ``` ### Spot #### `GET /v1/spot` — Spot markets with price, 24h volume and circulating supply **Parameters:** - `limit` (query, optional, string) — Max markets (1-500) Example: `100` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hyperliquid-api/v1/spot?limit=100" ``` **Response:** ```json { "data": { "count": 100, "source": "Hyperliquid", "markets": [ { "market": "@107", "mid_price": 53.394, "mark_price": 53.4, "day_change_pct": -7.319, "day_volume_usd": 145783143.59, "circulating_supply": 298734611.2679351 }, { "market": "@142", "mid_price": 61392.5, "mark_price": 61392, "day_change_pct": -0.4782, "day_volume_usd": 27562634.7, "circulating_supply": 20999999.99752684 }, { "market": "@272", "mid_price": 407.35, "mark_price": 407.22, "day_change_pct": -4.3748, "day_volume_usd": 6469080.04, "circulating_supply": 20999999.995293822 }, { "market": "@151", "mid_price": 1617.05, "mark_price": 1617, "day_change_pct": -1.3603, "day_volume_usd": 5887570.04, "circulating_supply": 99999999.9779318 }, { "market": "@230", "mid_price": 1.00005, "mark_price": 1, "day_change_pct": 0, "day_volume_usd": 4947175.32, "circulating_supply": 99999994949.55869 }, …(truncated, see openapi.json for full schema) ``` ### Stats #### `GET /v1/stats` — Exchange-wide open interest, 24h volume and market counts **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hyperliquid-api/v1/stats" ``` **Response:** ```json { "data": { "source": "Hyperliquid", "perp_market_count": 230, "total_day_volume_usd": 6187638345.99, "total_open_interest_usd": 5647997113.35 }, "meta": { "timestamp": "2026-06-10T22:58:05.142Z", "request_id": "0822b78e-ec62-41ac-8c4b-d8d21a38fc83" }, "status": "ok", "message": "Stats retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/hyperliquid-api/v1/meta" ``` **Response:** ```json { "data": { "source": "Hyperliquid info API (api.hyperliquid.xyz, live)", "service": "hyperliquid-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/perp": "One perpetual market's full state by coin (coin=BTC).", "GET /v1/spot": "Spot markets with price, 24h volume and circulating supply (limit=100).", "GET /v1/perps": "Every perp market with mark price, funding, open interest, 24h volume, leverage (limit=100).", "GET /v1/stats": "Exchange-wide open interest, 24h volume and market counts." }, "description": "Live data from Hyperliquid, the leading on-chain perpetual-futures and spot DEX (its own L1 order book), via its public info API. The perps endpoint returns every perpetual market with mark/oracle/mid price, hourly funding rate (and annualised), open interest (base and USD), 24h volume, 24h change and max leverage, sorted by volume; the perp endpoint returns one perpetual market by coin; the spot endpoint returns the spot markets with price, 24h volume and circulating supply; the stats endpoint returns exchange-wide open interest, 24h volume and market counts. Live, no key, nothing stored. Distinct from centralised-exchange tickers, aggregate derivatives feeds and price APIs — this is Hyperliquid's own on-chain perps order-book, funding and open-interest layer.", "upstream_status": "ok", "perp_market_count": 230 }, "meta": { …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/hyperliquid-api OpenAPI spec: https://www.oanor.com/api/hyperliquid-api/openapi.json