Freqtrade 是一款用 Python 编写的免费开源加密货币交易机器人。它旨在支持所有主流交易所，并可通过 Telegram 或 WebUI 进行控制。该工具包含回测、绘图和资金管理功能，以及基于机器学习的策略优化。

免责声明

本软件仅用于教育目的。请勿使用您不愿承受损失的资金。使用本软件的风险由您自行承担。作者及所有关联方对您的交易结果不承担任何责任。

在开始使用交易机器人之前，请务必先以“模拟运行”模式进行测试，并且在充分理解其工作原理及预期盈亏情况之前，切勿投入真实资金。

我们强烈建议您具备一定的编程和 Python 知识。请随时阅读源代码，深入理解该机器人的运作机制。

支持的交易所市场

请阅读 交易所特定说明 以了解各交易所可能需要的特殊配置。

支持的现货交易所

• Binance
• BingX
• Bitget
• Bitmart
• Bybit
• Gate.io
• HTX
• Hyperliquid（去中心化交易所，或 DEX）
• Kraken
• OKX
• MyOKX（OKX 欧亚地区）
• 可能还有许多其他交易所。（我们无法保证它们都能正常工作）

支持的期货交易所

• Binance
• Bitget
• Gate.io
• Hyperliquid（去中心化交易所，或 DEX）
• OKX
• Bybit
• Kraken

在开始使用之前，请务必阅读 交易所特定说明 以及 杠杆交易 相关文档。

经社区测试确认可用的交易所

• Bitvavo
• Kucoin

文档

我们诚邀您阅读机器人相关文档，以便更好地理解其工作原理。

完整的文档可在 Freqtrade 官网 上找到。

主要特性

• 基于 Python 3.11+：适用于 Windows、macOS 和 Linux 等所有操作系统。
• 持久化存储：通过 SQLite 实现数据持久化。
• 模拟运行：无需实际支付即可运行机器人。
• 回测功能：模拟您的买入/卖出策略。
• 基于机器学习的策略优化：利用真实交易所数据，通过机器学习优化您的买卖策略参数。
• 自适应预测建模：借助 FreqAI 构建智能策略，该策略可通过自适应机器学习方法不断自我训练以适应市场变化。了解更多
• 白名单加密货币：您可以选择特定的加密货币进行交易，或使用动态白名单。
• 黑名单加密货币：您可以指定避免交易的加密货币。
• 内置 WebUI：提供内置的 Web 界面来管理您的机器人。
• Telegram 控制：可通过 Telegram 对机器人进行管理。
• 以法定货币显示盈亏：以您选择的法定货币显示盈亏情况。
• 绩效状态报告：提供当前交易的绩效状态报告。

快速入门

有关快速上手的方法，请参阅 Docker 快速入门文档。

如需了解其他原生安装方式，请参考 安装文档页面。

基本用法

机器人命令

用法：freqtrade [-h] [-V]
                 {trade,create-userdir,new-config,show-config,new-strategy,download-data,convert-data,convert-trade-data,trades-to-ohlcv,list-data,backtesting,backtesting-show,backtesting-analysis,edge,hyperopt,hyperopt-list,hyperopt-show,list-exchanges,list-markets,list-pairs,list-strategies,list-hyperoptloss,list-freqaimodels,list-timeframes,show-trades,test-pairlist,convert-db,install-ui,plot-dataframe,plot-profit,webserver,strategy-updater,lookahead-analysis,recursive-analysis}
                 ...

免费开源的加密货币交易机器人

