{"openapi":"3.1.0","info":{"title":"Bybit API","version":"1.0.0","description":"Live derivatives and spot market data from Bybit, one of the largest crypto-derivatives exchanges, straight from its public v5 API. Built for perpetual swaps: the ticker returns a contract's last, mark and index price together, the 24-hour change, high, low, volume and turnover, the live open interest in contracts and in USD, and the current funding rate with the next funding time — a whole perp in one call. The funding endpoint returns the historical funding-rate series, the recurring payments that anchor a perp to spot. The openinterest endpoint returns the open-interest time series, the best gauge of leverage building or unwinding. The kline endpoint returns OHLCV candles at any interval. Linear (USDT) perps, inverse (coin) perps and spot are all reachable via the category parameter. Live, no key, nothing stored. Distinct from Coinbase, Bitstamp, OKX, Gate.io, Bitfinex and Gemini venue APIs and from aggregated derivatives feeds — this is Bybit's own ticker, funding history, open interest and candles. Perfect for trading, charting, derivatives-analytics and risk apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bybit-api","description":"oanor gateway"}],"tags":[{"name":"Market"},{"name":"Derivatives"}],"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/kline":{"get":{"operationId":"get_v1_kline","tags":["Market"],"summary":"OHLCV candles","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Bybit symbol","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"interval","in":"query","required":false,"description":"1..720, D, W or M","schema":{"type":"string"},"example":"60"},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"source":"Bybit","symbol":"BTCUSDT","candles":[{"low":61920.7,"high":62250.1,"open":62071.5,"time":"2026-06-09T20:00:00.000Z","close":61984.1,"volume":1767.783,"turnover":109744025.2588},{"low":61690.9,"high":62087.1,"open":61760.6,"time":"2026-06-09T19:00:00.000Z","close":62071.5,"volume":3823.956,"turnover":236641505.3364},{"low":61565.8,"high":61954.5,"open":61667.7,"time":"2026-06-09T18:00:00.000Z","close":61760.6,"volume":3546.046,"turnover":218882096.3615},{"low":61362,"high":61877.1,"open":61362,"time":"2026-06-09T17:00:00.000Z","close":61667.7,"volume":6679.208,"turnover":411763084.3545},{"low":60705,"high":61475,"open":61104.9,"time":"2026-06-09T16:00:00.000Z","close":61362,"volume":11381.499,"turnover":695036957.9708},{"low":61000.3,"high":61683.3,"open":61514.1,"time":"2026-06-09T15:00:00.000Z","close":61104.9,"volume":7625.835,"turnover":467604326.5896},{"low":61111,"high":62368.4,"open":62245.4,"time":"2026-06-09T14:00:00.000Z","close":61514.1,"volume":13235.627,"turnover":815616186.8719},{"low":62130,"high":62706.1,"open":62611.9,"time":"2026-06-09T13:00:00.000Z","close":62245.4,"volume":6882.856,"turnover":429186456.1226},{"low":62385.4,"high":62878,"open":62676.2,"time":"2026-06-09T12:00:00.000Z","close":62611.9,"volume":3778.586,"turnover":236754929.9916},{"low":62462.9,"high":62778.3,"open":62749,"time":"2026-06-09T11:00:00.000Z","close":62676.2,"volume":2504.465,"turnover":156745887.9546},{"low":62544.4,"high":62797.4,"open":62685.6,"time":"2026-06-09T10:00:00.000Z","close":62749,"volume":2031.178,"turnover":127322622.4231},{"low":62547.4,"high":62937.1,"open":62814.5,"time":"2026-06-09T09:00:00.000Z","close":62685.6,"volume":2769.407,"turnover":173701946.2061},{"low":62730.5,"high":63182.3,"open":63170.6,"time":"2026-06-09T08:00:00.000Z","close":62814.5,"volume":4183.145,"turnover":262988156.216},{"low":62977.7,"high":63422.9,"open":63275.1,"time":"2026-06-09T07:00:00.000Z","close":63170.6,"volume":2621.974,"turnover":165543062.6489},{"low":63194.4,"high":63481.8,"open":63317.9,"time":"2026-06-09T06:00:00.000Z","close":63275.1,"volume":1460.036,"turnover":92474955.1136},{"low":63089.1,"high":63501,"open":63209.7,"time":"2026-06-09T05:00:00.000Z","close":63317.9,"volume":1959.252,"turnover":124040382.7007},{"low":62718.5,"high":63407.7,"open":62844.7,"time":"2026-06-09T04:00:00.000Z","close":63209.7,"volume":5323.849,"turnover":336037545.8246},{"low":62668.3,"high":62943,"open":62841.6,"time":"2026-06-09T03:00:00.000Z","close":62844.7,"volume":2066.546,"turnover":129808941.516},{"low":62505.4,"high":62841.6,"open":62731.1,"time":"2026-06-09T02:00:00.000Z","close":62841.6,"volume":1475.772,"turnover":92497030.6739},{"low":62515.2,"high":62844.3,"open":62522.8,"time":"2026-06-09T01:00:00.000Z","close":62731.1,"volume":2108.696,"turnover":132199881.7349},{"low":62386.1,"high":63155.2,"open":63056.4,"time":"2026-06-09T00:00:00.000Z","close":62522.8,"volume":6510.404,"turnover":407933349.4598},{"low":62939,"high":63567.7,"open":63406.4,"time":"2026-06-08T23:00:00.000Z","close":63056.4,"volume":2934.375,"turnover":185279681.9913},{"low":63177.5,"high":63694.3,"open":63694.3,"time":"2026-06-08T22:00:00.000Z","close":63406.4,"volume":2271.156,"turnover":143865091.21},{"low":63453.4,"high":63840.7,"open":63456.3,"time":"2026-06-08T21:00:00.000Z","close":63694.3,"volume":2383.594,"turnover":151758489.1113},{"low":63065.9,"high":63456.4,"open":63342.1,"time":"2026-06-08T20:00:00.000Z","close":63456.3,"volume":3026.192,"turnover":191343549.1036},{"low":63320.1,"high":63573.9,"open":63438.5,"time":"2026-06-08T19:00:00.000Z","close":63342.1,"volume":1261.11,"turnover":80023776.5551},{"low":63303,"high":63665.3,"open":63526.1,"time":"2026-06-08T18:00:00.000Z","close":63438.5,"volume":1704.968,"turnover":108302180.6376},{"low":63226.3,"high":63623.5,"open":63501.6,"time":"2026-06-08T17:00:00.000Z","close":63526.1,"volume":3681.355,"turnover":233427337.0665},{"low":63434.8,"high":64025.9,"open":63745.6,"time":"2026-06-08T16:00:00.000Z","close":63501.6,"volume":4056.076,"turnover":258330415.8219},{"low":63671.1,"high":64220.9,"open":63940.9,"time":"2026-06-08T15:00:00.000Z","close":63745.6,"volume":6715.108,"turnover":429596933.6355},{"low":63534.4,"high":64070,"open":63726.4,"time":"2026-06-08T14:00:00.000Z","close":63940.9,"volume":5568.437,"turnover":355322088.0052},{"low":63330.3,"high":63932.6,"open":63840,"time":"2026-06-08T13:00:00.000Z","close":63726.4,"volume":5826.68,"turnover":370786477.6631},{"low":62672.7,"high":63935,"open":63451.4,"time":"2026-06-08T12:00:00.000Z","close":63840,"volume":10509.74,"turnover":664422257.7558},{"low":63010.3,"high":63888.6,"open":63129.4,"time":"2026-06-08T11:00:00.000Z","close":63451.4,"volume":5189.049,"turnover":329539951.6172},{"low":63064.5,"high":63536,"open":63466.2,"time":"2026-06-08T10:00:00.000Z","close":63129.4,"volume":2908.675,"turnover":183959117.8562},{"low":63093.4,"high":63571.6,"open":63105.5,"time":"2026-06-08T09:00:00.000Z","close":63466.2,"volume":3145.052,"turnover":199276988.6348},{"low":62951.3,"high":63263.5,"open":63263.5,"time":"2026-06-08T08:00:00.000Z","close":63105.5,"volume":1635.146,"turnover":103152413.663},{"low":62778,"high":63331.4,"open":62963.9,"time":"2026-06-08T07:00:00.000Z","close":63263.5,"volume":2976.585,"turnover":187847398.7758},{"low":62701.4,"high":63118,"open":62736.1,"time":"2026-06-08T06:00:00.000Z","close":62963.9,"volume":2416.693,"turnover":152131212.7023},{"low":62374,"high":62792.9,"open":62650.1,"time":"2026-06-08T05:00:00.000Z","close":62736.1,"volume":2879.831,"turnover":180220026.728},{"low":62600.1,"high":63141.4,"open":63095.9,"time":"2026-06-08T04:00:00.000Z","close":62650.1,"volume":1985.566,"turnover":124723511.4045},{"low":62929.8,"high":63432.1,"open":63093,"time":"2026-06-08T03:00:00.000Z","close":63095.9,"volume":1865.876,"turnover":117844617.6028},{"low":62880.5,"high":63231.4,"open":63183.8,"time":"2026-06-08T02:00:00.000Z","close":63093,"volume":1773.771,"turnover":111810577.4286},{"low":62678.8,"high":63623.1,"open":63604.2,"time":"2026-06-08T01:00:00.000Z","close":63183.8,"volume":3828.36,"turnover":241374837.1453},{"low":63110.2,"high":63842.9,"open":63306.5,"time":"2026-06-08T00:00:00.000Z","close":63604.2,"volume":3719.167,"turnover":236256475.0985},{"low":62771.5,"high":63437.5,"open":62833.6,"time":"2026-06-07T23:00:00.000Z","close":63306.5,"volume":3123.302,"turnover":197058208.3742},{"low":61685,"high":64250,"open":61749.9,"time":"2026-06-07T22:00:00.000Z","close":62833.6,"volume":21486.058,"turnover":1356858587.6494},{"low":61614.1,"high":61994.5,"open":61840.9,"time":"2026-06-07T21:00:00.000Z","close":61749.9,"volume":3219.427,"turnover":198846009.4487},{"low":61178.7,"high":61940.6,"open":61299.8,"time":"2026-06-07T20:00:00.000Z","close":61840.9,"volume":4242.449,"turnover":261424272.238},{"low":61138.5,"high":62003.8,"open":61996.6,"time":"2026-06-07T19:00:00.000Z","close":61299.8,"volume":7944.998,"turnover":488147824.6947}],"category":"linear","interval":"60"},"meta":{"timestamp":"2026-06-09T20:24:31.255Z","request_id":"af684937-3d22-4a04-ae9c-55e98cf502d0"},"status":"ok","message":"Candles 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":["Market"],"summary":"Contract ticker incl. OI and funding","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Bybit symbol","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"category","in":"query","required":false,"description":"linear, inverse or spot","schema":{"type":"string"},"example":"linear"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ask":61984.1,"bid":61984,"source":"Bybit","symbol":"BTCUSDT","low_24h":60705,"category":"linear","high_24h":63840.7,"last_price":61984,"mark_price":61984,"volume_24h":102335.639,"index_price":62012.65,"funding_rate":5.494e-5,"turnover_24h":6367343183.8335,"open_interest":55189.169,"change_24h_pct":-1.9987,"prev_price_24h":63248.2,"funding_rate_pct":0.005494,"next_funding_time":"2026-06-10T00:00:00.000Z","open_interest_value":3420845451.3},"meta":{"timestamp":"2026-06-09T20:24:31.546Z","request_id":"2fb972ac-7831-4ce3-8c50-08df417584af"},"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/funding":{"get":{"operationId":"get_v1_funding","tags":["Derivatives"],"summary":"Historical funding-rate series","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Bybit perp symbol","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":30,"source":"Bybit","symbol":"BTCUSDT","funding":[{"time":"2026-06-09T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":1.714e-5,"funding_rate_pct":0.001714},{"time":"2026-06-09T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":3.712e-5,"funding_rate_pct":0.003712},{"time":"2026-06-09T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":1.644e-5,"funding_rate_pct":0.001644},{"time":"2026-06-08T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":3.697e-5,"funding_rate_pct":0.003697},{"time":"2026-06-08T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":2.491e-5,"funding_rate_pct":0.002491},{"time":"2026-06-08T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":8.39e-6,"funding_rate_pct":0.000839},{"time":"2026-06-07T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":1.038e-5,"funding_rate_pct":0.001038},{"time":"2026-06-07T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":-1.916e-5,"funding_rate_pct":-0.001916},{"time":"2026-06-07T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":-4.138e-5,"funding_rate_pct":-0.004138},{"time":"2026-06-06T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":-4.06e-6,"funding_rate_pct":-0.000406},{"time":"2026-06-06T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":3.805e-5,"funding_rate_pct":0.003805},{"time":"2026-06-06T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":2.774e-5,"funding_rate_pct":0.002774},{"time":"2026-06-05T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":-2.692e-5,"funding_rate_pct":-0.002692},{"time":"2026-06-05T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":-3.588e-5,"funding_rate_pct":-0.003588},{"time":"2026-06-05T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":-2.403e-5,"funding_rate_pct":-0.002403},{"time":"2026-06-04T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":-1.17e-6,"funding_rate_pct":-0.000117},{"time":"2026-06-04T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":3.034e-5,"funding_rate_pct":0.003034},{"time":"2026-06-04T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":-4.52e-6,"funding_rate_pct":-0.000452},{"time":"2026-06-03T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":8.14e-5,"funding_rate_pct":0.00814},{"time":"2026-06-03T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":4.329e-5,"funding_rate_pct":0.004329},{"time":"2026-06-03T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":6.68e-6,"funding_rate_pct":0.000668},{"time":"2026-06-02T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":9.202e-5,"funding_rate_pct":0.009202},{"time":"2026-06-02T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":0.0001,"funding_rate_pct":0.01},{"time":"2026-06-02T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":0.0001,"funding_rate_pct":0.01},{"time":"2026-06-01T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":7.23e-5,"funding_rate_pct":0.00723},{"time":"2026-06-01T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":-3.38e-6,"funding_rate_pct":-0.000338},{"time":"2026-06-01T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":4.369e-5,"funding_rate_pct":0.004369},{"time":"2026-05-31T16:00:00.000Z","symbol":"BTCUSDT","funding_rate":6.798e-5,"funding_rate_pct":0.006798},{"time":"2026-05-31T08:00:00.000Z","symbol":"BTCUSDT","funding_rate":5.136e-5,"funding_rate_pct":0.005136},{"time":"2026-05-31T00:00:00.000Z","symbol":"BTCUSDT","funding_rate":7.356e-5,"funding_rate_pct":0.007356}],"category":"linear"},"meta":{"timestamp":"2026-06-09T20:24:31.831Z","request_id":"bf70c463-3632-4533-afbf-7b15d9634513"},"status":"ok","message":"Funding 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/openinterest":{"get":{"operationId":"get_v1_openinterest","tags":["Derivatives"],"summary":"Open-interest time series","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Bybit perp symbol","schema":{"type":"string"},"example":"BTCUSDT"},{"name":"interval","in":"query","required":false,"description":"5min..1d","schema":{"type":"string"},"example":"1h"},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":30,"source":"Bybit","symbol":"BTCUSDT","category":"linear","interval":"1h","open_interest":[{"time":"2026-06-09T20:00:00.000Z","open_interest":55528.886},{"time":"2026-06-09T19:00:00.000Z","open_interest":55859.079},{"time":"2026-06-09T18:00:00.000Z","open_interest":56024.942},{"time":"2026-06-09T17:00:00.000Z","open_interest":55745.054},{"time":"2026-06-09T16:00:00.000Z","open_interest":55697.862},{"time":"2026-06-09T15:00:00.000Z","open_interest":55111.407},{"time":"2026-06-09T14:00:00.000Z","open_interest":55495.514},{"time":"2026-06-09T13:00:00.000Z","open_interest":54809.996},{"time":"2026-06-09T12:00:00.000Z","open_interest":54542.756},{"time":"2026-06-09T11:00:00.000Z","open_interest":54149.857},{"time":"2026-06-09T10:00:00.000Z","open_interest":54129.991},{"time":"2026-06-09T09:00:00.000Z","open_interest":54396.618},{"time":"2026-06-09T08:00:00.000Z","open_interest":53748.927},{"time":"2026-06-09T07:00:00.000Z","open_interest":54492.323},{"time":"2026-06-09T06:00:00.000Z","open_interest":54658.653},{"time":"2026-06-09T05:00:00.000Z","open_interest":54344.415},{"time":"2026-06-09T04:00:00.000Z","open_interest":54309.446},{"time":"2026-06-09T03:00:00.000Z","open_interest":54894.318},{"time":"2026-06-09T02:00:00.000Z","open_interest":55103.212},{"time":"2026-06-09T01:00:00.000Z","open_interest":55028.442},{"time":"2026-06-09T00:00:00.000Z","open_interest":54840.348},{"time":"2026-06-08T23:00:00.000Z","open_interest":55155.54},{"time":"2026-06-08T22:00:00.000Z","open_interest":55165.963},{"time":"2026-06-08T21:00:00.000Z","open_interest":55332.725},{"time":"2026-06-08T20:00:00.000Z","open_interest":55894.733},{"time":"2026-06-08T19:00:00.000Z","open_interest":55901.494},{"time":"2026-06-08T18:00:00.000Z","open_interest":55251.265},{"time":"2026-06-08T17:00:00.000Z","open_interest":55554.478},{"time":"2026-06-08T16:00:00.000Z","open_interest":55602.603},{"time":"2026-06-08T15:00:00.000Z","open_interest":56088.893}]},"meta":{"timestamp":"2026-06-09T20:24:32.120Z","request_id":"efe24173-2742-473f-9e6d-cba07598f0a2"},"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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1300,"monthly_call_quota":150000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3700,"monthly_call_quota":900000,"rps_limit":18,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7900,"monthly_call_quota":4900000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bybit-api"}