adelorenzo
/
stable
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
stable/docs/data-download.md

63 lines
2.8 KiB
Markdown
Raw Normal View History

Improve documentation wording
2019-09-25 04:26:28 +00:00
# Data Downloading
Improve backtesting docs
2019-09-21 08:09:14 +00:00
## Getting data for backtesting and hyperopt
To download data (candles / OHLCV) needed for backtesting and hyperoptimization use the `freqtrade download-data` command.
Some small restructuring
2019-09-24 05:05:30 +00:00
If no additional parameter is specified, freqtrade will download data for `"1m"` and `"5m"` timeframes for the last 30 days.
Exchange and pairs will come from `config.json` (if specified using `-c/--config`).
Otherwise `--exchange` becomes mandatory.
Improve backtesting docs
2019-09-21 08:09:14 +00:00
Merge branch 'develop' into backtest_docs
2019-09-26 09:04:01 +00:00
!!! Tip Updating existing data
If you already have backtesting data available in your data-directory and would like to refresh this data up to today, use `--days xx` with a number slightly higher than the missing number of days. Freqtrade will keep the available data and only download the missing data.
Be carefull though: If the number is too small (which would result in a few missing days), the whole dataset will be removed and only xx days will be downloaded.
Some small restructuring
2019-09-24 05:05:30 +00:00
### Pairs file
In alternative to the whitelist from `config.json`, a `pairs.json` file can be used.
Improve backtesting docs
2019-09-21 08:09:14 +00:00
If you are using Binance for example:
Some small restructuring
2019-09-24 05:05:30 +00:00
- create a directory `user_data/data/binance` and copy or create the `pairs.json` file in that directory.
- update the `pairs.json` file to contain the currency pairs you are interested in.
Improve backtesting docs
2019-09-21 08:09:14 +00:00
```bash
mkdir -p user_data/data/binance
cp freqtrade/tests/testdata/pairs.json user_data/data/binance
```
Add format description for pairs.json file
2019-09-24 05:07:06 +00:00
The format of the `pairs.json` file is a simple json list.
Mixing different stake-currencies is allowed for this file, since it's only used for downloading.
``` json
[
"ETH/BTC",
"ETH/USDT",
"BTC/USDT",
"XRP/ETH"
]
```
Some small restructuring
2019-09-24 05:05:30 +00:00
### start download
Improve backtesting docs
2019-09-21 08:09:14 +00:00
Then run:
```bash
freqtrade download-data --exchange binance
```
This will download ticker data for all the currency pairs you defined in `pairs.json`.
Some small restructuring
2019-09-24 05:05:30 +00:00
### Other Notes
Improve backtesting docs
2019-09-21 08:09:14 +00:00
- To use a different directory than the exchange specific default, use `--datadir user_data/data/some_directory`.
- To change the exchange used to download the tickers, please use a different configuration file (you'll probably need to adjust ratelimits etc.)
- To use `pairs.json` from some other directory, use `--pairs-file some_other_dir/pairs.json`.
- To download ticker data for only 10 days, use `--days 10` (defaults to 30 days).
- Use `--timeframes` to specify which tickers to download. Default is `--timeframes 1m 5m` which will download 1-minute and 5-minute tickers.
- To use exchange, timeframe and list of pairs as defined in your configuration file, use the `-c/--config` option. With this, the script uses the whitelist defined in the config as the list of currency pairs to download data for and does not require the pairs.json file. You can combine `-c/--config` with most other options.
## Next step
Great, you now have backtest data downloaded, so you can now start [backtesting](backtesting.md) your strategy.