位置参数：
  {trade,create-userdir,new-config,show-config,new-strategy,download-data,convert-data,convert-trade-data,trades-to-ohlcv,list-data,backtesting,backtesting-show,backtesting-analysis,edge,hyperopt,hyperopt-list,hyperopt-show,list-exchanges,list-markets,list-pairs,list-strategies,list-hyperoptloss,list-freqaimodels,list-timeframes,show-trades,test-pairlist,convert-db,install-ui,plot-dataframe,plot-profit,webserver,strategy-updater,lookahead-analysis,recursive-analysis}
    trade               交易模块。
    create-userdir      创建用户数据目录。
    new-config          创建新配置文件。
    show-config         显示解析后的配置。
    new-strategy        创建新策略。
    download-data       下载回测数据。
    convert-data        将K线（OHLCV）数据从一种格式转换为另一种格式。
    convert-trade-data  将交易数据从一种格式转换为另一种格式。
    trades-to-ohlcv     将交易数据转换为K线数据。
    list-data           列出已下载的数据。
    backtesting         回测模块。
    backtesting-show    显示过去的回测结果。
    backtesting-analysis
                        回测分析模块。
    hyperopt            超参优化模块。
    hyperopt-list       列出超参优化结果。
    hyperopt-show       显示超参优化结果的详细信息。
    list-exchanges      打印可用的交易所。
    list-markets        打印交易所上的市场。
    list-pairs          打印交易所上的交易对。
    list-strategies     打印可用的策略。
    list-hyperoptloss   打印可用的超参优化损失函数。
    list-freqaimodels   打印可用的freqAI模型。
    list-timeframes     打印交易所上可用的时间周期。
    show-trades         显示交易记录。
    test-pairlist       测试您的交易对列表配置。
    convert-db          将数据库迁移到不同的系统。
    install-ui          安装FreqUI。
    plot-dataframe      绘制带有指标的K线图。
    plot-profit         生成显示利润的图表。
    webserver           Web服务器模块。
    strategy-updater    将过时的策略文件更新到最新版本。
    lookahead-analysis  检查是否存在前瞻偏差。
    recursive-analysis  检查是否存在递归公式问题。

选项：
  -h, --help            显示此帮助消息并退出。
  -V, --version         显示程序的版本号并退出。

Telegram RPC 命令

Telegram 并非强制要求。不过，这是一种控制机器人的好方法。更多详情和完整的命令列表请参阅文档。

• /start：启动交易员。
• /stop：停止交易员。
• /stopentry：停止开新仓。
• /status <trade_id>|[table]：列出所有或特定的未平仓交易。
• /profit [<n>]：列出过去 n 天内所有已完成交易的累计利润。
• /profit_long [<n>]：列出过去 n 天内所有已完成多头交易的累计利润。
• /profit_short [<n>]：列出过去 n 天内所有已完成空头交易的累计利润。
• /forceexit <trade_id>|all：立即平掉指定的交易（忽略 minimum_roi）。
• /fx <trade_id>|all：/forceexit 的别名。
• /performance：按交易对分组显示每笔已完成交易的表现。
• /balance：显示各币种的账户余额。
• /daily <n>：显示过去 n 天每天的盈亏情况。
• /help：显示帮助信息。
• /version：显示版本信息。

开发分支

该项目目前有两个主要分支：

