Freqtrade 教程：从零搭建你的免费加密交易机器人，先回测再实盘

Freqtrade 教程：从零搭建你的免费加密交易机器人，先回测再实盘

【免费下载链接】freqtradeFree, open source crypto trading bot项目地址: https://gitcode.com/GitHub_Trending/fr/freqtrade

如果你写过交易策略，或者收藏过一堆"别人写的策略"，大概率都卡在同一个地方：策略到底赚不赚钱，没人替你验证；就算验证过了，实盘那一下还是要人盯着 K 线手动点单，手一抖成本就没了。Freqtrade 就是一个免费、开源的加密交易机器人框架，它把"回测、模拟盘、实盘"做成了同一个工具链——你的策略只写一次，先在历史行情里跑一遍，再进模拟盘（dry-run）观察，最后才考虑要不要接真实资金。个人建议的路径就是：装好 → 跑通回测 → 模拟盘跑一周 → 才谈实盘，这篇文章就带你把前三步走完。

两条命令装好 Freqtrade

先克隆代码（需要本机有 git 和 Python 3.11+）：

git clone https://gitcode.com/GitHub_Trending/fr/freqtrade cd freqtrade ./setup.sh --install

setup.sh会自动创建虚拟环境并装依赖，装完用./setup.sh -i激活即可。如果你的环境比较折腾，官方文档里还准备了 Docker 方案（docker/ 目录 下有现成的 Dockerfile），对追求省事的新手我更推荐这条路线。

装好之后第一件事不是写策略，而是生成你的工作目录：

freqtrade create-userdir --userdir user_data

这会在user_data/下建好放配置、策略、K线数据的目录骨架，后面所有东西都往这里塞。

config.json 里最关键的 4 个字段

在user_data/下建一个config.json，不用抄全量配置（完整版可以翻 config_examples/ 里的config_full.example.json），跑通只需要这几个：

{ "max_open_trades": 3, "stake_currency": "USDT", "stake_amount": 30, "dry_run": true, "exchange": { "name": "binance", "key": "", "secret": "" } }

为什么这么配：

• dry_run: true是最重要的一个字段——开着它，机器人走完整的下单、平仓、记账流程，但用的是模拟资金。新手前期永远保持为 true，API key 可以先留空；
• max_open_trades限定同时持有的仓位数量，stake_amount是每笔投入的 USDT 数量，两个数一起决定了你的风险敞口；
• exchange先写 binance 即可，换所只需要改name。

老手提醒：真到实盘那天，API key 只开"读取 + 交易"权限，别给提现权限，并绑定服务器 IP 白名单。这一步做好了，后面很多风险都不存在了。

先回测，再谈策略

回测是 Freqtrade 最有价值的功能，也是新手的第一个分水岭。仓库自带了一个样本策略SampleStrategy，直接拿它开刀：

freqtrade download-data --pairs BTC/USDT --timeframe 1d freqtrade backtesting --strategy SampleStrategy

第一条命令把历史 K 线下载到本地（缺数据时回测也会主动提示你跑它），第二条就是回测本体，跑完会在终端打印收益统计，并导出 JSON/HTML 报告。结果别只看总收益率，建议重点盯三个数：最大回撤、单笔平均盈利、胜率——总收益很性感，但回撤告诉你"最难受的那段你会不会先割肉离场"。回测细节可以看 docs/backtesting.md。

踩坑笔记：样本策略只是演示框架用的，回测出亏损很正常，别因此怀疑自己装错了。下一步把策略换掉——用freqtrade new-strategy --strategy MyStrategy生成一个骨架，按 docs/strategy-101.md 填买卖信号；嫌手搓麻烦的话，社区仓库 Freqtrade-strategies 里有一批现成策略可以拿来改。

模拟盘：让机器人替你值一周的班

回测漂亮之后，别急着上真钱。直接以模拟盘模式跑：

freqtrade trade --config user_data/config.json --strategy MyStrategy

因为dry_run: true，这一整周机器人会实时拉取行情、真实地按你的策略买卖（虚拟资金），日志里能看到完整的决策过程。这一周你主要看三件事：实际信号频率和回测是否一致、有没有频繁报交易所错误、止损/止盈有没有按预期触发。

进阶装备：跑通之后的路线

真正跑起来之后，你会发现 Freqtrade 的生态能补上不少短板：

• FreqUI：图形化界面，回测结果、实时持仓、策略配置都能可视化，官方文档在 docs/freq-ui.md；
• Hyperopt：内置的参数优化器，让 Freqtrade 替你搜策略参数，不用自己网格搜索，用法见 docs/hyperopt.md；
• FreqAI：如果想上机器学习预测模型，它提供了从特征工程到 LightGBM/PyTorch 模型的一整套组件；
• ft_client：仓库里的 Python REST 客户端，方便你把机器人接进自己的脚本或告警系统。

下一步：给它定个规矩

别问"什么时候可以实盘"，先给自己定验收标准：模拟盘跑满至少一周，期间信号稳定、无异常报错、回撤在可接受范围——满足这三条再开dry_run: false，并且先用最小仓位试水。策略没有"跑通了"这回事，只有"还在验证中"这回事，把 Freqtrade 当成一个需要你持续复盘的工具，而不是一个自动印钞机。

【免费下载链接】freqtradeFree, open source crypto trading bot项目地址: https://gitcode.com/GitHub_Trending/fr/freqtrade