Documentation
Exchanges and symbols
How to write the exchange and the symbol of a collection target for Tardis.dev and Databento.
Exchanges
| Provider | --exchange | Examples |
|---|---|---|
Tardis.dev (tardis) | The Tardis.dev exchange ID | binance-futures, deribit |
Databento (databento) | The Databento dataset ID, in lower case | glbx.mdp3 (CME Globex), xnas.itch (Nasdaq) |
QuantLake works out the provider from the exchange name. If it can't, for example right after the server first starts, add --source tardis or --source databento.
The same exchange and symbol from different providers are stored separately: the provider is part of the path (source=).
Symbols
Symbols are written the way each provider writes them.
| Provider | Example | Meaning |
|---|---|---|
| Tardis.dev | BTCUSDT, BTC-PERPETUAL, XYZ-SILVER | The Tardis.dev symbol ID. QuantLake converts it to upper case. |
| Databento | ESZ6, AAPL | One instrument, by its exchange symbol. |
| Databento | ES.FUT, ES.OPT | Every futures or options contract of a product. |
| Databento | ES.c.0 | A continuous contract. |
Tardis.dev
- In Tardis.dev symbol IDs,
/and:are replaced with-. For example, the Hyperliquid marketxyz:SILVERisXYZ-SILVER. Theraw_symbolcolumn keeps the exchange's name (XYZ:SILVER). - Grouped symbols, such as
PERPETUALS, are not supported.
Databento
Databento symbols keep their case.
- Single instruments, such as
ESZ6, are only available for the days on which they were listed. - Products, such as
ES.FUTandES.OPT, include every contract of the product. - Continuous contracts are written
<product>.<rule>.<rank>. The rulecrolls by calendar,nby open interest andvby volume. Rank0is the front month,1the next, and so on. For example,ES.c.0is the front-month E-mini S&P 500 contract, rolled by calendar.
For grouped and continuous symbols, the folder name (symbol=ES.c.0) is the symbol as you wrote it, and the raw_symbol column of each row holds the actual contract, such as ESZ6.
For details, see the Databento symbology.