Back to catalog / Crypto quant workflows
Download historical candles for a selected market and timeframe
Fetch OHLCV for one fixed pair and confirm the requested range.
Goal
Prepare a complete, reproducible local candle dataset.
Steps
- Choose exchange, exact pair, timeframe, and UTC date range. [download]
- Run
freqtrade download-data --exchange binance --pairs BTC/USDT --timeframes 1h --timerange 20240101-20250101. [download] - Run
freqtrade list-data --show-timerangeand record pair, timeframe, coverage, command, and data-directory snapshot. [download]
How to verify
`list-data` shows the requested pair/timeframe and covers the backtest range.
Troubleshooting
If no data appears, check exchange timeframe support, pair syntax, and network; do not silently substitute another pair.
Permissions
Prerequisites
- Python 3.11+, Freqtrade installed, a pinned strategy, and a local user-data directory.
Permissions
- Use public market data and local history; treat every trading decision as research and never connect a live account.
Limitations
History depth, delisted pairs, and candle revisions affect coverage; data availability says nothing about strategy quality.
Pinned upstream source
- Repository
- freqtrade/freqtrade
- File path
- docs/data-download.md
- Pinned commit
82e4c9604c51523f7e05c5a297167cf2b13a2129- Source checked
- 2026-10-14 · Reviewed against the pinned upstream source
Repository metrics
These values describe the upstream repository, not popularity or likes for an individual skill or playbook.
- Stars
- Not collected
- Forks
- Not collected
- Observed at
- Not collected
No metrics snapshot is available yet.
License: GPLv3
Main topic
Build a reproducible crypto research workflow