免费跑通一个加密交易机器人:Freqtrade 从安装到首次回测的 5 步完整指南
【免费下载链接】freqtradeFree, open source crypto trading bot项目地址: https://gitcode.com/GitHub_Trending/fr/freqtrade
Freqtrade 是一个用 Python 编写的免费开源加密货币交易机器人,它能帮你把交易策略在历史 K 线上回测出结果,再用模拟盘(dry-run)或实盘自动执行。如果你不想自己搭一套"数据下载 + 策略框架 + 下单执行 + 绩效统计"的完整系统,它把这些事一次性都做了。
搞懂 Freqtrade 的 4 个核心能力
Freqtrade 替你解决的是"策略从想法到验证再到自动执行"的整条链路,具体分 4 块:
- 回测与数据工具:
backtesting命令用历史 K 线模拟你的买卖策略,利润计算自动扣除交易所手续费;download-data负责把历史数据拉进本地。详见 回测文档。 - 模拟盘(dry-run):不花一分钱跑真实行情、真实下单逻辑,适合验证策略行为。
- 实盘与策略优化:支持 Binance、Kraken、OKX、Bybit、Gate 等主流现货/合约交易所,还内置 hyperopt 超参优化和 FreqAI 机器学习模块。
- 远程操控:通过 Telegram 机器人或内置 WebUI 管理,
/start、/stop、/status这些命令在手机上就能发。
10 分钟完成安装与首次回测
📦 3 步装好环境
前提:Linux/macOS 上装好 Python 3.11+ 和 git(脚本会帮你装 TA-Lib 等依赖)。Windows 用户官方更推荐直接用 Docker,装完重启一次系统避免网络问题。
git clone https://gitcode.com/GitHub_Trending/fr/freqtrade cd freqtrade ./setup.sh -i source .venv/bin/activate克隆下来默认是develop分支(新功能多),求稳可以git checkout stable。装完后每次开新终端都要执行最后一行激活虚拟环境。
⚙️ 配置文件的 4 个必填项
运行交互式向导生成配置文件,它会问清交易所、币种、模拟盘还是实盘:
freqtrade create-userdir --userdir user_data freqtrade new-config --config user_data/config.json生成后打开user_data/config.json,先盯住 4 个字段:
{ "max_open_trades": 3, "stake_currency": "USDT", "stake_amount": 30, "dry_run": true, "exchange": { "name": "binance", "pair_whitelist": ["ETH/USDT", "LTC/USDT"] } }dry_run保持true(模拟盘),exchange.name改成你的交易所,pair_whitelist填要交易的币对——新手建议先放 2-3 个流动性好的。全部字段的含义可参考 config_examples/config_binance.example.json,交易所特有的坑在 docs/exchanges.md 里有逐一说明。
🧪 下载数据并跑通第一次回测
回测需要先有历史 K 线,下面两条命令分别负责"备数据"和"跑策略":
freqtrade download-data --pairs ETH/USDT LTC/USDT -t 5m --days 30 freqtrade backtesting --strategy SampleStrategy-t 5m指定 5 分钟 K 线,--days 30只拉 30 天,几分钟就能下完。仓库自带的SampleStrategy只是演示用的示例,回测结果只用来熟悉流程。数据落在user_data/data/,回测结果输出到user_data/backtest_results/,你的新策略则放在 user_data/strategies/ 目录下。
确认流程跑通后,启动模拟盘只需一条命令:
freqtrade trade --config user_data/config.json --strategy SampleStrategy用在哪、坑在哪:3 个场景与 4 个高频坑
适合它的场景:
- 策略验证:任何想法先回测,再用 hyperopt 自动搜索参数组合,避免拍脑袋定阈值。
- 7x24 自动执行:加密市场周末不休市,机器人按你定义的策略全天候盯盘下单,Telegram 随时查
/status、/profit。 - 机器学习策略:觉得写规则太累,FreqAI 模块能用 LightGBM、XGBoost 等模型自动学习市场模式,配置参考 docs/freqai.md。
新手最容易踩的 4 个坑:
- ⚠️拿示例策略直接实盘:
SampleStrategy官方明确标注只是 demo,任何策略上实盘前必须先回测 + 跑一段时间 dry-run。 - 交易所不通用:不同交易所的 API 细节、下单限制各不相同,换交易所前一定读 docs/exchanges.md 的对应章节。
- Windows 原生安装:官方强烈建议 Windows 用户走 Docker,否则装依赖和 32 位 Python 内存限制会反复卡住你。
- 系统时钟不准:bot 对时钟敏感,跑在 VPS 上要确保 NTP 同步,否则交易所通信会出错。
回测完可以顺手执行freqtrade plot-profit,把收益曲线画出来直观判断策略质量,参数见 docs/plotting.md。
把 FreqUI、FreqAI 和 REST 客户端用起来
- FreqUI 网页界面:配置里把
api_server.enabled设为true并启动 webserver,浏览器打开localhost:8080就能看到实时交易面板,还能直接在页面上发起回测。用法见 docs/freq-ui.md。 - FreqAI 自适应预测:给机器人接上会自我再训练的 ML 模型,官方内置了 LightGBM、XGBoost、PyTorch 等现成模型,入口在 freqtrade/freqai/ 目录。
- ft_client REST 客户端:想用自己的脚本监控机器人,
ft_client/里提供了 Python REST 客户端封装,配合 rest-api.md 使用。 - 插件体系:币种筛选(pairlist)和各种交易保护(protections,如冷却期、最大回撤保护)都在 freqtrade/plugins/ 下,按需往配置里加即可。
先别急着写策略:把上面的回测和 dry-run 各跑通一遍,确认日志、数据库(user_data/tradesv3.sqlite)和 UI 都能正常访问,再谈优化买卖规则。
【免费下载链接】freqtradeFree, open source crypto trading bot项目地址: https://gitcode.com/GitHub_Trending/fr/freqtrade
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考