在 TradingHost 上部署 Hummingbot
在全天候运行的 TradingHost 运行环境上,直接运行来自 GitHub 的开源 Hummingbot。
Hummingbot 是一个做市和流动性框架,拥有连接 30 多个中心化和去中心化交易场所的原生连接器。TradingHost 为该策略提供生产级的运行环境。
- GitHub 原生部署
- CLOB CEX、CLOB DEX、AMM DEX
- 原生连接器(不依赖 CCXT)
- V2 Scripts 与 V2 Controllers
- Pure Market Making 与 Cross-Exchange Market Making
- 全天候运行环境
- 加密 API 密钥
- 邻近交易所的区域部署
- 支持 MCP
介绍
刚接触 Hummingbot?
Hummingbot 是一个免费且开源的做市和流动性框架。它专为持续在市场双边报价、在不同交易场所之间套利或向 AMM 资金池提供流动性的策略而设计,而非用于基于方向性指标的交易。
该框架内置了连接 30 多个交易所的原生连接器,涵盖三大类:CLOB 中心化交易所(Binance、Coinbase、Kraken、Bybit、OKX、KuCoin 等)、CLOB 去中心化交易所(dYdX、Hyperliquid、Vertex、Injective Helix)以及 AMM DEX 集成(Uniswap、Raydium、PancakeSwap、Curve、Jupiter 等)。这些连接器由 Hummingbot 直接编写和维护,不通过 CCXT。
Hummingbot 采用 Apache 2.0 许可协议,并由 Hummingbot Foundation 托管。这是一种社区治理模式,交易所和贡献者通过公开提案为连接器和策略开发提供资金。
TradingHost 是 Hummingbot 的生产级运行环境。与其将客户端留在笔记本电脑或普通的 VPS 上(网络波动意味着错失报价),不如将您的 Hummingbot 配置部署到 TradingHost 云端运行环境中。它能保持持续在线,将您的交易所 API 密钥作为加密机密进行管理,并将日志实时传输给您。
第 01 节 · 一览
一览
- Hummingbot 是什么
- 开源做市和流动性框架,采用 Apache 2.0 许可协议
- 托管机构
- Hummingbot Foundation(社区治理)
- 编程语言
- Python(带有 Cython 性能模块)
- 市场
- 加密货币现货、永续合约、AMM 和 CLOB DEX
- 连接器
- 原生,不依赖 CCXT。涵盖 CLOB CEX、CLOB DEX、AMM DEX 的 30 多个交易场所
- 策略类型
- V2 Scripts、V2 Controllers、传统 V1 策略
- 操作界面
- CLI 客户端、Hummingbot Dashboard、Telegram 桥接
- 部署源
- GitHub
- TradingHost 的角色
- 运行环境、部署、日志、机密管理、区域选择
- Hummingbot 的角色
- 策略框架、原生交易所连接器、订单管理
- 隶属关系
- TradingHost 保持独立,不隶属于 Hummingbot Foundation
- 最适合
- Pure Market Making、Cross-Exchange Market Making、AMM-CEX 套利、永续合约做市
第 02 节 · Hummingbot 的定位
Hummingbot 在交易技术栈中的定位
Hummingbot 是一个自包含的做市客户端。它内置了针对中心化和去中心化交易所的原生连接器,因此不依赖 CCXT,也得以支持 CCXT 无法覆盖的 AMM DEX 集成。
您可以在 TradingHost 上以两种方式部署 Hummingbot:
路径 01
开箱即用策略
选择内置策略(Pure Market Making、Cross-Exchange Market Making、AMM-Arb、永续合约做市)并进行配置。使用这些经典策略无需编写代码。
路径 02
自定义脚本或控制器
编写用于单实例策略的 V2 Script,或用于生产级多交易对、多实例设置的 V2 Controller。在 Python 中继承 StrategyV2Base。
无论选择哪种路径,在 TradingHost 上的运行方式都完全相同。您提供 Hummingbot GitHub 仓库,我们来运行。
- 您
- 您的策略或配置决定了报价和执行规则。
- Hummingbot
- 运行策略循环、原生交易所连接器和订单管理。
- 交易所
- 您的交易所账户或 DEX 钱包接收订单。
- TradingHost
- 运行 Hummingbot 客户端、管理密钥并流式传输日志。
章节 03 · 为什么选择 TradingHost
为什么在 TradingHost 上部署 Hummingbot
做市对在线率的要求极高。几秒钟的掉线就意味着报价过期、不利成交以及风险库存偏离目标。在笔记本电脑或通用 VPS 上运行 Hummingbot 会带来运维负担,包括进程监控、重启、依赖管理、日志分散和手动部署。
TradingHost 为 Hummingbot 客户端提供了一个专为长期运行的交易进程设计的生产级运行环境。
您将获得
- GitHub 原生部署
- 保持常开的容器运行环境,不受笔记本电脑休眠影响
- 单个运行环境中支持多实例
- 加密的交易所 API 密钥存储
- 靠近撮合引擎的区域选择
- 流式日志与基础健康状况监控
- 策略级的启动、停止、重启与检查
- 无需重启运行环境即可更新单个实例
- 兼容 MCP 的 AI IDE 工作流
您保留的内容
- 对 Hummingbot 配置和策略代码的完全控制权
- 对交易所账户和 API 权限的直接所有权
- 自由选择策略类:V2 Script、V2 Controller 或传统的 V1
章节 04 · 支持的交易场所
支持的交易场所
Hummingbot 内置了三大类原生连接器:CLOB CEX、CLOB DEX 和 AMM DEX。同一个 Hummingbot 客户端可以针对其中任何一类运行报价策略。
以下展示了五个精选配对。完整的目录见后文。
- Hummingbot
- 您的交易场所
- TradingHost 运行环境
Hummingbot 还内置了针对许多其他交易场所的原生连接器,按类别分组如下:
- CLOB CEX
- Kraken, OKX, KuCoin, Gate.io, HTX, BitMart, Bitget, BingX, Bitrue, Bitstamp, BTC Markets, AscendEx, MEXC
- CLOB DEX
- dYdX, Derive, XRP Ledger, Dexalot, Injective Helix, Vertex
- AMM DEX
- Raydium, PancakeSwap, Curve, SushiSwap, Balancer, QuickSwap, Trader Joe, Meteora, Jupiter, 0x Protocol
第 05 节 · 部署流程
Hummingbot 部署工作原理
在 TradingHost 上部署 Hummingbot 客户端与部署任何基于 GitHub 的项目流程相同。
- 步骤 01
连接或创建代码库
使用 GitHub 登录并连接现有的 Hummingbot 代码库(包含您的配置以及任何自定义的 V2 Scripts 或 V2 Controllers),或者直接从 TradingHost 的 Hummingbot 模板创建。
- 步骤 02
配置运行环境
TradingHost 会读取您项目的运行环境配置和 Hummingbot 配置文件,以确定如何安装依赖项并在无界面(headless)模式下启动客户端。
- 步骤 03
添加加密的交易所 API 密钥
将交易所 API 密钥(以及任何 DEX 钱包凭证)添加为 TradingHost 凭据(secrets)。它们会被加密,在启动时注入运行环境,且绝不会写入您的代码库。
/platform/secrets/ - 步骤 04
选择部署区域
选择靠近您交易场所撮合引擎的区域。例如,针对 Binance Spot 选择 AWS Tokyo,针对许多欧洲交易所选择 AWS Frankfurt,针对 AMM 策略选择对 DEX 友好的区域。
/platform/regions/ - 步骤 05
部署
TradingHost 会在托管容器中启动 Hummingbot。日志将实时流式传输回控制台。配置完成后,Hummingbot Dashboard 将与策略进程并行运行。
/platform/observability/
第 06 节 · 策略形态
Scripts、V2 Controllers 与历史遗留策略
Hummingbot 为生产环境策略提供了三种形态。策略形态决定了您需要运行多少个进程、编写多少代码,以及运行环境需要承载的复杂度。
这三种形态均运行在相同的 TradingHost 运行环境上。生产环境中的常见模式是:一个运行环境托管一个 V2 Controller,并在其内部运行多个交易对。
第 07 节 · 我们的服务边界
What TradingHost does not do
- TradingHost 不充当您的交易所或 DEX。
- TradingHost 不提供做市策略、参数或财务建议。
- TradingHost 不会修改您的 Hummingbot 配置、脚本或控制器。
- 除了在运行环境中进行加密注入外,TradingHost 不会托管您的交易所 API 密钥或 DEX 钱包。
- TradingHost 不保证成交质量、交易所正常运行时间或市场连接性。
第 08 节 · 常见问题
FAQ
不隶属。TradingHost 是独立的。Hummingbot 是一款开源、采用 Apache 2.0 许可协议的软件,由 Hummingbot Foundation 通过社区治理进行管理。
不使用。Hummingbot 内置了其自研的原生交易所连接器,这也是为什么其支持列表中包含了 CCXT 无法覆盖的 AMM DEX 集成。
Pure Market Making、Cross-Exchange Market Making、AMM 与 AMM-CEX 套利、永续合约做市,以及任何您可以编写为 V2 Script 或 V2 Controller 的自定义策略。
CLOB CEX:Binance、Coinbase、Kraken、Bybit、OKX、KuCoin、Gate.io、HTX、BitMart、Bitget、BingX、Bitrue、Bitstamp、BTC Markets、AscendEx、MEXC 等。CLOB DEX:dYdX、Hyperliquid、Derive、XRP Ledger、Dexalot、Injective Helix、Vertex。AMM DEX:Uniswap、Raydium、PancakeSwap、Curve、SushiSwap、Balancer、QuickSwap、Trader Joe、Meteora、Jupiter、0x Protocol。
V2 Scripts 是继承自 StrategyV2Base 的单文件策略,适用于原型开发和单交易对配置。V2 Controllers 是生产级的模块化子策略,可以在单个 Hummingbot 客户端内运行多个独立的交易对和配置。
可以。一个 TradingHost 运行环境可以托管多个 Hummingbot 进程,并且运行 V2 Controllers 的单个 Hummingbot 客户端可以在其内部托管多个子策略。
您需要将它们作为加密凭据(secrets)添加到 TradingHost。它们会在启动时注入到 Hummingbot 运行环境中,绝不会写入您的代码库。
可以。Hummingbot Dashboard 是该项目的一部分,可以按配置继续正常工作。TradingHost 运行底层的客户端进程并开放必要的网络连接。
不会。Hummingbot 通过您的交易所 API 凭证或 DEX 钱包进行下单。TradingHost 仅负责运行 Hummingbot 进程并流式传输日志。
报价稳定性和逆向选择对往返延迟非常敏感。TradingHost 允许您选择靠近交易场所撮合引擎的地区。完整列表请参阅 /platform/regions/。
部署您的首个 Hummingbot 策略
连接 GitHub,选择 Hummingbot 模板或您自己的代码库,添加您的交易所 API 密钥,选择部署地区,即可在 TradingHost 运行环境中启动。