Downloadable CSV files

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

For ongoing data, CSV datasets for a given day are available on the next day around 05:00 UTC.
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).
Historical datasets for the first day of each month are available to download without API key. 

Our Node.js and Python clients have built-in functions to efficiently download whole date range of data.
Python
Node.js
cURL
# pip install tardis-dev
# requires Python >=3.6
from tardis_dev import datasets
​
datasets.download(
    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)",
)
See full example that shows all available download options (download path customization, filenames conventions and more).
// npm install [email protected]
// requires node version >=12
const { downloadDatasets } = require('tardis-dev')
​
;(async () => {
  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)'
  })
})()
See full example that shows all available download options (download path customization, filenames conventions and more).
curl -o deribit_trades_2019-11-01_BTC-PERPETUAL.csv.gz https://datasets.tardis.dev/v1/deribit/trades/2019/11/01/BTC-PERPETUAL.csv.gz
​
See datasets API reference.
​
​
CSV format details
columns delimiter: , (comma)
new line marker: \n (LF)
decimal mark: . (dot)
date time format: microseconds since epoch (https://www.epochconverter.com/)
date time timezone: UTC
​
​
Data types
• incremental_book_L2 
Incremental order book L2 updates collected from exchanges' real-time WebSocket order book L2 data feeds - data as deep and granular as underlying real-time data source, please see FAQ: What is the maximum order book depth available for each supported exchange? for more details.
Learn in more detail how incremental_book_l2 CSV dataset is built from real-time data.
As exchanges real-time feeds usually publish multiple order book levels updates via single message you can recognize that by grouping rows by local_timestamp field if needed. 
If you have any doubts how to correctly reconstruct full order book state from incremental_book_L2 CSV dataset, please see this answer or contact us.

In case you only need order book data for top 25 or top 5 levels, we do provide datasets with already reconstructed snapshots for every update for those. See book_snapshot_25 and book_snapshot_5.
​
CSV incremental_book_L2  schema
dataset preview
column name
description
​
exchange
exchange id, one of https://api.tardis.dev/v1/exchanges ([].id field)
​
symbol
instrument symbol as provided by exchange (always uppercase)
​
timestamp
timestamp provided by exchange in microseconds since epoch - if exchange does not provide one local_timestamp value is used as a fallback 
​
local_timestamp
message arrival timestamp in microseconds since epoch
​
is_snapshot
possible values:
true - if update was a part of initial order book snapshot
false - if update was not a part of initial order book snapshot
If last update was not a snapshot and current one is, then existing order book state must be discarded (all existing levels removed)
​
side
determines to which side of the order book update belongs to:
bid - bid side of the book, buy orders
ask - ask side of the book, sell orders
​
price
price identifying book level being updated
​
amount
updated price level amount as provided by exchange, not a delta - an amount of 0 indicates that the price level can be removed
​
exchange
symbol
timestamp
local_timestamp
is_snapshot
side
price
amount
deribit
BTC-PERPETUAL
1585699209920000
1585699209934201
false
ask
6443.5
38640
deribit
BTC-PERPETUAL
1585699209947000
1585699209957629
false
bid
6311.5
0
deribit
BTC-PERPETUAL
1585699209950000
1585699209963464
false
ask
6428
13210
deribit
BTC-PERPETUAL
1585699209967000
1585699209979152
false
bid
6311.5
750
deribit
BTC-PERPETUAL
1585699209970000
1585699209983585
false
bid
6327
16010
deribit
BTC-PERPETUAL
1585699209970000
1585699209983585
false
bid
6325
210530
deribit
BTC-PERPETUAL
1585699209972000
1585699209983691
false
bid
6351
810
deribit
BTC-PERPETUAL
1585699209972000
1585699209983691
false
bid
6352.5
18830
deribit
BTC-PERPETUAL
1585699209974000
1585699209983703
false
ask
6492
100
https://datasets.tardis.dev/v1/deribit/incremental_book_L2/2020/04/01/BTC-PERPETUAL.csv.gz
Deribit BTC-PERPETUAL incremental order book L2 updates for 2020-04-01
https://datasets.tardis.dev/v1/deribit/incremental_book_L2/2020/09/01/FUTURES.csv.gz
Deribit FUTURES instruments incremental order book L2 updates for 2020-09-01
​
​
• book_snapshot_25
Tick-level order book snapshots reconstructed from exchanges' real-time WebSocket order book L2 data feeds. Each row represents top 25 levels from each side of the limit order book book and was recorded every time any of the tracked bids/asks top 25 levels have changed.
​
CSV book_snapshot_25 schema
dataset preview
column name
description
​
exchange
exchange id, one of https://api.tardis.dev/v1/exchanges ([].id field)
​
symbol
instrument symbol as provided by exchange (always uppercase)
​
timestamp
timestamp provided by exchange in microseconds since epoch - if exchange does not provide one local_timestamp value is used as a fallback 
​
local_timestamp
message arrival timestamp in microseconds since epoch
​
asks[0..24].price
top 25 asks prices in ascending order, empty if there aren't enough price levels available in the order book or provided by the exchange
​
asks[0..24].amount
top 25 asks amounts in ascending order, empty if there aren't enough price levels available in the order book or provided by the exchange
​
bids[0..24].price
top 25 bids prices in descending order, empty if there aren't enough price levels available in the order book or provided by the exchange
​
bids[0..24].amount
top 25 bids amounts in descending order, empty if there aren't enough price levels available in the order book or provided by the exchange
​
exchange
symbol
timestamp
local_timestamp
asks[0].price
asks[0].amount
bids[0].price
bids[0].amount
asks[1].price
asks[1].amount
bids[1].price
bids[1].amount
asks[2].price
asks[2].amount
bids[2].price
bids[2].amount
asks[3].price
asks[3].amount
bids[3].price
bids[3].amount
asks[4].price
asks[4].amount
bids[4].price
bids[4].amount
asks[5].price
asks[5].amount
bids[5].price
bids[5].amount
asks[6].price
asks[6].amount
bids[6].price
bids[6].amount
asks[7].price
asks[7].amount
bids[7].price
bids[7].amount
asks[8].price
asks[8].amount
bids[8].price
bids[8].amount
asks[9].price
asks[9].amount
bids[9].price
bids[9].amount
asks[10].price
asks[10].amount
bids[10].price
bids[10].amount
asks[11].price
asks[11].amount
bids[11].price
bids[11].amount
asks[12].price
asks[12].amount
bids[12].price
bids[12].amount
asks[13].price
asks[13].amount
bids[13].price
bids[13].amount
asks[14].price
asks[14].amount
bids[14].price
bids[14].amount
asks[15].price
asks[15].amount
bids[15].price
bids[15].amount
asks[16].price
asks[16].amount
bids[16].price
bids[16].amount
asks[17].price
asks[17].amount
bids[17].price
bids[17].amount
asks[18].price
asks[18].amount
bids[18].price
bids[18].amount
asks[19].price
asks[19].amount
bids[19].price
bids[19].amount
asks[20].price
asks[20].amount
bids[20].price
bids[20].amount
asks[21].price
asks[21].amount
bids[21].price
bids[21].amount
asks[22].price
asks[22].amount
bids[22].price
bids[22].amount
asks[23].price
asks[23].amount
bids[23].price
bids[23].amount
asks[24].price
asks[24].amount
bids[24].price
bids[24].amount
deribit
BTC-PERPETUAL
1599868800206000
1599868800253274
10396
48050
10395.5
18220
10396.5
22220
10395
16570
10397
100
10394.5
22630
10397.5
8360
10394
16670
10398
1500
10393.5
16570
10398.5
13210
10393
5600
10399.5
60070
10392.5
20500
10400
5100
10392
30
10400.5
5140
10391.5
75780
10401
13040
10391
12110
10401.5
2250
10390.5
280
10402
9150
10390
52680
10402.5
119390
10389.5
18240
10403
23070
10389
73010
10403.5
53930
10388.5
67500
10404
43590
10388
313140
10404.5
271050
10387.5
280
10405
73710
10387
9840
10405.5
32480
10386.5
104570
10406
41220
10386
269050
10406.5
20400
10385.5
21840
10407
45460
10385
79000
10407.5
69630
10384.5
220
10408
22230
10384
71440
10408.5
30840
10383.5
44740
deribit
BTC-PERPETUAL
1599868800280000
1599868800310441
10396
48050
10395.5
18220
10396.5
22220
10395
16570
10397
100
10394.5
22630
10397.5
8360
10394
16670
10398
1500
10393.5
16570
10398.5
13210
10393
5600
10399.5
60070
10392.5
20500
10400
5100
10392
30
10400.5
5140
10391.5
75780
10401
13040
10391
12110
10401.5
2250
10390.5
280
10402
9150
10390
52680
10402.5
119390
10389.5
18240
10403
23070
10389
73010
10403.5
53930
10388.5
67500
10404
43590
10388
313140
10404.5
271050
10387.5
280
10405
73710
10387
9850
10405.5
32480
10386.5
104570
10406
41220
10386
269050
10406.5
20400
10385.5
21840
10407
45460
10385
79000
10407.5
69630
10384.5
220
10408
22230
10384
71440
10408.5
30840
10383.5
44740
deribit
BTC-PERPETUAL
1599868814801000
1599868814817631
10398.5
20
10398
7400
10399
4890
10397.5
17680
10399.5
520
10396.5
17680
10400
1700
10396
30280
10400.5
3010
10395.5
44110
10401
40
10395
20080
10401.5
2570
10394.5
91410
10402
400
10394
97570
10402.5
50530
10393.5
27510
10403
9960
10393
3330
10403.5
54250
10392.5
200
10404
40
10392
20400
10404.5
10
10391.5
75650
10405
93470
10391
9580
10405.5
32540
10390.5
260040
10406
26130
10390
310
10406.5
9670
10389.5
21210
10407
1180
10389
87320
10407.5
89030
10388.5
61140
10408
54860
10388
283120
10408.5
42430
10387.5
10680
10409
260680
10387
11400
10409.5
19220
10386.5
92470
10410
94970
10386
49640
10410.5
50
10385.5
6420
deribit
BTC-PERPETUAL
1599868814809000
1599868814817632
10398.5
20
10398
7400
10399
4890
10397.5
17680
10399.5
520
10396.5
17680
10400
1700
10396
30280
10400.5
3010
10395.5
44110
10401
40
10395
20080
10401.5
2570
10394.5
91410
10402
400
10394
97570
10402.5
50530
10393.5
27510
10403
9960
10393
3330
10403.5
54900
10392.5
200
10404
40
10392
20400
10404.5
10
10391.5
75650
10405
93470
10391
9580
10405.5
32540
10390.5
260040
10406
26130
10390
310
10406.5
9670
10389.5
21210
10407
1180
10389
87320
10407.5
89030
10388.5
61140
10408
54860
10388
283120
10408.5
42430
10387.5
10680
10409
260680
10387
11400
10409.5
19220
10386.5
92470
10410
94970
10386
49640
10410.5
50
10385.5
6420
deribit
BTC-PERPETUAL
1599868815411000
1599868815414125
10399
4910

column name	description
exchange	exchange id, one of https://api.tardis.dev/v1/exchanges (`[].id` field)
symbol	instrument symbol as provided by exchange (always uppercase)
timestamp	timestamp provided by exchange in microseconds since epoch - if exchange does not provide one `local_timestamp` value is used as a fallback
local_timestamp	message arrival timestamp in microseconds since epoch
is_snapshot	possible values: `true` - if update was a part of initial order book snapshot `false` - if update was not a part of initial order book snapshot If last update was not a snapshot and current one is, then existing order book state must be discarded (all existing levels removed)
side	determines to which side of the order book update belongs to: `bid` - bid side of the book, buy orders `ask` - ask side of the book, sell orders
price	price identifying book level being updated
amount	updated price level amount as provided by exchange, not a delta - an amount of `0` indicates that the price level can be removed

column name	description
exchange	exchange id, one of https://api.tardis.dev/v1/exchanges (`[].id` field)
symbol	instrument symbol as provided by exchange (always uppercase)
timestamp	timestamp provided by exchange in microseconds since epoch - if exchange does not provide one `local_timestamp` value is used as a fallback
local_timestamp	message arrival timestamp in microseconds since epoch
asks[0..24].price	top 25 asks prices in ascending order, empty if there aren't enough price levels available in the order book or provided by the exchange
asks[0..24].amount	top 25 asks amounts in ascending order, empty if there aren't enough price levels available in the order book or provided by the exchange
bids[0..24].price	top 25 bids prices in descending order, empty if there aren't enough price levels available in the order book or provided by the exchange
bids[0..24].amount	top 25 bids amounts in descending order, empty if there aren't enough price levels available in the order book or provided by the exchange