Quickstart

Get started with downloading CSV datasets via Python, Node.js or cURL

CSV datasets are available via dedicated datasets API that allows downloading tick level incremental order book L2 updates, order book snapshots (top 25 and top 5), trades, options chains, quotes, book tickers, derivative tickers and liquidations data.

For ongoing data, CSV datasets for a given day are available on the next day around 06:00 UTC. Historical datasets for the first day of each month are available to download without API key.
CSV datasets are exported from exchanges' real-time WebSocket feeds data we collected and also provide via our API as historical data in exchange-native format.
Row order in CSV files reflects the original capture order. When multiple events share the same millisecond exchange timestamp, use row position as the tie-breaker — see event ordering FAQ.

Download via client libraries

# pip install tardis-dev
# requires Python >=3.9
from tardis_dev import download_datasets

download_datasets(
    exchange="deribit",
    data_types=[
        "incremental_book_L2",
        "trades",
        "quotes",
        "derivative_ticker",
        "book_snapshot_25",
        "liquidations"
    ],
    from_date="2019-11-01",
    to_date="2019-11-02",
    symbols=["BTC-PERPETUAL", "ETH-PERPETUAL"],
    api_key="YOUR API KEY (optionally)",
)

// npm install tardis-dev
// requires Node.js v24+
import { downloadDatasets } from 'tardis-dev'

await downloadDatasets({
  exchange: 'deribit',
  dataTypes: [
    'incremental_book_L2',
    'trades',
    'quotes',
    'derivative_ticker',
    'book_snapshot_25',
    'liquidations'
  ],
  from: '2019-11-01',
  to: '2019-11-02',
  symbols: ['BTC-PERPETUAL', 'ETH-PERPETUAL'],
  apiKey: 'YOUR API KEY (optionally)'
})

curl -L -o deribit_trades_2019-11-01_BTC-PERPETUAL.csv.gz https://datasets.tardis.dev/v1/deribit/trades/2019/11/01/BTC-PERPETUAL.csv.gz

Data Types API Reference

How to download all exchange CSV datasets

The examples above download data for specific symbols. To download all available datasets for every instrument of a given exchange, use the exchange metadata API to iterate over all symbols automatically.

# requires Python >=3.9
# pip install tardis-dev

from tardis_dev import download_datasets, get_exchange_details
import logging

# optionally enable debug logs
# logging.basicConfig(level=logging.DEBUG)

# change to any exchange id from https://api.tardis.dev/v1/exchanges with supportsDatasets:true
exchange = "deribit"
exchange_details = get_exchange_details(exchange)

# iterate over and download all data for every symbol
for symbol in exchange_details["datasets"]["symbols"]:
    # alternatively specify data types explicitly ['trades', 'incremental_book_L2', 'quotes'] etc
    # see available options https://docs.tardis.dev/downloadable-csv-files/data-types#data-types
    data_types = symbol["dataTypes"]
    symbol_id = symbol["id"]
    from_date = symbol["availableSince"]
    to_date = symbol["availableTo"]

    # skip grouped symbols like PERPETUALS, SPOT, FUTURES, OPTIONS, COMBOS, PREDICTIONS
    if symbol_id in ["PERPETUALS", "SPOT", "FUTURES", "OPTIONS", "COMBOS", "PREDICTIONS"]:
        continue

    print(f"Downloading {exchange} {data_types} for {symbol_id} from {from_date} to {to_date}")

    # each CSV dataset format is documented at https://docs.tardis.dev/downloadable-csv-files/data-types#data-types
    download_datasets(
        exchange=exchange,
        data_types=data_types,
        from_date=from_date,
        to_date=to_date,
        symbols=[symbol_id],
        # TODO set your API key here
        api_key="YOUR_API_KEY",
        # path where CSV data will be downloaded into
        download_dir="./datasets",
    )

// npm install tardis-dev
// requires Node.js v24+
import { downloadDatasets, getExchangeDetails } from 'tardis-dev'

// change to any exchange id from https://api.tardis.dev/v1/exchanges with supportsDatasets:true
const exchange = 'deribit'
const exchangeDetails = await getExchangeDetails(exchange)

