QuantLake
GitHub
Documentation

Exchanges and symbols

How to write the exchange and the symbol of a collection target for Tardis.dev and Databento.

Exchanges

Provider--exchangeExamples
Tardis.dev (tardis)The Tardis.dev exchange IDbinance-futures, deribit
Databento (databento)The Databento dataset ID, in lower caseglbx.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.

ProviderExampleMeaning
Tardis.devBTCUSDT, BTC-PERPETUAL, XYZ-SILVERThe Tardis.dev symbol ID. QuantLake converts it to upper case.
DatabentoESZ6, AAPLOne instrument, by its exchange symbol.
DatabentoES.FUT, ES.OPTEvery futures or options contract of a product.
DatabentoES.c.0A continuous contract.

Tardis.dev

  • In Tardis.dev symbol IDs, / and : are replaced with -. For example, the Hyperliquid market xyz:SILVER is XYZ-SILVER. The raw_symbol column 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.FUT and ES.OPT, include every contract of the product.
  • Continuous contracts are written <product>.<rule>.<rank>. The rule c rolls by calendar, n by open interest and v by volume. Rank 0 is the front month, 1 the next, and so on. For example, ES.c.0 is 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.