OHLCV
Every OHLCV dataset can be downloaded in one of three schemas. The data is identical across schemas. Only the way rows, columns, and files are organized changes. Pick the one that matches how your code consumes the data: each schema's page shows its layout and how to load it with pandas or Polars.
- Long
- One row per asset and timestamp, with the asset in a
basecolumn. One file. - Wide
- One row per timestamp, one column per asset and field, named
BTC_close. One file. - One file per asset
- One file per asset, one row per timestamp.
Fixed bases or a universe
An OHLCV download picks its assets one of two ways:
- Fixed bases (Data set to OHLCV (fixed bases)): up to 20 assets of your choice, every candle of the period. Every interval and schema is available; 1m data comes one month at a time.
- Universe (Data set to OHLCV (universe)): every pair an exchange listed against the quote, delisted ones included, each with its candles only for the time it was listed (see Universe). This is the dataset to backtest on without survivorship bias.
A universe download follows a few rules of its own:
- The universe and the source are picked separately. The universe is always an exchange's: it selects the pairs and the slots. The candles come from the source, a single exchange or the aggregated series. Pick the same exchange for both to trade exactly what that exchange listed.
- Candles outside a listing are cut. A pair has no rows before it was listed or after it was delisted, and a pair delisted then listed again has a gap in between. The cut is the same as in the universe file of the same exchange, quote and interval, so the two always line up.
- 1h or 1d, one year or the whole history. 1h comes one year at a time, 1d covers the whole history in one download. There is no 1m: a single month of every pair at one minute would be around 18 million rows.
- Long or one file per asset. Wide is not offered: with hundreds of assets it would have thousands of mostly empty columns. One file per asset gives a
.zipwith one file per listed asset; the preview shows the first three. - Listed pairs with no candles are left out. A pair can be listed on the exchange and still have no candles in the source you picked. It is left out of the file, and the page tells you which ones.
Columns
Whatever the schema, a download covers one source, one interval and one quote currency, and every candle carries these fields. The wide schema repeats the six price and volume fields once per asset.
The examples on the next pages use the same hourly sample for BTC/USDT and ETH/USDT on 2026-10-01, so you can compare the schemas directly. To pick a schema and generate a file, open Download in the platform and set Data to OHLCV (fixed bases) or OHLCV (universe). The historical universe has its own schemas, described in Universe.