# Bybit Derivatives Bybit Derivatives historical data for **all its inverse contracts** is available since **2019-11-07** (for linear contracts since 2020-05-28). {% embed url="" %} See Bybit Derivatives historical data coverage: available symbols, channels, date ranges and incidents {% endembed %} ### Downloadable **CSV** files Historical CSV datasets for the first day of each month are **available to download without API key**. See [downloadable CSV files documentation](https://docs.tardis.dev/downloadable-csv-files/overview). {% hint style="info" %} Liquidations datasets are available since 2020-12-18. {% endhint %} | data type | symbol | date | | | --------------------- | ---------- | ---------- | ---------------------------------------------------------------------------------------------------- | | incremental\_book\_L2 | BTCUSD | 2020-01-01 | [Download sample](https://datasets.tardis.dev/v1/bybit/incremental_book_L2/2020/01/01/BTCUSD.csv.gz) | | trades | BTCUSD | 2020-01-01 | [Download sample](https://datasets.tardis.dev/v1/bybit/trades/2020/01/01/BTCUSD.csv.gz) | | quotes | BTCUSD | 2020-01-01 | [Download sample](https://datasets.tardis.dev/v1/bybit/quotes/2020/01/01/BTCUSD.csv.gz) | | derivative\_ticker | BTCUSD | 2020-01-01 | [Download sample](https://datasets.tardis.dev/v1/bybit/derivative_ticker/2020/01/01/BTCUSD.csv.gz) | | trades | ETHUSD | 2020-03-01 | [Download sample](https://datasets.tardis.dev/v1/bybit/trades/2020/03/01/ETHUSD.csv.gz) | | incremental\_book\_L2 | ETHUSD | 2020-03-01 | [Download sample](https://datasets.tardis.dev/v1/bybit/incremental_book_L2/2020/03/01/ETHUSD.csv.gz) | | liquidations | PERPETUALS | 2021-09-01 | [Download sample](https://datasets.tardis.dev/v1/bybit/liquidations/2021/09/01/PERPETUALS.csv.gz) | ### API Access and data format Historical data format is the same as provided by real-time Bybit Derivatives WebSocket API with addition of local timestamps. If you'd like to work with **normalized data format** instead (same format for each exchange) see [downloadable CSV files](https://docs.tardis.dev/downloadable-csv-files/overview) or official [client libs](https://docs.tardis.dev/api/quickstart) that can perform data normalization client-side. {% tabs %} {% tab title="Python" %} ```python # pip install tardis-dev import asyncio from tardis_dev import Channel, replay async def main(): async for local_timestamp, message in replay( exchange="bybit", from_date="2024-01-01", to_date="2024-01-02", filters=[Channel(name="orderbook.50", symbols=["BTCUSD"])], api_key="YOUR_API_KEY", ): # messages as provided by Bybit Derivatives real-time stream print(message) asyncio.run(main()) ``` See [Python client docs](https://docs.tardis.dev/python-client/quickstart). {% endtab %} {% tab title="Node.js" %} ```javascript // npm install tardis-dev import { replay } from 'tardis-dev'; const messages = replay({ exchange: 'bybit', from: '2024-01-01', to: '2024-01-02', filters: [{ channel: 'orderbook.50', symbols: ['BTCUSD'] }], apiKey: 'YOUR_API_KEY' }); // messages as provided by Bybit Derivatives real-time stream for await (const { localTimestamp, message } of messages) { console.log(localTimestamp, message); } ``` See [Node.js client docs](https://docs.tardis.dev/node-client/quickstart). {% endtab %} {% tab title="cURL & HTTP API" %} ```bash curl --compressed -g 'https://api.tardis.dev/v1/data-feeds/bybit?from=2024-01-01&filters=[{"channel":"orderbook.50","symbols":["BTCUSD"]}]&offset=0' ``` {% embed url="" %} Example API response for Bybit Derivatives historical market data request {% endembed %} See [HTTP API docs](https://docs.tardis.dev/api/http-api-reference). {% endtab %} {% tab title="cURL & tardis-machine" %} ```bash curl -g 'localhost:8000/replay?options={"exchange":"bybit","filters":[{"channel":"orderbook.50","symbols":["BTCUSD"]}],"from":"2024-01-01","to":"2024-01-02"}' ``` [Tardis-machine](https://docs.tardis.dev/tardis-machine/quickstart) is a locally runnable server that exposes API allowing efficiently requesting historical market data for whole time periods in contrast to [HTTP API](https://docs.tardis.dev/api/http-api-reference) that provides data only in minute by minute slices. See [tardis-machine](https://docs.tardis.dev/tardis-machine/quickstart) docs. {% endtab %} {% endtabs %} ### Captured real-time channels {% embed url="" %} See Bybit Derivatives WebSocket API docs providing documentation for each captured channel's format {% endembed %} {% hint style="info" %} Click any channel below to see [HTTP API](https://docs.tardis.dev/api/http-api-reference#data-feeds-exchange) response with historical data recorded for it. {% endhint %} * [publicTrade](https://api.tardis.dev/v1/data-feeds/bybit?from=2024-01-01\&filters=\[{%22channel%22:%22publicTrade%22}]) — available since **2023-04-05** Real-time public trade executions stream * [orderbook.50](https://api.tardis.dev/v1/data-feeds/bybit?from=2024-01-01\&filters=\[{%22channel%22:%22orderbook.50%22}]) — available since **2023-04-05** Order book snapshots and deltas at depth 50 * [orderbook.500](https://api.tardis.dev/v1/data-feeds/bybit?from=2024-01-01\&filters=\[{%22channel%22:%22orderbook.500%22}]) — available since **2023-04-05** — available until **2025-09-05** Order book snapshots and deltas at depth 500 * [orderbook.1000](https://api.tardis.dev/v1/data-feeds/bybit?from=2025-10-01\&filters=\[{%22channel%22:%22orderbook.1000%22,%22symbols%22:\[%22BTCUSDT%22]}]) — available since **2025-09-04** Order book snapshots and deltas at depth 1000 * [orderbook.1](https://api.tardis.dev/v1/data-feeds/bybit?from=2024-01-01\&filters=\[{%22channel%22:%22orderbook.1%22}]) — available since **2023-04-05** Order book snapshots and deltas at depth 1 * [allLiquidation](https://api.tardis.dev/v1/data-feeds/bybit?from=2025-03-01\&filters=\[{%22channel%22:%22allLiquidation%22}]) — available since **2025-02-25** All liquidation events stream with 500ms push frequency * [tickers](https://api.tardis.dev/v1/data-feeds/bybit?from=2024-01-01\&filters=\[{%22channel%22:%22tickers%22}]) — available since **2023-04-05** Ticker snapshots and deltas with 24h stats and reference prices * [trade](https://api.tardis.dev/v1/data-feeds/bybit?from=2023-03-01\&filters=\[{%22channel%22:%22trade%22,%22symbols%22:\[%22BTCUSDT%22]}]) — available until **2023-04-05** Public trade executions stream * [orderBookL2\_25](https://api.tardis.dev/v1/data-feeds/bybit?from=2023-03-01\&filters=\[{%22channel%22:%22orderBookL2_25%22,%22symbols%22:\[%22BTCUSDT%22]}]) — available until **2023-04-05** Order book snapshots and deltas at depth 25 * [orderBook\_200](https://api.tardis.dev/v1/data-feeds/bybit?from=2023-03-01\&filters=\[{%22channel%22:%22orderBook_200%22,%22symbols%22:\[%22BTCUSDT%22]}]) — available since **2019-12-23** — available until **2023-04-05** Order book snapshots and deltas at depth 200 * [liquidation](https://api.tardis.dev/v1/data-feeds/bybit?from=2023-03-01\&filters=\[{%22channel%22:%22liquidation%22,%22symbols%22:\[%22BTCUSDT%22]}]\&offset=50) — available since **2020-11-03** — available until **2023-04-05** Liquidation stream for each symbol, up to one message per second * [instrument\_info](https://api.tardis.dev/v1/data-feeds/bybit?from=2023-03-01\&filters=\[{%22channel%22:%22instrument_info%22,%22symbols%22:\[%22BTCUSDT%22]}]) — available until **2023-04-05** Instrument ticker and contract state updates * [insurance](https://api.tardis.dev/v1/data-feeds/bybit?from=2022-11-01\&filters=\[{%22channel%22:%22insurance%22}]\&offset=49) — available until **2023-04-05** Insurance fund balance updates * [long\_short\_ratio](https://api.tardis.dev/v1/data-feeds/bybit?from=2023-03-01\&filters=\[{%22channel%22:%22long_short_ratio%22}]) — available since **2022-03-20** — available until **2023-04-05** — generated channel Generated global long/short account ratio snapshots from REST account-ratio endpoint using 5min period buckets ### Market data collection details [Market data collection infrastructure](https://docs.tardis.dev/faq/general#what-is-your-infrastructure-setup) for Bybit Derivatives **since 2020-05-28** is located in GCP asia-northeast1 (Tokyo, Japan), before that it was located in GCP europe-west2 region (London, UK). Real-time market data is captured via **multiple WebSocket connections** to `wss://stream.bybit.com/v5/public`. {% hint style="info" %} Bybit servers are located in AWS ap-southeast-1 region (Singapore, Asia Pacific). {% endhint %}