{"openapi":"3.1.0","info":{"title":"Crypto Open Interest API","version":"1.0.0","description":"Live open-interest history and trend for crypto perpetual futures, served from the Bybit v5 feed. Open interest is the total value of outstanding contracts — its trend, rising or falling alongside price, is the signal traders use to confirm a move or spot a squeeze. For any USDT perpetual this returns the latest open interest in contracts and in USD, how it has changed over your chosen window, the rising / falling / flat trend, and the full time-series across 5m, 15m, 30m, 1h, 4h and 1d buckets. Look a contract up by symbol (BTCUSDT) or base coin (BTC), pull its open-interest history, or list every tradable perpetual. Live data, no cache. Distinct from a funding-rate API (which carries the rate snapshot) and from price / ticker APIs — this is the open-interest time-series and trend layer.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/openinterest-api","description":"oanor gateway"}],"tags":[{"name":"Open Interest"},{"name":"History"},{"name":"Symbols"},{"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/oi":{"get":{"operationId":"get_v1_oi","tags":["Open Interest"],"summary":"Latest open interest + change and trend","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Perpetual contract symbol","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"base","in":"query","required":false,"description":"Base coin (resolves to <base>USDT)","schema":{"type":"string"},"example":"BTC"},{"name":"period","in":"query","required":false,"description":"Bucket: 5m|15m|30m|1h|4h|1d","schema":{"type":"string"},"example":"1h"},{"name":"lookback","in":"query","required":false,"description":"Buckets to compare against (2-200)","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"from":"2026-06-08T03:00:00.000Z","as_of":"2026-06-09T03:00:00.000Z","trend":"rising","period":"1h","symbol":"BTCUSDT","change_pct":2.71,"last_price":62807.5,"open_interest":54894.318,"lookback_buckets":24,"open_interest_ago":53446.06,"open_interest_value_usd":3437587201.86},"meta":{"timestamp":"2026-06-09T03:02:49.022Z","request_id":"50833bd6-cabb-43f2-ad9f-1bc659c84862"},"status":"ok","message":"Open interest 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/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Open-interest time-series","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Perpetual contract symbol","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"base","in":"query","required":false,"description":"Base coin (resolves to <base>USDT)","schema":{"type":"string"},"example":"ETH"},{"name":"period","in":"query","required":false,"description":"Bucket: 5m|15m|30m|1h|4h|1d","schema":{"type":"string"},"example":"1d"},{"name":"limit","in":"query","required":false,"description":"Points to return (1-200)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"period":"1d","symbol":"BTCUSDT","history":[{"timestamp":"2026-04-21T00:00:00.000Z","open_interest":51149.732},{"timestamp":"2026-04-22T00:00:00.000Z","open_interest":50152.433},{"timestamp":"2026-04-23T00:00:00.000Z","open_interest":57150.536},{"timestamp":"2026-04-24T00:00:00.000Z","open_interest":51873.462},{"timestamp":"2026-04-25T00:00:00.000Z","open_interest":49158.805},{"timestamp":"2026-04-26T00:00:00.000Z","open_interest":49411.464},{"timestamp":"2026-04-27T00:00:00.000Z","open_interest":48218.45},{"timestamp":"2026-04-28T00:00:00.000Z","open_interest":51963.968},{"timestamp":"2026-04-29T00:00:00.000Z","open_interest":50997.33},{"timestamp":"2026-04-30T00:00:00.000Z","open_interest":49815.733},{"timestamp":"2026-05-01T00:00:00.000Z","open_interest":50358.905},{"timestamp":"2026-05-02T00:00:00.000Z","open_interest":53747.089},{"timestamp":"2026-05-03T00:00:00.000Z","open_interest":50753.387},{"timestamp":"2026-05-04T00:00:00.000Z","open_interest":52247.365},{"timestamp":"2026-05-05T00:00:00.000Z","open_interest":54577.966},{"timestamp":"2026-05-06T00:00:00.000Z","open_interest":57349.475},{"timestamp":"2026-05-07T00:00:00.000Z","open_interest":51986.312},{"timestamp":"2026-05-08T00:00:00.000Z","open_interest":51997.212},{"timestamp":"2026-05-09T00:00:00.000Z","open_interest":52208.332},{"timestamp":"2026-05-10T00:00:00.000Z","open_interest":51495.384},{"timestamp":"2026-05-11T00:00:00.000Z","open_interest":51913.228},{"timestamp":"2026-05-12T00:00:00.000Z","open_interest":51956.65},{"timestamp":"2026-05-13T00:00:00.000Z","open_interest":52831.015},{"timestamp":"2026-05-14T00:00:00.000Z","open_interest":55989.962},{"timestamp":"2026-05-15T00:00:00.000Z","open_interest":52879.052},{"timestamp":"2026-05-16T00:00:00.000Z","open_interest":53594.783},{"timestamp":"2026-05-17T00:00:00.000Z","open_interest":54819.784},{"timestamp":"2026-05-18T00:00:00.000Z","open_interest":52837.455},{"timestamp":"2026-05-19T00:00:00.000Z","open_interest":53541.905},{"timestamp":"2026-05-20T00:00:00.000Z","open_interest":53401.909},{"timestamp":"2026-05-21T00:00:00.000Z","open_interest":51506.871},{"timestamp":"2026-05-22T00:00:00.000Z","open_interest":52146.234},{"timestamp":"2026-05-23T00:00:00.000Z","open_interest":55196.436},{"timestamp":"2026-05-24T00:00:00.000Z","open_interest":52514.797},{"timestamp":"2026-05-25T00:00:00.000Z","open_interest":52076.636},{"timestamp":"2026-05-26T00:00:00.000Z","open_interest":53998.431},{"timestamp":"2026-05-27T00:00:00.000Z","open_interest":50500.124},{"timestamp":"2026-05-28T00:00:00.000Z","open_interest":57496.286},{"timestamp":"2026-05-29T00:00:00.000Z","open_interest":58319.26},{"timestamp":"2026-05-30T00:00:00.000Z","open_interest":54012.864},{"timestamp":"2026-05-31T00:00:00.000Z","open_interest":54589.365},{"timestamp":"2026-06-01T00:00:00.000Z","open_interest":53993.43},{"timestamp":"2026-06-02T00:00:00.000Z","open_interest":58005.882},{"timestamp":"2026-06-03T00:00:00.000Z","open_interest":58488.682},{"timestamp":"2026-06-04T00:00:00.000Z","open_interest":58590.284},{"timestamp":"2026-06-05T00:00:00.000Z","open_interest":56347.859},{"timestamp":"2026-06-06T00:00:00.000Z","open_interest":56433.289},{"timestamp":"2026-06-07T00:00:00.000Z","open_interest":56997.78},{"timestamp":"2026-06-08T00:00:00.000Z","open_interest":53705.488},{"timestamp":"2026-06-09T00:00:00.000Z","open_interest":54840.348}]},"meta":{"timestamp":"2026-06-09T03:02:49.301Z","request_id":"cbcffaad-8f06-4a06-b058-0799c4437fca"},"status":"ok","message":"History 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/symbols":{"get":{"operationId":"get_v1_symbols","tags":["Symbols"],"summary":"List tradable perpetual symbols","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Filter substring","schema":{"type":"string"},"example":"PEPE"},{"name":"limit","in":"query","required":false,"description":"Max results (1-2000)","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"total":1,"symbols":["1000PEPEUSDT"]},"meta":{"timestamp":"2026-06-09T03:02:50.387Z","request_id":"0549728b-e0f9-4e41-be57-05786d76a6d2"},"status":"ok","message":"Symbols 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":{"source":"Bybit v5 open-interest + tickers (live)","periods":["5m","15m","30m","1h","4h","1d"],"service":"openinterest-api","endpoints":{"GET /v1/oi":"Latest open interest + change/trend (symbol=BTCUSDT or base=BTC, period=5m|15m|30m|1h|4h|1d, lookback).","GET /v1/meta":"This document.","GET /v1/history":"Open-interest time-series (symbol, period, limit up to 200).","GET /v1/symbols":"List tradable perpetual symbols (q= filter, limit)."},"description":"Live crypto open-interest history and trend from Bybit v5 (USDT perpetuals): latest open interest in contracts and USD, change over a window, rising/falling trend, and the full time-series across 5m–1d buckets. Look up by symbol or base coin, pull history, or list symbols. Live, no key. Distinct from funding-rate (a snapshot) and price APIs — this is the open-interest trend.","symbols_live":582},"meta":{"timestamp":"2026-06-09T03:02:50.963Z","request_id":"7cf3daff-8487-497a-ab17-bf151110d134"},"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":5000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1600,"monthly_call_quota":75000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4200,"monthly_call_quota":400000,"rps_limit":40,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":9900,"monthly_call_quota":2500000,"rps_limit":120,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/openinterest-api"}