解析 Hummingbot:開源量化交易框架的原理、功能與實戰

发布于 2026-02-27 23:21:45（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 5561 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）

original wex7ce EI V1ajero 2826年2月27日 23:22 中国台海 寡在前面 在加密貨整市場中,碟器人交易(BotTrading)和高规交易(HFT)長久以来似乎是機横投 资者的專利,随著間源精神的發展,Hummingbot的出现打破了这旧整叠。 Y isa Aboet Ierl s1n8rg erl h Ir logn B ioipi BI orso iver t)jk t4arr 0 naes

这是一為間發者與量化交易者平借的解析。我們将:

• 剥開Hummingbot的技術外衣,探封其功能原理

• 手把手教你如何部署和使用

• 适過15個實载案例,展示它的實账應用

什是Hummingbot?它具備哪些核心功能? Hunmingbot 是一個由Python和Cython 编寡的工業级爵源加密货量化交易框架 核心俱值

Hummingbot的四大核心功能模組 全市场交易所速接器(Connectors) Hummingbot统一了所有交易所的資料结(如OrderBcok,Trade,Order)。無输繁安 是WebSocket 還是OKX 是REST API,在蛋略退端看起来完全一楼。 目前支援三大频:

• CLOB CEX:中心化訂单薄(Binance,OKX,Gate.1o)。支援现货與永读合约。

• CLOB DEX:去中心化訂单薄(dYdX,Hyperl1qu1d)。直接透遇包签名速線。

• AMM DEX:自励化做市商(Uniswap,PancakeSwap,Raydium)。

Gateway中介软體(速接Web3的橋操) 直接用Python 呼叫智能合的效率低。Hummingbot 内建了一個基於Type5cript 的程 量级API何服器Gateway Python 核心端出交易指令给本地Gateway,Gateway 负青:

• RPC 通訊

• 交易签名

• 上廣播

高弹性本引擎(ScriptsFramework) Hunmngbot 提供了 Python 的 Script5trategyBase 基磁類别。開發者可以透退cn _tick方法(即每秒多次的時疆中),轻裂:

• 取即时報情

• 撰技術指標退辑

• 直接呼叫下量API

模摄脚後测系统(Paper Trade&History) 内建高度凝真的模凝交易(PaperTrading)项境。你可以:

• 不用真實资金测试策略

• 使用即時Order Book資料

• 透遇history指令查看腾率與回撤報告

核心架横圆 下图展示了 Hummingbot如何統一還接CEX、DEX和區埋键顾點: Hummingbot 核心莲算图 Python / Cython 推高交易通辑

一资料格式

Sripts图本菌船 OrderBook / Trade

HTTP API Gateway中介教 打筹OEX 中心化交易所CEX dYdx, Hyperliguie Binance, GKX, Bybit RPC/私输管名 EVM / Solana 区煤领面贴 去中心化交易所DEX Uniswap, Raydium

如何上手使用Hummingbot? 生產環境建 要进行素的自動化交易,碰烈建使用Docker部在霉端VPS(如AWS、 Digital0cean)上,亚確保靠近交易所的何股器顾點以降低延。 安装舆部署 完整安装指令: #1.摄裂官方然存康 git clone https://github.com/humningbot/hunningbot.g1t Cd hummingbot 10qbuquunq p5 白融化编鶴闽建立配置资料突 請道理

3.应勤益道入容额

make deploy docker attach hunningbot 安全连接交易所API 进入Hummingbot 的CLI(俞令列介面)後,输入: connect binance 系辨管提示输入APIKey和 Secret。 的安全提醒 Hummingbot是去中心化且本地通行的。加密金鸽只存在你的何服器cont/中。 務必在交易所後台只闻敏“允許交易權限,不要勾退允許提现」。 運行與监控策略 ./scripts/目錄中内建了大量箱例。你可以透過VSCode 编本機的 Python 官方在 本,然後在CLI中款行: 常用指令: 放触额本 Start --script vwap_naker.py 并查看前垫單犹感、PNL所资廉 status 查看履史交易报告 history 通到紧急默况暂停激防所有打單 stop L1

可以用它做些什? 以下三回例子展示了Hummingbot 單到造的實察庭用。你可以透遇编宽相對癌的 Python Scripts 来實現它们 簡單做市商策略(Pure MarketMaking) 適合場景 在馨整市场中為特定交易封提供流勤性,晓取買實偏差與交易所的造市商手缩費返還 (Rebate)。 通作通辑 楼器人盲以管前市为中心,同时在上下方放置限價軍(L1mitOrders)。只要市场出现波动 或吃掉你的單,你就能瞳取中的Spread(買寶循差)。 策略流程图: 3 R步 州威本9

