Skip to content

download


command download

Download OHLCV bar data for one or more symbols and persist it locally.

Fetches open/high/low/close/volume bars from the configured data provider and stores them in the local database. Any currency conversion legs required by the requested symbols are resolved and downloaded automatically. Already cached bars are skipped, so it is safe to re-run the command to top up an existing dataset.

Read more in the user guide.

Parameters

symbols : tuple[str, ...]

One or more ticker symbols to download (e.g., AAPL, BTC-USD). Multiple symbols can be listed space-separated.

--instrument_type, -t : str, default="stocks"
Asset class of the requested symbols. Choose from stocks, etf, forex or crypto. All symbols in a single invocation must belong to the same instrument type.

--interval, -i : tuple[str, ...], default="1d"
One or more bar intervals to download. The flag can be repeated to fetch several resolutions in one call (e.g., -i 1d -i 1h). Supported values are: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1wk.

--start, -s : str | None, default=None
Earliest bar to include, expressed as a Unix timestamp in seconds. When omitted the provider's maximum available history is downloaded.

--end, -e : str | None, default=None
Latest bar to include, expressed as a Unix timestamp in seconds. Defaults to the current time when omitted.

--log_level, -l : str, default="warn"
Minimum log level to emit. Choose from: error, warn, info or debug.

--verbose/--no-verbose, -v : bool, default=True
Whether to display a progress bar while bars are being downloaded.


See Also

download_bars

Download OHLCV data for the instruments described in a list of profiles.

resolve_profiles

Resolve the instrument profiles needed to download a set of symbols.

run-experiment

Run a backtest experiment defined in a configuration file.


Example

Download the full available daily history for a single stock:

backtide download AAPL

Download both daily and hourly bars for several crypto symbols:

backtide download BTC-USD ETH-USD -t crypto -i 1d -i 1h

Download forex bars starting from a specific date:

backtide download EUR-USD -t forex --start 1672531200