Open Broker - Hyperliquid 专业交易工具包
Open Broker 是面向 Hyperliquid DEX 的全功能交易 CLI,由 monemetrics 开发,基于 MIT 协议开源。该工具整合了现货与永续合约交易、HIP-3 跨 DEX 资产支持、以及事件驱动的自动化策略引擎,为量化交易者与 AI Agent 提供机构级的执行能力。
核心功能
交易执行:支持市价单、限价单、止盈止损触发单、TWAP 时间加权订单、网格 scale 订单、以及智能追单(chase)等多种高级执行方式。所有命令均支持 --dry 预览模式,避免误操作。
HIP-3 生态支持:原生支持 Hyperliquid 的 HIP-3 协议,可交易 xyz、flx、km 等第三方 DEX 上线的合成资产(如原油 xyz:CL、黄金 xyz:GOLD),统一使用 dex:COIN 格式标识。
自动化策略引擎:基于 TypeScript 的事件驱动脚本系统,支持实时 WebSocket 数据流(价格、订单状态、成交明细)与 REST 轮询心跳。内置事件包括价格突破、资金费率更新、持仓变动、PnL 阈值告警、保证金风险预警等。策略状态自动持久化,网关重启后自动恢复运行。
背景监控与告警:OpenClaw 插件模式下,提供 30 秒轮询的持仓观察器,通过 Webhook 向 Agent 推送 PnL 大幅波动、强平风险、订单成交等关键事件,实现真正的无人值守交易。
显著优势
- 双重接口:既可作为独立 CLI 使用(Bash 命令),也可作为 OpenClaw 结构化工具(
ob_*系列),CLI 具备更成熟的错误处理,工具接口提供更清晰的数据结构。 - 零配置启动:
openbroker setup一键生成钱包、配置文件并自动授权 builder 费用,Agent 场景推荐"全新钱包"模式,无需浏览器交互即可开始交易。 - API 钱包支持:可创建受限权限的子钱包,仅能交易不能提现,适合委托给第三方策略运行。
- 实时与可靠并存:WebSocket 提供亚秒级事件响应,REST 轮询作为故障转移,确保策略连续性。
- 内置风险管理:自动化 API 强制要求设置 TP/SL、保证金监控、止损清理逻辑,避免策略失控。
局限性与风险
- 资金门槛:需在 Arbitrum 网络向 Hyperliquid L1 充值 USDC,新用户存在链上操作学习成本。
- 策略风险:捆绑的示例策略(DCA、网格、资金费套利)仅为参考模板,直接运行可能因参数不当导致亏损,必须根据用户具体要求定制。
- WebSocket 依赖:部分事件(强平告警)仅限 WebSocket 模式,若用户禁用
--no-ws则无法接收。 - builder 费用:强制收取 1 bps(0.01%)builder 费用,不可配置。
- API 限制:高频策略需注意 Hyperliquid 的速率限制,过量请求可能触发限流。
适合人群
- 量化交易者与算法交易员
- 需要 7×24 监控持仓的 DeFi 用户
- 希望将交易逻辑代码化的开发者
- 使用 OpenClaw/Claude 等 AI Agent 框架的自动化交易者
常规风险提示
- 务必先用 `--dry` 预览:所有交易命令支持模拟运行,确认无误后再执行。
- 测试网先行:首次使用建议在 testnet 验证策略逻辑。
- 保证金监控不可少:运行任何持仓策略时,必须并行启动保证金告警自动化,防止强平。
- Webhook 配置复杂度:背景告警需要手动配置网关的 hooks 映射与 token,插件无法自动完成。
Node.js 22+ 环境,依赖网络访问 api.hyperliquid.xyz,私钥通过 HYPERLIQUID_PRIVATE_KEY 环境变量管理。