Freqtrade环境搭建 - 三木羽冰

安装 Freqtrade#

1
# Download `develop` branch of freqtrade repository
2
git clone https://github.com/freqtrade/freqtrade.git
3

4
# Enter downloaded directory
5
cd freqtrade
6

7
# create virtualenv in directory /freqtrade/.venv
8
python3 -m venv .venv
9

10
# run virtualenv
11
source .venv/bin/activate
12

13
python3 -m pip install --upgrade pip
14

15
python3 -m pip install -r requirements.txt
16

17
# install freqtrade
18
python3 -m pip install -e .

验证 Freqtrade 安装#

1
# 1. 检查版本
2
freqtrade --version
3
# 输出：freqtrade 2025.9
4

5
# 2. 查看帮助信息
6
freqtrade --help
7
# 输出：显示所有可用命令

初始化 Freqtrade 项目#

1
# 1. 创建项目目录
2
mkdir ~/freqtrade-bot
3
cd ~/freqtrade-bot
4

5
# 2. 创建必要的子目录
6
freqtrade create-userdir --userdir user_data
7

8
# 3. 查看目录结构
9
tree user_data -L 2
10

11
# 输出：
12
# user_data/
13
# ├── backtest_results/
14
# ├── data/
15
# ├── freqaimodels/
16
# ├── hyperopt_results/
17
# ├── hyperopts/
18
# ├── logs/
19
# ├── notebooks/
20
# ├── plot/
21
# └── strategies/

目录说明：#

目录	用途
`strategies/`	存放交易策略文件
`data/`	存放下载的历史数据
`backtest_results/`	存放回测结果
`logs/`	存放日志文件
`hyperopts/`	存放参数优化配置
`plot/`	存放生成的图表

创建配置文件#

注意：要在freqtrade-bot文件夹下进行创建配置文件

1
# 1. 生成示例配置文件
2
freqtrade new-config --config config.json
3

4
# 系统会询问一系列问题，建议设置如下：

交互式配置（推荐设置）#

1
? Do you want to use Dry-run (simulated trades)?
2
  选择: Yes  ← 模拟交易模式
3

4
? Please insert your stake currency:
5
  输入: USDT  ← 使用 USDT 作为计价货币
6

7
? Please insert your stake amount (Number or 'unlimited'):
8
  输入: 100  ← 每笔交易 100 USDT
9

10
? Please insert max_open_trades (Integer or 'unlimited'):
11
  输入: 3  ← 最多同时持仓 3 个
12

13
? Time Have your strategy define timeframe
14
  输入: 5m  ← 使用 5 分钟时间框架
15

16
? Please insert your display currency:
17
  输入: USD  ← 显示美元
18

19
? Select exchange
20
  选择: binance  ← 选择币安交易所
21

22
? Do you want to trade Futures?
23
  选择: No  ← 暂时不做合约
24

25
? Do you want to enable Telegram?
26
  选择: No  ← 暂时不配置 Telegram
27

28
? Do you want to enable the REST API?
29
  选择: No  ← 暂时不启用 API
30

31
? Do you want to enable the Plot dataframe
32
  选择: Yes  ← 启用图表功能

生成的json：#