• develop —— 此分支通常包含新功能，但也可能包含破坏性更改。我们尽力使该分支尽可能稳定。
• stable —— 此分支包含最新的稳定版。该分支通常经过充分测试。
• feat/* —— 这些是正在积极开发的功能分支。除非您想测试特定功能，否则请勿使用这些分支。

支持

帮助 / Discord

如您有任何文档未涵盖的问题，或想了解更多关于机器人的信息，亦或是希望与志同道合的人交流，欢迎加入 Freqtrade 的 Discord 服务器。

Bug / 问题

如果您发现机器人存在 bug，请先在 问题追踪器 中搜索。如果尚未有人报告，请 创建新问题，并确保遵循模板指南，以便团队能够尽快为您提供帮助。

对于每一个 问题，请务必跟进，并在达成共识后标记为已解决或提醒关闭问题。

--请遵守 GitHub 的 社区准则--

功能请求

您是否有一个很棒的想法想要分享以改进机器人？请先搜索该功能是否已经 讨论过。如果尚未有人提出请求，请 创建新请求，并确保遵循模板指南，以免被误认为是 bug 报告而淹没在众多报告中。

拉取请求

觉得机器人缺少某个功能吗？我们非常欢迎你的拉取请求！

请先阅读 贡献文档 ，了解相关要求后再提交你的拉取请求。

贡献并不一定需要编写代码——也许可以从改进文档入手呢？标有 good first issue 的问题很适合作为初次贡献，也能帮助你熟悉代码库。

注意：在开始任何重大新功能开发之前，请先创建一个议题描述你的计划，或者在 Discord 上与我们交流（请使用 #dev 频道）。这样做可以确保感兴趣的成员对你的功能提出有价值的反馈，并让其他人知道你正在开发该功能。

重要提示：请始终基于 develop 分支创建你的拉取请求，而不是 stable 分支。

要求

保持时钟同步

时钟必须准确，并且需要频繁与 NTP 服务器同步，以避免与交易所通信时出现问题。

最低硬件要求

要运行此机器人，我们建议使用至少具备以下配置的云服务器：

• 最低（推荐）系统要求：2GB 内存、1GB 磁盘空间、2 核 CPU

软件要求

• Python >= 3.11
• pip
• git
• TA-Lib
• virtualenv（推荐）
• Docker（推荐）

Freqtrade 快速上手指南

Freqtrade 是一款免费开源的加密货币交易机器人，基于 Python 开发。它支持回测、绘图、资金管理以及通过机器学习优化策略，并可通过 Telegram 或 WebUI 进行控制。

⚠️ 免责声明：本软件仅用于教育目的。请勿投入您无法承受损失的资金。作者及关联方不对您的交易结果承担任何责任。务必先使用“干跑模式”（Dry-Run）运行，在完全理解其工作原理及预期盈亏后再考虑实盘。

1. 环境准备

系统要求

• 操作系统：Windows, macOS, Linux
• Python 版本：3.11 或更高版本
• 磁盘空间：建议至少预留 5GB 空间用于存储历史数据和数据库

前置依赖

确保系统已安装以下工具：

• git
• python3 (>= 3.11)
• pip (Python 包管理器)
• docker 和 docker-compose (推荐方式，可避免环境配置问题)

国内加速建议：

• 安装 Docker 时可使用阿里云镜像加速器。
• 使用 pip 时建议配置清华源或阿里源：

  pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
  

2. 安装步骤

推荐使用 Docker 进行安装，这是最简便且兼容性最好的方式。

方法一：Docker 安装（推荐）

1. 克隆项目仓库

   git clone https://github.com/freqtrade/freqtrade.git
   cd freqtrade
   

2. 创建用户数据目录

   docker run --rm -v $(pwd)/user_data:/freqtrade/user_data freqtradeorg/freqtrade:stable create-userdir --userdir user_data
   

3. 生成配置文件

   docker run --rm -v $(pwd)/user_data:/freqtrade/user_data freqtradeorg/freqtrade:stable new-config --config user_data/config.json
   

   按提示完成配置（选择交易所、设置 API 密钥、开启 dry-run 等）。

4. 下载历史数据（可选，用于回测）

   docker run --rm -v $(pwd)/user_data:/freqtrade/user_data freqtradeorg/freqtrade:stable download-data --config user_data/config.json --days 30
   

方法二：原生安装（仅限高级用户）

如果您熟悉 Python 环境管理，可选择原生安装：

git clone https://github.com/freqtrade/freqtrade.git
cd freqtrade
python3 -m venv .venv
source .venv/bin/activate  # Windows 用户使用: .venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt
pip install -e .

注：原生安装需自行解决系统级依赖（如 TA-Lib），过程较为繁琐。

3. 基本使用

启动交易机器人（干跑模式）

确保 config.json 中 "dry_run": true，然后运行：

freqtrade trade --config user_data/config.json

若使用 Docker：

docker compose up -d
# 或者直接运行容器
docker run --rm -v $(pwd)/user_data:/freqtrade/user_data freqtradeorg/freqtrade:stable trade --config user_data/config.json

常用命令速查

功能	命令示例
创建新策略	freqtrade new-strategy --strategy MyStrategy
执行回测	freqtrade backtesting --config user_data/config.json --strategy MyStrategy
查看回测结果	freqtrade backtesting-show --config user_data/config.json
策略参数优化	freqtrade hyperopt --config user_data/config.json --strategy MyStrategy --epochs 100
启动 Web 界面	freqtrade webserver --config user_data/config.json
列出支持交易所	freqtrade list-exchanges

通过 Telegram 控制

在配置文件中启用 Telegram 后，您可以发送以下指令控制机器人：

• /start : 启动交易
• /stop : 停止交易
• /status : 查看当前持仓
• /profit : 查看累计盈亏
• /forceexit <id> : 强制平仓指定订单
• /help : 查看帮助

下一步建议

1. 阅读 官方文档 深入了解策略编写规范。
2. 使用 backtesting 功能验证您的策略在历史数据上的表现。
3. 加入 Discord 社区 与其他开发者交流经验。