// iterate over and download all data for every symbol
for (const symbol of exchangeDetails.datasets.symbols) {
  // alternatively specify dataTypes explicitly ['trades', 'incremental_book_L2', 'quotes'] etc
  // see available options https://docs.tardis.dev/downloadable-csv-files/data-types#data-types
  const dataTypes = symbol.dataTypes
  const symbolId = symbol.id
  const from = symbol.availableSince
  const to = symbol.availableTo

  // skip grouped symbols like PERPETUALS, SPOT, FUTURES, OPTIONS, COMBOS, PREDICTIONS
  if (['PERPETUALS', 'SPOT', 'FUTURES', 'OPTIONS', 'COMBOS', 'PREDICTIONS'].includes(symbolId)) {
    continue
  }

  console.log(`Downloading ${exchange} ${dataTypes} for ${symbolId} from ${from} to ${to}`)

  // each CSV dataset format is documented at https://docs.tardis.dev/downloadable-csv-files/data-types#data-types
  await downloadDatasets({
    exchange,
    dataTypes,
    from,
    to,
    symbols: [symbolId],
    // TODO: set your API key here
    apiKey: 'YOUR_API_KEY',
    // path where CSV data will be downloaded into
    downloadDir: './datasets'
  })
}

curl -L -o deribit_trades_2019-11-01_BTC-PERPETUAL.csv.gz https://datasets.tardis.dev/v1/deribit/trades/2019/11/01/BTC-PERPETUAL.csv.gz

Grouped symbols

In addition to standard currency pairs & instrument symbols available via the CSV datasets API, each exchange has special grouped symbols depending on which market types it supports: SPOT, FUTURES, OPTIONS, PERPETUALS, COMBOS, and PREDICTIONS. When you request a grouped symbol, the downloaded file contains data for all instruments of that market type. This is especially useful for options, where specifying each symbol one by one would be tedious — using OPTIONS as a symbol gives data for all options available at a given time. PREDICTIONS is available only for trades datasets.

See what is the difference between futures and perpetual swaps contracts.

incremental_book_L2 - available for FUTURES, OPTIONS (Deribit, OKX Options, Binance European Options)
- Examples:
  - https://datasets.tardis.dev/v1/ftx/incremental_book_L2/2020/09/01/FUTURES.csv.gz
  - https://datasets.tardis.dev/v1/deribit/incremental_book_L2/2020/09/01/OPTIONS.csv.gz
trades - available for SPOT, FUTURES, OPTIONS, PERPETUALS, COMBOS, PREDICTIONS
- Examples:
derivative_ticker - available for FUTURES, PERPETUALS, COMBOS
- Examples:
options_chain - available for OPTIONS
- Examples:
  - https://datasets.tardis.dev/v1/deribit/options_chain/2020/09/01/OPTIONS.csv.gz
  - https://datasets.tardis.dev/v1/okex-options/options_chain/2020/09/01/OPTIONS.csv.gz
quotes - available for OPTIONS
- Examples:
  - https://datasets.tardis.dev/v1/deribit/quotes/2020/09/01/OPTIONS.csv.gz
  - https://datasets.tardis.dev/v1/okex-options/quotes/2020/09/01/OPTIONS.csv.gz
liquidations - available for FUTURES, PERPETUALS, OPTIONS
- Examples:
book_snapshot_25 - available for OPTIONS (Deribit, OKX Options, Binance European Options)
- Examples:
  - https://datasets.tardis.dev/v1/deribit/book_snapshot_25/2025/03/01/OPTIONS.csv.gz
book_snapshot_5 - available for OPTIONS (Deribit, OKX Options, Binance European Options)
- Examples:
  - https://datasets.tardis.dev/v1/deribit/book_snapshot_5/2025/03/01/OPTIONS.csv.gz
book_ticker - available for OPTIONS (Deribit, OKX Options, Binance European Options)
- Examples:
  - https://datasets.tardis.dev/v1/deribit/book_ticker/2025/03/01/OPTIONS.csv.gz

Those special symbols are also listed in response to /exchanges/:exchange API call.

PreviousBilling and Subscriptions

NextData Types

Last updated 5 months ago

Was this helpful?