假設你持有 ETH和 USDT,你可以設定: bid_spread=a.2%

• ask spread=a.2%

它會不断在市场上微幅低買高真。 跨交易所空間套利(SpatialArbitrage) 通合場景 當市场瑟生剧烈波勤時,不同交易所封同一個資的定俱會出現毫秒级的延逗具落差。 通作通辑 同時监控 B1nance 和OKX 的打罩薄。發现:

• Binance的「實一價格低龄0KX的黄一情格

• 情差大龄整遗手编费

機器人曾图執行低页高寶。 執行時序图: OKX(格较高) Hummingbot 超本 Binance (價格较低)

1.监胞訂單薄资料

1.监聘訂军薄資料

發现谨情差: Binance一:$60,000 OKX買一情:$60,100

2.發送市惯/限侵【页單】(S60000)

3.發送市價/限值【资單】(560100)

4.置单成交回報

4.寶单成交回報

5.扣除雙遍手绩後,

银定拥機套利利测 Hummingbot 本 Binance(價格较低) OKX(價格校高)

这種策略通常幂要率借雙资金:

• Binance:放USDT 华俄買入 ETH

• OKX:放ETH 率借囊出

透逼Hummingbot统一的資料流,你可以用十行Python碼就寡出监控南家交易所镇差的 避租, 大资金智能拆單工具(TWAP/DCA) 通合场景 適合場景 如果你有106萬美金想買入比特,直接市情砸下去會造成明显的「滑點(Slippage):,買 到的平均價格會比较差。 通作通辑 使用Hummingbot 离一時加橙平均格(TwAP,T1me-We1ghted Average Pr1ce) 本,或平均成本法(DCA)。 拆单流程围: 大额免量:营入100 USOT IF) BETC

适出小于果

完类强能交居图 實作方法

• 即本每隔5分经醒来一次

• 判断当前價格是否在合理區同

• 随機下一個1,868-5,088美金的小额市價单或被勤限價单

模级標准配儒 這是機横级量化基金建會的標配備,能购將你的大资金交易意图完美疆在市場的讯之 中,大幅降低摩擦成本

Hummingbot内建實本解析(15個案例) 在Hummingbot的/scripts/目錄下,官方提供了15個具有参考價值的本本 重要提示 這些都本不懂可以直接通行,更是你根擦自身需求打造專屋策略的显佳起贴。

類别一:經典做市舆網格交易(MarketMaking&Grid) 核心思路:在市场上下豐速排单,适過時間與流動性取買賣差。

1.simple_pmm.py(基碰純粹做市)

這是显經典、显直的做市商入門例。楼器人會永遗在當前市情的上下方,以你設定的固定 差(Spread)排出員單與賣單。 通作原理: 市場中間價 Bid Spread Ask Spread 出賣單 出買單 價格上涨成交 價格下跌成交 獲得多頭部位 獲得空頭部位/賣出现货

2.dynamic_orderbook_demo.py(動慧深度網格)

进的多唇次網格做市。它不是只街一單,而是售额取整圆0rderBook的深度(Depth),亚 根市場目前的流勤性状况,勐想在不同價格榜排出多張訂单。 通作原理: 腾样式持出置單 1, 2, 3... 膜联 OrderBook 深度 成交状款想單 肚算流性 样式持出宽單1,2,3..

3.v2_with_controllers.py(V2架構模组化做市)

這是官方推的V2架横例。它引l入了Controller(控制器)設計模式,將技術指計 算1、“食位管理:與下單執行器:完全解遇。 朗策略参考 如果策略辑,這是比较好的骨架遥握。 架横設計: Market Dota

Controller 判酯健多/做空/中性

吸送目标言位讯號 Executor 轨行器 到比省药启位 爱送下單指令

類别二:進隋套利與對冲(Arbitrage&Hedging) 核心思路:追求無凰隆或低风险利测,通常横跨多市場捕捉值差。

4.simple_xemm.py(跨所做市XEMM)

在流動性差、有交易補贴的小交易所(Maker)接单;一旦成交,立刻在流動性好的大交易 所(如整安,Taker):市借反向平會以對冲围险。 執行流程: 小交易所(流動性差) XEMM策路 蒂安(流勤性佳)

1.排出高利酒限债单

2.訂單成交

3.瞬間在带安市情反向平會

4.對冲完成

小交易所(流助性差) XEMM策路 安(流勤性佳)

