phyer/myTestFreqAI
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
myTestFreqAI/tools/download_usage.md
zhangkun9038@dingtalk.com a21aa0bad2 update download.sh
2025-11-07 08:40:28 +08:00

4.2 KiB
Raw Blame History

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 获取。

用法：

./download.sh --local-pairlist [其他参数]

示例：

# 最简单的用法 - 使用所有默认值
./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

直接指定交易对列表。

./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 模式

完整使用示例

# 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