Hummingbot / Architecture

Hummingbot架构:策略框架与交易所连接器

Hummingbot 采用模块化设计,策略框架与交易所连接器解耦,让社区成员可以独立维护和扩展。理解这套分层,是判断它适不适合你工作流的关键。

设计:模块化组件策略:四类框架连接器:三类交易所
策略框架Scripts/Controllers/Executors/V1
连接器CEX / DEX / AMM
核心引擎事件驱动 + 模块化
hbot CLI / Dashboard运行与监控
Hummingbot 模块化架构示意(策略框架 + 连接器 + 核心引擎 + CLI/Dashboard),基于官方 README;示意非官方架构图。
Layers

核心分层与职责

以下模块与职责依据官方 README(2026-09 核验)。

模块职责
策略框架(Strategies)Scripts/Controllers/Executors/V1 四类,组织做市、套利等策略逻辑
交易所连接器(Connectors)标准化 REST/WebSocket API 接口,连接 CLOB CEX / CLOB DEX / AMM DEX
核心引擎事件驱动,协调策略、订单与市场数据
hbot CLI / Dashboard非交互式运行、控制、监控交易 bot
Condor(AI harness)连接 LLM 决策与确定性交易执行
Flow

策略与连接器如何协作

策略框架生成信号,连接器标准化交易所接口下发订单,核心引擎协调事件流,hbot CLI 或 Dashboard 负责运行与监控。

说明:以上为仓库依据的架构示意,用于理解职责划分;不包含未验证的第三方集成或性能承诺。
Strategy Frameworks

四类策略框架细分

依据官方 README Strategies 段落。

框架定位示例
Scripts单文件 Python 策略,最简单simple_pmm.py
Controllers可复用 V2,配置可回测/实时调参pmm_mister.py
Executors自包含构建块,管理订单生命周期position / DCA / grid / arbitrage
V1 Strategies经典遗留策略Pure / Avellaneda / Cross-Exchange MM
Connector Types

三类交易所连接器

依据官方 README Connector Types 段落。

类型连接方式示例
CLOB CEXAPI keys(托管)Binance / OKX / Bybit
CLOB DEXwallet keys(非托管)Hyperliquid / dYdX
AMM DEXGateway 中间件Uniswap / Jupiter
Who it fits

谁适合深入理解架构

不同角色关心架构的不同层面,按你的目标选择阅读顺序。

策略研究者

关注策略框架与 Executors,判断能否表达你的做市/套利信号。

策略开发者

关注 Scripts/Controllers 与 CLI,评估开发与部署成本。

系统工程师

关注连接器与 Docker/Gateway 部署,评估运维边界。

FAQ

常见问题

Hummingbot 是单体还是模块化?

模块化:策略框架与交易所连接器解耦,社区成员可独立维护和扩展组件。

四类策略框架有什么区别?

Scripts 是单文件策略(最简单);Controllers 是可复用 V2 策略(可回测/部署/实时调参);Executors 是自包含构建块(position/DCA/grid/arbitrage 等);V1 是经典策略(Pure/Avellaneda/Cross-Exchange Market Making)。

Condor 是什么?

Condor 是 AI harness,把 LLM 决策与确定性交易执行连接起来,经 Telegram 或 web dashboard 控制。

理解架构后怎么继续?

想实际跑起来,先看安装与首次运行;想写策略,看策略开发页。