Open-broker

📈 Hyperliquid 自动化交易与监控引擎

DeFi/Trading榜 #4

Hyperliquid 交易自动化 CLI,支持实时持仓监控、自定义策略脚本与风险预警,内置 Webhook 告警与审计追踪

收藏
11.2k
安装
3k
版本
1.0.80
CLS 安全性认证2026-06-24
点击查看完整报告 >

使用说明

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 环境变量管理。

安全解读

核心用法

OpenBroker 是 Hyperliquid 去中心化交易所的专业级 CLI 交易工具,提供完整的现货与永续合约交易能力。核心功能包括:

  • 基础交易:市价/限价订单、止盈止损、TWAP 拆单、网格策略、括号订单
  • HIP-3 支持:多 DEX 聚合交易(xyz、flx、km 等前缀资产)
  • 实时数据:资金费率扫描、K 线数据、订单簿深度、成交历史
  • 自动化引擎:TypeScript 事件驱动脚本,支持 WebSocket 实时事件、持久化状态、Webhook 告警

快速上手
1. openbroker setup 生成钱包并完成 builder fee 授权

2. 从 Hyperliquid 主账户发送 USDC 至该钱包地址

3. openbroker buy --coin ETH --size 0.1 开始交易

显著优点

1. 专业级自动化框架:区别于简单脚本,提供完整的 AutomationAPI — 事件订阅(价格变动、仓位开关、PnL 阈值、保证金预警)、持久化状态存储、实时 WebSocket 数据流、本地审计日志(SQLite)。

2. 机构级执行策略:原生 TWAP(交易所级拆单)、网格缩放、Chase 订单(跟价追单)、括号订单(入场+TP+SL 一键下发),满足量化执行需求。

3. HIP-3 原生支持:无缝交易多 DEX 聚合资产,自动处理 dex:COIN 格式的保证金与计价逻辑。

4. 安全设计:开源 MIT 协议、纯本地执行(私钥不离开本机)、--dry 预览模式、API 钱包模式(不可提现代理)。

5. OpenClaw 深度集成:可选插件提供结构化工具调用、后台仓位监控(30s 轮询)、自动化生命周期管理。

潜在缺点与局限

1. 技术门槛高:需熟悉 Node.js/TypeScript 才能编写自动化策略;事件系统与 API 方法文档密集,学习曲线陡峭。

2. Hyperliquid 生态绑定:仅支持 Hyperliquid 单交易所,无法跨平台套利或对冲。

3. 自托管风险:用户需自行管理私钥与资金划转,无托管保险或社交恢复机制。

4. WebSocket 依赖:实时事件依赖稳定网络连接,断线时回退至 10s REST 轮询,可能错过快速行情。

5. 保证金机制复杂:HIP-3 资产强制隔离保证金,与主账户跨保证金模式交互需仔细核算。

适合人群

  • 量化交易者:需要事件驱动策略、TWAP 执行、资金费率套利
  • DeFi 专业用户:熟悉 Hyperliquid 生态,追求链上透明与低费率
  • 交易自动化开发者:愿意用 TypeScript 编写自定义逻辑
  • 机构/团队:API 钱包模式支持主账户资金代理交易,风险隔离

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| **智能合约风险** | Hyperliquid L1 合约漏洞或升级 | 关注官方审计与安全公告 |
| **清算风险** | 高杠杆 + 波动导致强平 | 设置 SL、监控 `margin_warning`、控制仓位规模 |
| **私钥泄露** | 本地文件或环境变量被窃取 | 使用专用交易钱包、API 钱包限制提权、定期轮换 |
| **策略风险** | 自动化逻辑缺陷导致亏损 | 充分 `--dry` 测试、小资金试运行、设置 PnL 告警 |
| **网络/执行风险** | 节点延迟、订单未成交、价格滑点 | 使用 `slippage` 参数、监控 `order_update` 事件、准备 CLI 兜底 |
| **builder fee** | 固定 1bps 费用无法调整 | 计入策略成本模型 |

关键安全提示

  • 务必先用 `--dry` 预览:任何交易命令前加 --dry 验证参数
  • 测试网优先HYPERLIQUID_NETWORK=testnet 验证策略后再上主网
  • 自动化必配风控:每个策略必须包含 margin_warning/pnl_threshold 监听 + api.onStop() 清理逻辑
  • HIP-3 资产搜索先行:交易陌生资产前用 openbroker search 确认正确 ticker 格式

Open-broker 内容

手动下载zip · 18.1 kB
SKILL.mdtext/markdown
请选择文件