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

免责声明

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

始终先以模拟交易（Dry-Run）模式运行交易机器人，在了解其工作原理以及预期的盈亏情况之前，不要投入真实资金。

我们强烈建议您具备编程和 Python 知识。请务必阅读源代码，了解本机器人的运行机制。

支持的交易所市场

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

支持的现货交易所

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

支持的期货交易所

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

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

社区测试通过

经社区确认可正常使用的交易所：

• Bitvavo
• Kucoin

文档

我们建议您阅读机器人文档，以确保了解机器人的工作原理。

完整文档请参见 freqtrade 官网。

功能

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

快速开始

请参考 Docker 快速入门文档 了解如何快速开始使用。

如需其他（原生）安装方法，请参阅 安装文档页面。

基本使用

机器人命令

usage: 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}
                 ...

Free, open source crypto trading bot

positional arguments:
  {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               Trade module.
    create-userdir      Create user-data directory.
    new-config          Create new config
    show-config         Show resolved config
    new-strategy        Create new strategy
    download-data       Download backtesting data.
    convert-data        Convert candle (OHLCV) data from one format to
                        another.
    convert-trade-data  Convert trade data from one format to another.
    trades-to-ohlcv     Convert trade data to OHLCV data.
    list-data           List downloaded data.
    backtesting         Backtesting module.
    backtesting-show    Show past Backtest results
    backtesting-analysis
                        Backtest Analysis module.
    hyperopt            Hyperopt module.
    hyperopt-list       List Hyperopt results
    hyperopt-show       Show details of Hyperopt results
    list-exchanges      Print available exchanges.
    list-markets        Print markets on exchange.
    list-pairs          Print pairs on exchange.
    list-strategies     Print available strategies.
    list-hyperoptloss   Print available hyperopt loss functions.
    list-freqaimodels   Print available freqAI models.
    list-timeframes     Print available timeframes for the exchange.
    show-trades         Show trades.
    test-pairlist       Test your pairlist configuration.
    convert-db          Migrate database to different system
    install-ui          Install FreqUI
    plot-dataframe      Plot candles with indicators.
    plot-profit         Generate plot showing profits.
    webserver           Webserver module.
    strategy-updater    updates outdated strategy files to the current version
    lookahead-analysis  Check for potential look ahead bias.
    recursive-analysis  Check for potential recursive formula issue.

options:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit

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 服务器。

错误 / 问题

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

对于创建的每个问题，请在问题得到解决或达成共识后跟进并标记满意度，或提醒关闭问题。

--请遵守 GitHub 的社区政策--

功能请求

您是否有改善机器人的好点子想要分享？请先搜索此功能是否已在过往讨论中提及。若尚未有人提出，请创建新请求，并确保遵循模板指南，以免在错误报告中被忽略。

拉取请求

觉得机器人缺少某项功能？我们欢迎您提交拉取请求！

在提交拉取请求前，请阅读贡献文档，了解相关要求。

贡献并非一定要编写代码——或许可以从改进文档开始？标记为good first issue的问题是很好的入门贡献，有助于您熟悉代码库。

注意：在开始任何重大新功能开发前，请先创建一个 issue 描述您的计划，或在 Discord 上与我们交流（请使用 #dev 频道）。这能确保相关人士对该功能提供宝贵反馈，并让其他人知晓您正在进行此项工作。

重要提示：务必将您的 PR 提交至 develop 分支，而非 stable 分支。

要求

时钟同步

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

最低硬件要求

我们建议您使用满足以下最低配置的云服务器来运行此机器人：

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

软件要求

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