# download.sh 使用说明

## 脚本概述

`download.sh` 是 freqtrade 的 download-data 命令的便捷包装脚本，支持本地交易对列表、API 获取、数据合并等功能。

## 默认值

- **配置文件**：`--config /freqtrade/config_examples/basic.json`（无需指定）
- **时间范围**：默认下载最近 50 天的数据（无需指定）
- **时间框架**：`--timeframe 3m,15m,30m,1h,4h,6h,12h,1d`（无需指定）
- **Prepend 模式**：默认启用（无需指定，除非要禁用）

## 核心参数

### --local-pairlist
使用代码中定义的默认交易对列表，而不是从 API 获取。

**用法：**
```bash
./download.sh --local-pairlist [其他参数]
```

**示例：**
```bash
# 最简单的用法 - 使用所有默认值
./download.sh --local-pairlist

# 覆盖下载天数
./download.sh --local-pairlist --days 100

# 指定时间框架
./download.sh --local-pairlist --timeframe 1h,4h

# 使用特定时间范围
./download.sh --local-pairlist --timerange 20250101-20250301
```

**默认交易对列表：**
```
BTC/USDT TON/USDT DOT/USDT XRP/USDT OKB/USDT SOL/USDT DOGE/USDT WCT/USDT TRUMP/USDT SUI/USDT PEPE/USDT TRB/USDT MASK/USDT UNI/USDT KAITO/USDT
```

### --pairs
直接指定交易对列表。

```bash
./download.sh --pairs BTC/USDT ETH/USDT XRP/USDT
```

## 时间范围参数

- `--timerange TIMERANGE`：指定时间范围（默认为最近 50 天）
  - 格式 1：`YYYYMMDD-YYYYMMDD`（从某日期到某日期）
    - 示例：`./download.sh --local-pairlist --timerange 20250101-20250131`
  - 格式 2：`YYYYMMDD-`（从某日期到今天）
    - 示例：`./download.sh --local-pairlist --timerange 20250101-`
  - 格式 3：`-YYYYMMDD`（从开始到某日期）
    - 示例：`./download.sh --local-pairlist --timerange -20250131`
  - 默认：如果不指定，脚本自动使用最近 50 天
    - 等同于：`--timerange YYYYMMDD-YYYYMMDD`（其中 YYYYMMDD 为 50 天前到今天）

## 其他官方参数

### 配置相关
- `--config PATH`：指定配置文件路径（默认：`/freqtrade/config_examples/basic.json`）
- `--datadir PATH`：指定数据目录
- `--exchange EXCHANGE`：指定交易所

### 数据格式
- `--data-format-ohlcv {json,jsongz,feather,parquet}`：OHLCV 数据格式
- `--data-format-trades {json,jsongz,feather,parquet}`：交易数据格式

### 下载选项
- `--timeframe TIMEFRAMES`：指定时间框架（默认：`3m,15m,30m,1h,4h,6h,12h,1d`）
- `--trading-mode {spot,margin,futures}`：交易模式
- `--new-pairs-days INT`：新交易对的下载天数

### 功能标志
- `--dl-trades`：下载交易数据而非 OHLCV 数据
- `--convert`：转换已下载的交易数据为 OHLCV
- `--include-inactive-pairs`：包含不活跃的交易对
- `--no-parallel-download`：禁用并行下载
- `--erase`：删除现有数据后重新下载
- `--prepend`：向前补充数据（默认启用）
- `--no-prepend`：禁用 prepend 模式

## 完整使用示例

```bash
# 1. 最简单 - 使用所有默认值
./download.sh --local-pairlist

# 2. 使用本地列表，下载特定时间范围
./download.sh --local-pairlist --timerange 20250101-20250201

# 3. 从某日期到今天
./download.sh --local-pairlist --timerange 20250101-

# 4. 指定交易对和时间范围
./download.sh --pairs BTC/USDT ETH/USDT --timerange 20250101-20250131 --timeframe 1h,4h

# 5. 期货交易模式，下载交易数据并转换
./download.sh --local-pairlist --trading-mode futures --dl-trades --convert

# 6. 下载并以 parquet 格式存储
./download.sh --local-pairlist --data-format-ohlcv parquet

# 7. 禁用 prepend 模式
./download.sh --local-pairlist --days 50 --no-prepend

# 8. 删除现有数据后重新下载
./download.sh --local-pairlist --erase
```

## 注意事项

- 如果同时指定了 `--pairs` 和 `--local-pairlist`，`--pairs` 参数优先
- 如果既没有指定 `--pairs` 也没有指定 `--local-pairlist`，脚本会尝试从 API 获取交易对列表
- `--local-pairlist` 参数不需要指定值，直接使用代码中定义的默认交易对列表
- 脚本使用 `--timerange` 参数，默认为最近 50 天（自动计算为 `YYYYMMDD-YYYYMMDD` 格式）
- 如需下载其他时间范围，可使用 `--timerange` 参数覆盖默认值
- 默认启用 `--prepend` 模式，如需禁用请使用 `--no-prepend`