在 TradingHost 部署 Freqtrade 策略
在持续在线的 TradingHost 运行环境中，运行来自 GitHub 的开源 Freqtrade 策略。
Freqtrade 是一个支持回测、hyperopt、FreqAI、dry-run 和 live 执行的 Python 加密货币交易框架。TradingHost 为该策略提供生产级的运行环境。
- GitHub 原生部署
- 支持 10+ 家交易所
- 支持回测、hyperopt 和 FreqAI
- 支持 dry-run 和 live 模式
- 支持 Telegram 和 WebUI 访问
- 持续在线的运行环境
- 加密存储的 API 密钥
- 邻近交易所的部署区域
- 支持 MCP
简介
刚接触 Freqtrade？
Freqtrade 是一个用 Python 编写的免费开源加密货币交易框架。它开箱即用，提供完整的交易闭环：策略接口、回测器、超参数优化器、模拟交易模式、Telegram 接口、内置 Web UI，以及针对您所选交易所的实盘执行。
您只需编写规则，Freqtrade 会处理 K 线数据摄取、指标计算、下单、仓位跟踪和报告。在底层，交易所连接使用 CCXT 库，因此其支持的交易所列表与 CCXT 支持的主流加密货币交易场所一致。
Freqtrade 采用 GPL-3.0 许可协议，由社区积极维护，并具有明确的教育性质。在回测中表现良好的策略并不意味着在实盘中也能自动盈利。该框架为您提供了辨别差异的工具：针对历史 K 线的回测、用于调整参数的 hyperopt、针对实时市场数据进行模拟交易的 dry-run，以及用于自适应机器学习预测的 FreqAI。
TradingHost 是 Freqtrade 策略的生产级运行场所。您无需将策略运行在个人电脑或通用的 VPS 上，而是直接将 Freqtrade 仓库部署到 TradingHost 云端运行环境。它能保持持续在线，将您的交易所 API 密钥作为加密机密进行管理，并将日志实时推送给您。
章节 01 · 一览
一览
- Freqtrade 定义
- 开源 Python 加密货币交易框架，采用 GPL-3.0 许可
- 维护者
- GitHub 上的 Freqtrade 项目
- 编程语言
- Python
- 交易市场
- 加密货币现货与期货
- 交易所连接
- CCXT 底层支持；官方文档支持 10+ 家交易场所
- 运行模式
- Backtest、hyperopt、dry-run、live、FreqAI
- 操作界面
- Telegram、内置 WebUI、CLI
- 部署来源
- GitHub
- TradingHost 职责
- 提供运行环境、部署、日志、机密管理、区域选择
- Freqtrade 职责
- 提供策略框架、执行循环、回测器、优化器
- 关联关系
- TradingHost 是独立平台，与 Freqtrade 项目无任何关联
- 最佳适用场景
- 多交易所加密货币策略、基于技术指标的入场、通过 FreqAI 实现的机器学习辅助交易
章节 02 · Freqtrade 的定位
Freqtrade 在交易技术栈中的定位
Freqtrade 是一个基于 CCXT 的、有特定设计主张的策略框架。CCXT 负责交易所连接，Freqtrade 是调用它的策略框架，而您的策略类则是运行在框架内部的交易逻辑。
这为您提供了两个互补的切入点：
路径 01
策略类
在 Python 中继承 IStrategy 类。定义技术指标、入场规则、出场规则、止损和时间框架。Backtest、hyperopt、dry-run 和 Live 均使用同一个策略文件。
路径 02
FreqAI 模块
叠加 FreqAI 模块，针对您的特征训练模型，并在滚动窗口上进行重训。策略类将模型预测结果作为另一个普通指标来调用。
无论选择哪种路径，在 TradingHost 上的运行方式都完全相同。您只需提供 Freqtrade 的 GitHub 仓库，其余的由我们来运行。
- 您
- 您的策略类决定交易规则。
- Freqtrade
- 运行策略循环、回测器、优化器和 dry-run。
- CCXT
- 标准化 Freqtrade 底层的交易所 API。
- TradingHost
- 运行策略进程、管理密钥、流式传输日志。
第 03 节 · 为什么选择 TradingHost
为什么在 TradingHost 上部署 Freqtrade
实盘运行的 Freqtrade 实例需要持续运行、保存您的交易所 API 密钥，并保持与 Telegram 或 WebUI 指令的连通。在笔记本电脑、台式机或通用 VPS 上运行会带来运维负担，包括进程监控、重启、依赖管理、日志分散以及手动部署等问题。
TradingHost 为 Freqtrade 策略提供了一个面向生产环境的运行时，专为长期运行的交易进程而设计。
您将获得
- GitHub 原生部署
- 持续运行的容器运行时
- 单个运行时内支持多策略
- 加密的交易所 API 密钥存储
- 靠近交易所的区域选择
- 流式日志与基础健康状态监控
- 策略级的启动、停止、重启与检查
- 更新单个策略而无需重启运行时
- 兼容 MCP 的 AI IDE 工作流
您保留的控制权
- 对 Freqtrade 策略代码的完整控制权
- 对交易所账户和 API 权限的直接所有权
- 自由选择 Freqtrade 运行模式：backtest、hyperopt、dry-run、FreqAI、live
第 04 节 · 支持的交易所
支持的交易所
Freqtrade 官方文档中明确支持十家加密货币交易所的现货和期货市场。由于底层使用 CCXT 进行连接，实际支持的范围更广，但官方文档列出的矩阵仍是生产部署的唯一可靠依据。
下方列出了五个热门的配对。如需查看支持的加密货币交易场所完整目录，请参阅 /brokers/crypto/。
- Freqtrade
- 您的交易所
- TradingHost 运行时
Freqtrade 官方文档还支持 Bitget, BingX, Bitmart, HTX, Hyperliquid, MyOKX 以及其他经过社区测试的交易场所。您可以在完整的加密货币经纪商目录中找到您的交易所。
浏览加密货币交易所目录章节 05 · 部署流程
Freqtrade 部署工作原理
在 TradingHost 上部署 Freqtrade 策略，其流程与任何基于 GitHub 的项目完全一致。
- 步骤 01
连接或创建代码库
使用 GitHub 登录并连接现有的 Freqtrade 策略代码库，或者直接使用 TradingHost 提供的 Freqtrade 模板（已配置好常用默认设置）新建一个。
- 步骤 02
配置运行环境
TradingHost 会读取您项目的运行环境配置，以此来安装依赖并以您指定的模式启动 Freqtrade。
- 步骤 03
添加加密的交易所 API 密钥
将您的交易所 API 密钥添加为 TradingHost 凭据（Secrets）。这些密钥会被加密，并在启动时注入运行环境，绝不会写入您的代码库中。
/platform/secrets/ - 步骤 04
选择部署地域
选择一个靠近交易所撮合引擎的地域。例如，交易 Binance 现货选择 AWS Tokyo，交易多数欧洲交易所则选择 AWS Frankfurt。
/platform/regions/ - 步骤 05
部署
TradingHost 会在托管容器中启动 Freqtrade。日志将实时流式传输至控制面板。Telegram 和 WebUI 将按您的配置正常运行。
/platform/observability/
章节 06 · Freqtrade 运行模式
Backtest、Hyperopt、Dry-run、FreqAI、Live
Freqtrade 采用“单一策略文件，五种运行模式”的设计。同一套代码路径可直接运行于 Backtest、Hyperopt、Dry-run、FreqAI 和 Live 模式。这种设计非常契合长期运行策略所需的“先演练、后实盘”工作流。
所有五种模式均可在同一个 TradingHost 运行环境中执行。您可以在启动时选择模式，也可以将它们作为独立的策略进程并排运行。
章节 07 · 我们的业务边界
TradingHost 不提供哪些服务
- TradingHost 不是您的交易所。
- TradingHost 不提供交易策略或财务建议。
- TradingHost 不会修改您的 Freqtrade 配置或策略代码。
- TradingHost 不会托管您的交易所 API 密钥（仅在运行环境启动时进行加密注入）。
- TradingHost 不保证策略表现、交易所正常运行时间或市场连接稳定性。
章节 08 · 常见问题
常见问题
没有。TradingHost 是独立的平台。Freqtrade 是开源、采用 GPL-3.0 许可协议的软件，由 GitHub 上的 Freqtrade 项目团队维护。
Python。您需要将策略编写为继承自 IStrategy 的 Python 类。同一个类可直接用于 Backtesting、Hyperopt、Dry-run、FreqAI 和 Live 交易。
根据 Freqtrade 官方文档，其支持 Binance、BingX、Bitget、Bitmart、Bybit、Gate.io、HTX、Hyperliquid, Kraken、OKX 和 MyOKX，并在 Binance、Bitget、Bybit、Gate.io、Hyperliquid、OKX 和 Kraken 上支持期货交易。Bitvavo 和 KuCoin 则属于社区测试支持。
是的。Freqtrade 底层通过 CCXT 实现交易所连接，因此其支持的交易所列表与 CCXT 支持的主要加密货币交易场所一致。
FreqAI 是 Freqtrade 内置的自适应机器学习模块。它会针对您定义的特征训练预测模型，在滚动窗口上进行重训，并将预测结果作为输入提供给您的策略类。
可以。一个 TradingHost 运行环境可以托管多个 Freqtrade 进程。常见的做法是使用不同的配置文件，同时运行一个 Dry-run 实例和一个 Live 实例。
您只需将它们作为加密密钥（secrets）添加到 TradingHost。这些密钥会在启动时注入 Freqtrade 运行环境，绝不会写入您的代码仓库。
不会。Freqtrade 通过您的交易所 API 凭证直接下单。TradingHost 仅负责运行 Freqtrade 进程并实时传输日志。
可以。内置的 WebUI 和 Telegram 接口是 Freqtrade 的一部分，它们会按照您的配置正常工作。TradingHost 负责运行底层进程并开放所需的网络连接。
不适用。Freqtrade 是专为加密货币交易所设计的。如需交易非加密货币市场，请参阅 /frameworks/nautilustrader/ 或 /frameworks/backtrader/。
部署您的首个 Freqtrade 策略
连接 GitHub，选择 Freqtrade 模板或您自己的策略仓库，添加交易所 API 密钥，选择运行区域，即可在 TradingHost 运行环境中启动。