{"openapi":"3.1.0","info":{"title":"Paradex Perps & Options DEX API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/paradex-api","description":"oanor gateway"}],"tags":[{"name":"Markets"},{"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/markets":{"get":{"operationId":"get_v1_markets","tags":["Markets"],"summary":"List instruments (perps, options, spot)","description":"","parameters":[{"name":"kind","in":"query","required":false,"description":"Filter: perp, option or spot","schema":{"type":"string"},"example":"perp"},{"name":"base","in":"query","required":false,"description":"Filter by base currency","schema":{"type":"string"},"example":"BTC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"venue":"paradex","markets":[{"symbol":"BTC-USD-PERP","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}}}},"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/orderbook":{"get":{"operationId":"get_v1_orderbook","tags":["Markets"],"summary":"Live order book for a market","description":"","parameters":[{"name":"market","in":"query","required":true,"description":"Market symbol","schema":{"type":"string"},"example":"BTC-USD-PERP"},{"name":"depth","in":"query","required":false,"description":"Levels (1-100)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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/summary":{"get":{"operationId":"get_v1_summary","tags":["Markets"],"summary":"Per-market summary (mark price, funding, OI, IV & greeks)","description":"","parameters":[{"name":"market","in":"query","required":false,"description":"Market symbol or ALL","schema":{"type":"string"},"example":"BTC-USD-PERP"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ask":65976.5,"bid":65970.5,"greeks":{"vega":0,"delta":1.00067232211412,"gamma":0},"symbol":"BTC-USD-PERP","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}}}},"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":["Markets"],"summary":"Recent public trades for a market","description":"","parameters":[{"name":"market","in":"query","required":true,"description":"Market symbol","schema":{"type":"string"},"example":"ETH-USD-PERP"},{"name":"limit","in":"query","required":false,"description":"Number of trades (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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":"1781522142650201709237990004","side":"SELL","size":2.3997,"price":1741,"created_at":1781522142662},{"id":"1781522134970201709237990001","side":"SELL","size":0.0233,"price":1740.33,"created_at":1781522134977},{"id":"1781522133940201709237990007","side":"BUY","size":0.0233,"price":1740.31,"created_at":1781522133952},{"id":"1781522078340201709237990001","side":"BUY","size":0.0086,"price":1740.43,"created_at":1781522078346},{"id":"1781521926800201709237990002","side":"SELL","size":0.7226,"price":1739.2,"created_at":1781521926813},{"id":"1781521926800201709237990001","side":"SELL","size":0.2774,"price":1739.25,"created_at":1781521926813},{"id":"1781521912290201709237990004","side":"SELL","size":0.1494,"price":1739.97,"created_at":1781521912296},{"id":"1781521912290201709237990003","side":"SELL","size":1.1067,"price":1740.03,"created_at":1781521912296},{"id":"1781521911060201709237990002","side":"BUY","size":0.1494,"price":1740.13,"created_at":1781521911068},{"id":"1781521911060201709237990001","side":"BUY","size":1.1067,"price":1740.07,"created_at":1781521911068},{"id":"1781521687210201709237990002","side":"SELL","size":0.0074,"price":1739.56,"created_at":1781521687224},{"id":"1781521686200201709237990003","side":"BUY","size":0.0074,"price":1739.92,"created_at":1781521686213},{"id":"1781521631660201709237990004","side":"BUY","size":1.762,"price":1738,"created_at":1781521631674},{"id":"1781521631660201709237990003","side":"BUY","size":0.3651,"price":1738,"created_at":1781521631674},{"id":"1781521262050201709237990003","side":"SELL","size":1.1067,"price":1736.66,"created_at":1781521262062},{"id":"1781521261010201709237990001","side":"BUY","size":1.1067,"price":1736.57,"created_at":1781521261021},{"id":"1781521210420201709237990016","side":"BUY","size":0.7894,"price":1736.36,"created_at":1781521210429},{"id":"1781521210420201709237990015","side":"BUY","size":1.0423,"price":1736.31,"created_at":1781521210429},{"id":"1781521209400201709237990005","side":"SELL","size":0.7894,"price":1736.22,"created_at":1781521209413}]},"meta":{"timestamp":"2026-06-15T11:16:01.917Z","request_id":"95f29c05-ef57-44d8-80c7-3f0be6b39511"},"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":"Venue metadata & endpoint guide","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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":2200,"rps_limit":4,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1950,"monthly_call_quota":62000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5480,"monthly_call_quota":245000,"rps_limit":25,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":11940,"monthly_call_quota":980000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/paradex-api"}