5.simple_xemm_gateway·py(DeFi-CEX 跨所做市)

與上一颈似,但加入了Gateway。将中心化交易所(CEX)與去中心化交易所 (DEX)速接。 应用场景:在Uniswap真入,在安离出做對冲。 通作原理:

握取 CDX-DEX 患通接情盖 wap略具常倍 EIViajer

6.v2_funding_rate_arb.py(资金費率套利)

專门针對永續合約。当市场极度看多(多强支付資金貢率给空源)時,機器人會同時:

• 做空合约

• 置入等值现货

實现Delta中性,安收取每8小時一次的资金营率。 策略通辑: 监控永绩合的 Funding Rate

资率大於同值?

巩货市堤:贝入Spot 合的市场:做空 Perpetual

莲成Delta 中性

每8小時障资金率

7.xrpl_arb_example.py (XRPL 键上套利)

展示如何將套利遥愿用在去中心化细路(XRPLedger疑上),完全在随上的不同交易對之間 愚找三角套利路径。

三角套利示意:

低估一 Token A 高估 XRP Token B 换回

類别三:去中心化流動性管理(DeFiAMM&CLMM) 核心思路:針对Web3巍上交易所以及集中流勤性(ConcentratedLiquidity)的管理。

8.amm_trade_example.py(基本AMM交易)

展示如何透返Gateway 呼叫底唇,在AMM池子中敦行基本的 Swap(代兑换)操作。

这是所有DeFi互财的基碰聊本。 技彬流程: RPC Paylod 智能会的 Rourter 成交目相 HTTP Request- Gateway 5wap Evenit-

9.amm_data_feed_example.py(AMM数據抓取)

不執行交易,纯粹透透Gateway订阅或抓取AMM池的價格、流助性等各项键上数據,為其他 策略提供报價来源(Oracle暂代方案)。 数流程: 區瑰網路

Gateway监德

WebSocket/RPC 本解析价格與池子深度

10.Lp_manage_position.py(V3集中流助性勤態管理)

針别Uniswap V3的集中流動性池。常市場情格距出你設定的做市显時,即本害自勤你: L.撤除茜流動性

2.在新的价格區履漆加流助性

可以降低無常捐失, 管理流程: 值测到價格跑出做市區間

移除蕾流性

計算新的最佳收益區間

重新提供流動性Re-balance

11.xrpl_liquidity_example.py (XRPL 流助性提供)

針對XRPLedger的特性,於键上的原生OrderBook中提供流動性进行自動化管理。 操作流程: 定期更新訂單狀题以唐對價 XRPL 原生 DEX 惠票/甲科 格動 EIViajere 公 類别四:訂單執行、数據探集與技術指標 核心思路:辅助主策略執行大汀單,或引入傅统技術指標。

12.simple_vwap·py(成交量加權平均價拆單)

機横级訂單敦行工具

德量分售,等比例拆细送出打單,巨敏意图。 執行通辑: 大颜母草10BTC

参考市场近1小時成交量分

拆分急腔十筆小 所简莫市场活醒度送出

降任滑贴购指翠

13.v2_twap_multiple_pairs.py(多交易對TWAP 拆单)

時圈加權平均價格(TWAP)的升级版,能钩同時:在多個不同的交易到上,依摊设定好的時間随 隔切碎亚發送訂單。 或行敦行示意: 對BTC/USDT下小單

策略啟勤 每隔N分鐘 對 ETH/USDT 下小單

對SOL/USDT下小單

14.v2_directional_rsi.py(RSI指標单向交易)

技術指標結合策略的完美例 運用PandasTA库即時計算K棒的RSI指標,當RSI<30(超賣)且產生反轉訊號 時,自動開展多單。 交易通辑: 接收即时K線

計算RSI

RSI >70 RSI<30 市場超買,發送做空/平訊 市場超賣,發送做多訊号 號

15.download_order_book_and_trades.py(訂單薄數據集)

機器學習 這是一個非交易用的工具本。它能連接到交易所,持續紀錄下载:

• OrderBook的快照(Snapshot)

• 逐筆成交明細

是機器學習模型訓或策略深度回測的資料库金。 数據收集流程:

撰截OrderBook&Trade封 速接交易所WebSocket 供日後回测奥分析使用 寫入本地CSV/资料库 包

Hummingbot將高频核心基設施,打包開放給了開發者,剩下的,就是發對市場敏度與 程式碼能力了。

原始排版图

原始导出图超过单张 WebP 的尺寸上限，以下图片按从上到下的顺序连续保存。