# Paradex Perps & Options DEX API > Live market data for Paradex, the Starknet-appchain perpetuals and options DEX, with no key. List every instrument (perpetual futures, dated options and spot) with full contract specs; pull a per-market summary with mark price, 24h volume, open interest, funding rate and — for options — implied volatility and full greeks (delta, gamma, vega, theta); read the live order book; and stream recent public trades. Paradex is one of the few venues exposing on-chain options greeks over a keyless feed — ideal for derivatives dashboards and options analytics. ## 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/paradex-api/..." ``` ## Pricing - **Free** (Free) — 2,200 calls/Mo, 4 req/s - **Basic** ($20/Mo) — 62,000 calls/Mo, 10 req/s - **Pro** ($55/Mo) — 245,000 calls/Mo, 25 req/s - **Business** ($119/Mo) — 980,000 calls/Mo, 60 req/s ## Endpoints ### Markets #### `GET /v1/markets` — List instruments (perps, options, spot) **Parameters:** - `kind` (query, optional, string) — Filter: perp, option or spot Example: `perp` - `base` (query, optional, string) — Filter by base currency Example: `BTC` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/paradex-api/v1/markets?kind=perp&base=BTC" ``` **Response:** ```json { "data": { "count": 1, "venue": "paradex", "markets": [ { "symbol": "BTC-USD-PERP", "expiry_at": null, "asset_kind": "PERP", "min_notional": 10, "base_currency": "BTC", "quote_currency": "USD", "price_tick_size": 0.1, "max_funding_rate": 0.02, "settlement_currency": "USDC", "order_size_increment": 1.0e-5 } ] }, "meta": { "timestamp": "2026-06-15T11:16:00.880Z", "request_id": "a65a6f10-698f-4cc1-86af-8eafbd4c8fc8" }, "status": "ok", "message": "Markets retrieved successfully", "success": true } ``` #### `GET /v1/orderbook` — Live order book for a market **Parameters:** - `market` (query, required, string) — Market symbol Example: `BTC-USD-PERP` - `depth` (query, optional, string) — Levels (1-100) Example: `5` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/paradex-api/v1/orderbook?market=BTC-USD-PERP&depth=5" ``` **Response:** ```json { "data": { "asks": [ { "size": 0.03062, "price": 65994.9 }, { "size": 0.03062, "price": 66000.3 }, { "size": 0.03062, "price": 66005.6 }, { "size": 0.0419, "price": 66007 }, { "size": 0.04191, "price": 66008.2 } ], "bids": [ { "size": 0.03062, "price": 65975.6 }, { "size": 0.03062, "price": 65970.2 }, { "size": 0.03062, "price": 65964.9 }, { "size": 0.0419, "price": 65963.5 }, { "size": 0.04655, "price": 65961.1 } ], "market": "BTC-USD-PERP", "seq_no": 7517437872, "last_updated_at": 1781522161037 }, "meta": { "timestamp": "2026-06-15T11:16:01.228Z", "request_id": "fedf42aa-79ee-42c7-a8de-46dac93868b0" }, "status": "ok", "message": "Order book retrieved successfully", "success": true } ``` #### `GET /v1/summary` — Per-market summary (mark price, funding, OI, IV & greeks) **Parameters:** - `market` (query, optional, string) — Market symbol or ALL Example: `BTC-USD-PERP` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/paradex-api/v1/summary?market=BTC-USD-PERP" ``` **Response:** ```json { "data": { "ask": 65976.5, "bid": 65970.5, "greeks": { "rho": null, "vega": 0, "delta": 1.00067232211412, "gamma": 0, "theta": null }, "symbol": "BTC-USD-PERP", "mark_iv": null, "ask_size": 0.09126, "bid_size": 0.10105, "mark_price": 65972.54966451, "volume_24h": 3153264.475873, "funding_rate": 0.00012576446032, "total_volume": 133432831651.81215, "open_interest": 98.45794, "underlying_price": 65928.22466113, "last_traded_price": 65970.6, "price_change_rate_24h": 0.021382 }, "meta": { "timestamp": "2026-06-15T11:16:01.570Z", "request_id": "c6346d9c-b847-4407-a5ad-96fbf943b5af" }, "status": "ok", "message": "Summary retrieved successfully", "success": true } ``` #### `GET /v1/trades` — Recent public trades for a market **Parameters:** - `market` (query, required, string) — Market symbol Example: `ETH-USD-PERP` - `limit` (query, optional, string) — Number of trades (1-100) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/paradex-api/v1/trades?market=ETH-USD-PERP&limit=25" ``` **Response:** ```json { "data": { "count": 25, "market": "ETH-USD-PERP", "trades": [ { "id": "1781522149960201709237990004", "side": "SELL", "size": 0.4297, "price": 1740.54, "created_at": 1781522149965 }, { "id": "1781522149960201709237990002", "side": "BUY", "size": 0.4297, "price": 1740.4, "created_at": 1781522149965 }, { "id": "1781522143650201709237990004", "side": "BUY", "size": 5.5152, "price": 1741.27, "created_at": 1781522143662 }, { "id": "1781522143650201709237990003", "side": "BUY", "size": 0.2302, "price": 1741.23, "created_at": 1781522143662 }, { "id": "1781522142650201709237990006", "side": "SELL", "size": 2.239, "price": 1740.94, "created_at": 1781522142662 }, { "id": "1781522142650201709237990005", "side": "SELL", "size": 1.1067, "price": 1740.99, "created_at": 1781522142662 }, { "id": "178152214265020170923799000 …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Venue metadata & endpoint guide **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/paradex-api/v1/meta" ``` **Response:** ```json { "data": { "chain": "Starknet appchain", "venue": "Paradex", "source": "Paradex public REST (api.prod.paradex.trade/v1), keyless", "examples": { "trades": "/v1/trades?market=ETH-USD-PERP&limit=10", "markets": "/v1/markets?kind=perp", "summary": "/v1/summary?market=BTC-USD-PERP", "orderbook": "/v1/orderbook?market=BTC-USD-PERP&depth=5" }, "endpoints": { "/v1/trades": "recent public trades for a market (market, limit)", "/v1/markets": "list instruments (filter kind=perp|option|spot, base=BTC)", "/v1/summary": "per-market summary: mark price, funding, open interest, 24h volume, IV & greeks (market=BTC-USD-PERP or ALL)", "/v1/orderbook": "live order book for a market (market, depth)" }, "asset_kinds": [ "PERP", "OPTION", "SPOT" ], "cache_ttl_ms": 5000 }, "meta": { "timestamp": "2026-06-15T11:16:02.004Z", "request_id": "81357dd0-c523-47fd-91b0-75c595bf1872" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/paradex-api OpenAPI spec: https://www.oanor.com/api/paradex-api/openapi.json