1
{
2
    "$schema": "https://schema.freqtrade.io/schema.json ",
3
    "max_open_trades": 3, // 最大同时持仓数量
4
    "stake_currency": "USDT", // 交易计价货币
5
    "stake_amount": 100, // 每笔交易投入金额
6
    "tradable_balance_ratio": 0.99, // 可用于交易的资金比例(99%)
7
    "fiat_display_currency": "USD", // 法币显示货币
8
    "dry_run": true, // 模拟交易模式(实盘设为false)
9
    "dry_run_wallet": 1000, // 模拟账户初始资金(USDT)
10
    "cancel_open_orders_on_exit": false, // 程序退出时是否取消未完成订单
11
    "trading_mode": "futures", // 交易模式: 期货合约
12
    "margin_mode": "isolated", // 保证金模式: 逐仓
13
    "unfilledtimeout": { // 订单超时设置
14
        "entry": 10, // 入场订单超时时间
15
        "exit": 10, // 出场订单超时时间
16
        "exit_timeout_count": 0, // 出场超时次数限制
17
        "unit": "minutes" // 超时时间单位
18
    },
19
    "entry_pricing": { // 入场价格设置
20
        "price_side": "same", // 价格方向: 同向
21
        "use_order_book": true, // 使用订单簿定价
22
        "order_book_top": 1, // 使用订单簿第1档价格
23
        "price_last_balance": 0.0, // 最新价格平衡系数
24
        "check_depth_of_market": { // 市场深度检查
25
            "enabled": false, // 是否启用
26
            "bids_to_ask_delta": 1 // 买卖盘价差阈值
27
        }
28
    },
29
    "exit_pricing": { // 出场价格设置
30
        "price_side": "same", // 价格方向: 同向
31
        "use_order_book": true, // 使用订单簿定价
32
        "order_book_top": 1 // 使用订单簿第1档价格
33
    },
34
    "exchange": { // 交易所配置
35
        "name": "binance", // 交易所名称: 币安
36
        "key": "", // API密钥
37
        "secret": "", // API密钥
38
        "ccxt_config": {}, // CCXT同步配置
39
        "ccxt_async_config": {}, // CCXT异步配置
40
        "pair_whitelist": [ // 交易对白名单
41
            "BTC/USDT",
42
            "ETH/USDT",
43
            "SOL/USDT",
44
            "XRP/USDT"
45
        ],
46
        "pair_blacklist": [ // 交易对黑名单
47
            "BNB/.*" // 排除所有BNB相关交易对
48
        ]
49
    },
50
    "pairlists": [ // 交易对列表配置
51
        {
52
            "method": "StaticPairList", // 只使用静态白名单的 pair_whitelist
53
            "number_assets": 20, // 选取前20个交易对
54
            "sort_key": "quoteVolume", // 排序依据: 计价货币交易量
55
            "min_value": 0, // 最小交易量阈值
56
            "refresh_period": 1800 // 刷新周期(秒)
57
        }
58
    ],
59
    "telegram": { // Telegram通知配置
60
        "enabled": false, // 是否启用
61
        "token": "", // Bot Token
62
        "chat_id": "" // 聊天ID
63
    },
64
    "api_server": { // API服务器配置
65
        "enabled": false, // 是否启用
66
        "listen_ip_address": "127.0.0.1", // 监听IP
67
        "listen_port": 8080, // 监听端口
68
        "verbosity": "error", // 日志详细程度
69
        "enable_openapi": false, // 是否启用OpenAPI
70
        "jwt_secret_key": "50396f9d15b36a130ea5aa1c7b3f82e890407817eb8fdf43b2a41b8625df3d64", // JWT密钥
71
        "ws_token": "bTg6lfzaXkIcPBFlF4I8HGaFPW8UjCQOYQ", // WebSocket令牌
72
        "CORS_origins": [], // 跨域来源
73
        "username": "", // 用户名
74
        "password": "" // 密码
75
    },
76
    "bot_name": "freqtrade", // 机器人名称
77
    "initial_state": "running", // 初始状态: 运行中
78
    "force_entry_enable": false, // 是否启用强制入场
79
    "internals": { // 内部参数
80
        "process_throttle_secs": 5 // 处理节流间隔(秒)
81
    }
82
}

注意事项#

现货写法：

1
        "pair_whitelist": [
2
            "BTC/USDT",
3
            "ETH/USDT",
4
            "SOL/USDT",
5
            "XRP/USDT"
6
        ],

合约写法：

1
        "pair_whitelist": [
2
            "BTC/USDT:USDT",
3
            "ETH/USDT:USDT",
4
            "SOL/USDT:USDT",
5
            "XRP/USDT:USDT"
6
        ],

回测只使用静态白名单币种：

