{"openapi":"3.1.0","info":{"title":"edgeX Perpetuals DEX API","version":"1.0.0","description":"Live market data for edgeX, the StarkEx-based perpetuals DEX, with no key. List every perpetual contract with its specs; pull a 24h ticker with last/open/high/low price, percentage change and traded volume; read the live order book at 15 or 200 levels; and get the latest funding rate with the oracle, mark and index prices. Symbols are accepted by human name (BTCUSD, ETHUSD, SOLUSD) and resolved to edgeX contract ids automatically — ideal for derivatives dashboards and funding-rate monitors.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/edgex-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/contracts":{"get":{"operationId":"get_v1_contracts","tags":["Markets"],"summary":"List every perpetual contract with specs","description":"","parameters":[{"name":"base","in":"query","required":false,"description":"Filter by base coin prefix","schema":{"type":"string"},"example":"BTC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"venue":"edgex","contracts":[{"name":"BTCUSD","step_size":0.001,"tick_size":0.1,"contract_id":"10000001","max_leverage":10,"min_order_size":0.003}]},"meta":{"timestamp":"2026-06-15T11:15:59.198Z","request_id":"66e1b5ea-f44d-4901-916c-6cdf2c75e78d"},"status":"ok","message":"Contracts 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/depth":{"get":{"operationId":"get_v1_depth","tags":["Markets"],"summary":"Live order book for a contract","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"edgeX contract name","schema":{"type":"string"},"example":"ETHUSD"},{"name":"level","in":"query","required":false,"description":"Order book levels: 15 or 200","schema":{"type":"string"},"example":"15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"asks":[{"size":0.51,"price":1741.41},{"size":0.29,"price":1741.48},{"size":482.76,"price":1741.55},{"size":154.51,"price":1741.59},{"size":146.09,"price":1741.66},{"size":144.67,"price":1741.7},{"size":0.23,"price":1741.75},{"size":418.48,"price":1741.79},{"size":193.94,"price":1741.86},{"size":123.46,"price":1741.93},{"size":79.37,"price":1741.97},{"size":254.82,"price":1742.02},{"size":0.52,"price":1742.09},{"size":76.63,"price":1742.13},{"size":73.58,"price":1742.2}],"bids":[{"size":345.97,"price":1741.25},{"size":1.5,"price":1741.23},{"size":1.56,"price":1741.22},{"size":248.7,"price":1741.18},{"size":0.93,"price":1741.12},{"size":273.43,"price":1741.05},{"size":861.47,"price":1741.01},{"size":333.1,"price":1740.95},{"size":210.44,"price":1740.9},{"size":222.64,"price":1740.86},{"size":277.12,"price":1740.82},{"size":854.28,"price":1740.78},{"size":223.43,"price":1740.71},{"size":249.24,"price":1740.66},{"size":0.29,"price":1740.62}],"name":"ETHUSD","level":15,"contract_id":"10000002"},"meta":{"timestamp":"2026-06-15T11:15:59.504Z","request_id":"8df72003-0165-4d15-99fd-11702850141d"},"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/funding":{"get":{"operationId":"get_v1_funding","tags":["Markets"],"summary":"Latest funding rate with mark/oracle/index price","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"edgeX contract name","schema":{"type":"string"},"example":"BTCUSD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"BTCUSD","mark_price":65951.95000059903,"contract_id":"10000001","index_price":65934.268332833,"funding_rate":5.0e-5,"funding_time":"1781510400000","oracle_price":65951.95000059903,"funding_timestamp":"1781522100000"},"meta":{"timestamp":"2026-06-15T11:15:59.647Z","request_id":"d9115afc-8b6d-424c-9207-ab1e48359cfb"},"status":"ok","message":"Funding 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/ticker":{"get":{"operationId":"get_v1_ticker","tags":["Markets"],"summary":"24h ticker for a perpetual contract","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"edgeX contract name","schema":{"type":"string"},"example":"BTCUSD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"low":63649.3,"high":65980.5,"last":65947.9,"name":"BTCUSD","open":64528.8,"close":65947.9,"trades":59388,"volume":6292.365,"turnover":409626235.9591,"contract_id":"10000001","index_price":65979.568864727,"funding_rate":5.0e-5,"oracle_price":65971.99500072747,"price_change":1419.1,"price_change_pct":0.021991},"meta":{"timestamp":"2026-06-15T11:15:59.929Z","request_id":"efff5920-e1d5-41da-be13-f17390ebf294"},"status":"ok","message":"Ticker 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":"StarkEx (Ethereum L2)","venue":"edgeX","source":"edgeX public REST (pro.edgex.exchange/api/v1/public), keyless","examples":{"depth":"/v1/depth?symbol=ETHUSD&level=15","ticker":"/v1/ticker?symbol=BTCUSD","funding":"/v1/funding?symbol=BTCUSD","contracts":"/v1/contracts?base=BTC"},"endpoints":{"/v1/depth":"live order book (symbol, level=15 or 200)","/v1/ticker":"24h ticker for a contract: last/open/high/low, change, volume (symbol=BTCUSD)","/v1/funding":"latest funding rate with mark/oracle/index price (symbol=BTCUSD)","/v1/contracts":"list every perpetual contract with specs (filter base=BTC)"},"instrument":"perpetual futures","cache_ttl_ms":5000},"meta":{"timestamp":"2026-06-15T11:16:00.037Z","request_id":"518bc846-3ba8-4055-8760-b36d453dca18"},"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":2000,"rps_limit":4,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1780,"monthly_call_quota":56500,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4960,"monthly_call_quota":224000,"rps_limit":24,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":10850,"monthly_call_quota":905000,"rps_limit":56,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/edgex-api"}