Hummingbot接OKX做市：挂单、库存与停机

欧易OKX

2026年10月09日

Hummingbot 接 OKX 做市，卡住大多数人的地方是库存管不住、停机之后挂单没人管。挂单的核心约束是 OKX 对单个合约有持仓限额，做市策略如果不设库存偏移，很容易在单边行情中把库存撑到限额，然后新订单全部被拒。停机分两种：主动关掉和意外断连。前者 Hummingbot 会在退出时撤单，后者会把订单留在市场上，这是最危险的情况。

欧易OKX交易所
全球领先的加密货币平台，适合新手与进阶交易者
新手福利：注册即享20% 交易手续费减免！

立即注册 APP下载

连接 OKX：先确认账户模式

OKX 连接器支持现货和永续，连接命令是 connect okx，永续连接器 ID 是 okx_perpetual。创建 API 密钥的入口在 OKX 网页端用户图标下的 API 菜单，需要提供 API Key、Secret 和 Passphrase 三项。

连接永续之前，必须把 OKX 账户切换到单币种保证金模式（Single-currency margin mode），这是 Hummingbot 官方文档明确要求的前置条件。如果你用的是多币种保证金模式，连接或下单可能会失败。

另一个容易被忽略的细节：Hummingbot 每次启动时会设置持仓模式（单向或双向）。如果你重启 Hummingbot 时账户里还有未平仓的永续仓位，需要先手动平掉再重启，否则可能因为持仓模式冲突导致订单异常。

挂单：LIMIT_MAKER 和库存偏移

OKX 连接器支持的订单类型是 LIMIT 和 LIMIT_MAKER（对应 OKX 的 post_only）。做市策略应该使用 LIMIT_MAKER，确保订单只吃返佣、不付吃单手续费。

做市挂单的真正难点在库存管理。Hummingbot 的 pure_market_making 策略有 inventory_skew 和 inventory_range_multiplier 参数，用来在库存偏离目标时调整买卖报价的偏移。如果不设这两个参数，策略会无视库存变化持续对称挂单，结果就是单边行情中一边被反复成交，库存迅速偏向一边。

OKX 的持仓限额规则会直接打断这个过程。对于任一合约，如果主账户和子账户在该合约的单向持仓与挂单价值达到 max(平台总持仓价值 × 持仓占比阈值, 用户持仓最大价值)，新的同方向开仓订单会被系统拒绝，错误码是 54030。平仓单和减仓单不受限制。

这意味着：如果你的做市策略持续买入、库存不断增加，一旦触及限额，策略发出的新买单会被 OKX 直接拒绝。Hummingbot 会记录这些错误，但策略本身不会自动降低库存敞口。你需要监控库存价值，在接近限额之前调整策略或手动干预。

停机：主动退出和意外断连

主动关闭 Hummingbot 时，它会尝试撤销所有未成交的挂单。这是正常流程，但仍然需要确认：退出后到交易所网页端核对一下，确保没有挂单残留。

意外断连是真正的风险。Hummingbot 的架构文档明确指出，交易机器人的一个核心要求是能够在互联网中断或交易所服务异常时持续运行，并在恢复后自动修复状态。但如果你运行的机器本身断网、断电或进程崩溃，Hummingbot 没有机会执行撤单操作，之前挂出的订单会留在 OKX 的订单簿上。

Hummingbot 官方对做市风险的说明也确认了这一点：如果做市机器人长时间断开与交易所的连接，之前挂出的买卖报价会留在市场上，随着价格波动，这些订单可能在不利的价格被成交，造成亏损。

这个风险的大小取决于你的订单规模和距离盘口的远近。如果订单挂在盘口附近、金额较大，断连期间被"插针"成交的概率不低。如果订单远离盘口，风险相对小，但做市策略的订单通常不会离盘口太远，否则没有成交机会。

停机前的检查清单

在关掉 Hummingbot 或重启服务器之前，按这个顺序操作：

在 Hummingbot 内执行 stop 命令停止策略，等待策略确认撤单完成。不要直接关闭终端或 kill 进程。
在 OKX 网页端的"当前委托"页面核对，确认所有挂单已消失。不要只信任 Hummingbot 的日志显示。
确认没有未平仓的永续仓位。如果你用的是永续连接器，重启前必须检查。Hummingbot 启动时会重新设置持仓模式，残留仓位可能导致冲突。
如果服务器需要重启，先完成上述步骤，再执行系统重启。重启后 Hummingbot 不会自动恢复之前的策略状态，需要重新启动策略。

对于意外断连，你无法完全预防，但可以降低影响。使用云服务器而不是个人电脑运行 Hummingbot，减少因合盖、系统更新、网络切换导致的断连。设置 OKX 的"撤单于断开连接"功能（如果账户类型支持），可以在连接丢失时自动撤销挂单，但需要确认你的账户是否有这个选项。定期检查 OKX 的 API 状态页面和 Hummingbot 的日志，及时发现连接异常。