1
"pairlists": [ // 交易对列表配置
2
        {
3
            "method": "StaticPairList", // 只使用静态白名单的 pair_whitelist

下载示例策略#

官方策略仓库：https://github.com/freqtrade/freqtrade-strategies

1
# 1. 下载官方策略仓库
2
cd user_data/strategies
3
wget https://raw.githubusercontent.com/freqtrade/freqtrade-strategies/main/user_data/strategies/Strategy001.py
4

5
# 2. 再次列出策略
6
freqtrade list-strategies -c config.json

测试数据下载#

1
# 下载 BTC/USDT 最近 7 天的 5 分钟数据
2
freqtrade download-data -c config.json --days 7 --timeframes 5m

验证数据下载成功#

1
ls user_data/data/binance/futures/
2

3

4
# 输出示列：
5
BTC_USDT_USDT-1h-funding_rate.feather  SOL_USDT_USDT-1h-funding_rate.feather
6
BTC_USDT_USDT-1h-mark.feather          SOL_USDT_USDT-1h-mark.feather
7
BTC_USDT_USDT-5m-futures.feather       SOL_USDT_USDT-5m-futures.feather
8
ETH_USDT_USDT-1h-funding_rate.feather  XRP_USDT_USDT-1h-funding_rate.feather
9
ETH_USDT_USDT-1h-mark.feather          XRP_USDT_USDT-1h-mark.feather
10
ETH_USDT_USDT-5m-futures.feather       XRP_USDT_USDT-5m-futures.feather

运行回测#

1
freqtrade backtesting -c config.json --strategy Strategy001

回测报告#

1
"D:\CodeEditor\Projects\FreqTrade\freqtrade\freqtrade-bot\user_data\backtest_results\backtest-result-2026-02-08_
2
10-44-11.meta.json"
3
Result for strategy Strategy001
4
                                              BACKTESTING REPORT
5
┏━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
6
┃               ┃        ┃              ┃                 ┃              ┃              ┃    Win  Draw  Loss ┃
7
┃          Pair ┃ Trades ┃ Avg Profit % ┃ Tot Profit USDT ┃ Tot Profit % ┃ Avg Duration ┃               Win% ┃
8
┡━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
9
│ SOL/USDT:USDT │      4 │        -1.03 │          -4.155 │        -0.42 │     19:45:00 │      3     0     1 │
10
│               │        │              │                 │              │              │               75.0 │
11
│ BTC/USDT:USDT │      5 │        -1.41 │          -5.902 │        -0.59 │     22:23:00 │      4     0     1 │
12
│               │        │              │                 │              │              │               80.0 │
13
│ ETH/USDT:USDT │      6 │        -1.04 │          -6.090 │        -0.61 │      5:10:00 │      4     0     2 │
14
│               │        │              │                 │              │              │               66.7 │
15
│ XRP/USDT:USDT │      8 │        -3.05 │         -24.376 │        -2.44 │     13:09:00 │      4     0     4 │
16
│               │        │              │                 │              │              │               50.0 │
17
│         TOTAL │     23 │        -1.82 │         -40.523 │        -4.05 │     14:13:00 │     15     0     8 │
18
│               │        │              │                 │              │              │               65.2 │
19
└───────────────┴────────┴──────────────┴─────────────────┴──────────────┴──────────────┴────────────────────┘
20
                                           LEFT OPEN TRADES REPORT
21
┏━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
22
┃               ┃        ┃              ┃                 ┃              ┃              ┃    Win  Draw  Loss ┃
23
┃          Pair ┃ Trades ┃ Avg Profit % ┃ Tot Profit USDT ┃ Tot Profit % ┃ Avg Duration ┃               Win% ┃
24
┡━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
25
│ BTC/USDT:USDT │      1 │         0.07 │           0.046 │          0.0 │     14:00:00 │      1     0     0 │
26
│               │        │              │                 │              │              │                100 │
27
│ ETH/USDT:USDT │      1 │        -0.12 │          -0.121 │        -0.01 │      0:35:00 │      0     0     1 │
28
│               │        │              │                 │              │              │                  0 │
29
│ XRP/USDT:USDT │      1 │        -0.13 │          -0.135 │        -0.01 │      0:50:00 │      0     0     1 │
30
│               │        │              │                 │              │              │                  0 │
31
│         TOTAL │      3 │        -0.06 │          -0.210 │        -0.02 │      5:08:00 │      1     0     2 │
32
│               │        │              │                 │              │              │               33.3 │
33
└───────────────┴────────┴──────────────┴─────────────────┴──────────────┴──────────────┴────────────────────┘
34
                                               ENTER TAG STATS
35
┏━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━┓
36
┃ Enter Tag ┃ Entries ┃ Avg Profit % ┃ Tot Profit USDT ┃ Tot Profit % ┃ Avg Duration ┃ Win  Draw  Loss  Win% ┃
37
┡━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━┩
38
│     OTHER │      23 │        -1.82 │         -40.523 │        -4.05 │     14:13:00 │        15     0     8 │
39
│           │         │              │                 │              │              │                  65.2 │
40
│     TOTAL │      23 │        -1.82 │         -40.523 │        -4.05 │     14:13:00 │        15     0     8 │
41
│           │         │              │                 │              │              │                  65.2 │
42
└───────────┴─────────┴──────────────┴─────────────────┴──────────────┴──────────────┴───────────────────────┘
43
                                              EXIT REASON STATS
44
┏━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
45
┃             ┃       ┃              ┃                 ┃              ┃                 ┃    Win  Draw  Loss ┃
46
┃ Exit Reason ┃ Exits ┃ Avg Profit % ┃ Tot Profit USDT ┃ Tot Profit % ┃    Avg Duration ┃               Win% ┃
47
┡━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
48
│         roi │    14 │         1.34 │          17.771 │         1.78 │         2:18:00 │     14     0     0 │
49
│             │       │              │                 │              │                 │                100 │
50
│  force_exit │     3 │        -0.06 │          -0.210 │        -0.02 │         5:08:00 │      1     0     2 │
51
│             │       │              │                 │              │                 │               33.3 │
52
│   stop_loss │     6 │       -10.07 │         -58.084 │        -5.81 │ 1 day, 22:36:00 │      0     0     6 │
53
│             │       │              │                 │              │                 │                  0 │
54
│       TOTAL │    23 │        -1.82 │         -40.523 │        -4.05 │        14:13:00 │     15     0     8 │
55
│             │       │              │                 │              │                 │               65.2 │
56
└─────────────┴───────┴──────────────┴─────────────────┴──────────────┴─────────────────┴────────────────────┘
57
                                               MIXED TAG STATS
58
┏━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓
59
┃           ┃             ┃        ┃              ┃   Tot Profit ┃              ┃              ┃   Win  Draw ┃
60
┃ Enter Tag ┃ Exit Reason ┃ Trades ┃ Avg Profit % ┃         USDT ┃ Tot Profit % ┃ Avg Duration ┃  Loss  Win% ┃
61
┡━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩
62
│           │         roi │     14 │         1.34 │       17.771 │         1.78 │      2:18:00 │    14     0 │
63
│           │             │        │              │              │              │              │     0   100 │
64
│           │  force_exit │      3 │        -0.06 │       -0.210 │        -0.02 │      5:08:00 │     1     0 │
65
│           │             │        │              │              │              │              │     2  33.3 │
66
│           │   stop_loss │      6 │       -10.07 │      -58.084 │        -5.81 │       1 day, │     0     0 │
67
│           │             │        │              │              │              │     22:36:00 │     6     0 │
68
│     TOTAL │             │     23 │        -1.82 │      -40.523 │        -4.05 │     14:13:00 │    15     0 │
69
│           │             │        │              │              │              │              │     8  65.2 │
70
└───────────┴─────────────┴────────┴──────────────┴──────────────┴──────────────┴──────────────┴─────────────┘
71
                         SUMMARY METRICS
72
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
73
┃ Metric                        ┃ Value                          ┃
74
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
75
│ Backtesting from              │ 2026-02-01 00:00:00            │
76
│ Backtesting to                │ 2026-02-08 02:30:00            │
77
│ Trading Mode                  │ Isolated Futures               │
78
│ Max open trades               │ 3                              │
79
│                               │                                │
80
│ Total/Daily Avg Trades        │ 23 / 3.29                      │
81
│ Starting balance              │ 1000 USDT                      │
82
│ Final balance                 │ 959.477 USDT                   │
83
│ Absolute profit               │ -40.523 USDT                   │
84
│ Total profit %                │ -4.05%                         │
85
│ CAGR %                        │ -88.43%                        │
86
│ Sortino                       │ -26.39                         │
87
│ Sharpe                        │ -23.15                         │
88
│ Calmar                        │ -196.76                        │
89
│ SQN                           │ -1.73                          │
90
│ Profit factor                 │ 0.31                           │
91
│ Expectancy (Ratio)            │ -1.76 (-0.24)                  │
92
│ Avg. daily profit             │ -5.789 USDT                    │
93
│ Avg. stake amount             │ 93.036 USDT                    │
94
│ Total trade volume            │ 4243.198 USDT                  │
95
│                               │                                │
96
│ Best Pair                     │ SOL/USDT:USDT -0.42%           │
97
│ Worst Pair                    │ XRP/USDT:USDT -2.44%           │
98
│ Best trade                    │ XRP/USDT:USDT 3.00%            │
99
│ Worst trade                   │ BTC/USDT:USDT -10.10%          │
100
│ Best day                      │ 5.687 USDT                     │
101
│ Worst day                     │ -26.157 USDT                   │
102
│ Days win/draw/lose            │ 2 / 2 / 4                      │
103
│ Min/Max/Avg. Duration Winners │ 0d 00:35 / 0d 14:00 / 0d 03:05 │
104
│ Min/Max/Avg. Duration Losers  │ 0d 00:35 / 3d 18:55 / 1d 11:08 │
105
│ Max Consecutive Wins / Loss   │ 13 / 3                         │
106
│ Rejected Entry signals        │ 8                              │
107
│ Entry/Exit Timeouts           │ 0 / 0                          │
108
│                               │                                │
109
│ Min balance                   │ 944.725 USDT                   │
110
│ Max balance                   │ 1000.991 USDT                  │
111
│ Max % of account underwater   │ 5.62%                          │
112
│ Absolute drawdown             │ 56.266 USDT (5.62%)            │
113
│ Drawdown duration             │ 4 days 11:05:00                │
114
│ Profit at drawdown start      │ 0.991 USDT                     │
115
│ Profit at drawdown end        │ -55.275 USDT                   │
116
│ Drawdown start                │ 2026-02-01 13:10:00            │
117
│ Drawdown end                  │ 2026-02-06 00:15:00            │
118
│ Market change                 │ -14.37%                        │
119
└───────────────────────────────┴────────────────────────────────┘
120

121
Backtested 2026-02-01 00:00:00 -> 2026-02-08 02:30:00 | Max open trades : 3
122
                                               STRATEGY SUMMARY
123
┏━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓
124
┃             ┃        ┃  Avg Profit ┃  Tot Profit ┃              ┃         Avg ┃    Win  Draw ┃             ┃
125
┃    Strategy ┃ Trades ┃           % ┃        USDT ┃ Tot Profit % ┃    Duration ┃   Loss  Win% ┃    Drawdown ┃
126
┡━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩
127
│ Strategy001 │     23 │       -1.82 │     -40.523 │        -4.05 │    14:13:00 │     15     0 │ 56.266 USDT │
128
│             │        │             │             │              │             │      8  65.2 │       5.62% │
129
└─────────────┴────────┴─────────────┴─────────────┴──────────────┴─────────────┴──────────────┴─────────────┘

音乐

安装 Freqtrade#

验证 Freqtrade 安装#

初始化 Freqtrade 项目#

目录说明：#

创建配置文件#

交互式配置（推荐设置）#

生成的json：#

注意事项#

下载示例策略#

测试数据下载#

验证数据下载成功#

运行回测#

回测报告#

支持与分享

支持博主

音乐

目录