Open-broker

OpenBroker：Hyperliquid 机构级交易终端

OpenBroker 是一个面向专业交易者的 Node.js CLI 工具，深度集成 Hyperliquid 去中心化衍生品交易所，提供从基础交易到复杂自动化的完整能力栈。

核心功能

交易执行：支持现货与永续合约（含 HIP-3 跨协议资产），覆盖市价单、限价单、触发单、TWAP、网格、追踪止盈等多种高级订单类型。HIP-3 资产采用 dex:COIN 格式（如 xyz:CL），通过内置搜索工具可快速发现全市场资产。

实时数据：账户状态、持仓盈亏、资金费率、K线数据、成交记录、订单簿深度等 20+ 数据接口，支持 REST 与 WebSocket 双模式。

自动化引擎：TypeScript 脚本驱动的 event-driven 自动化系统，内置 8 类事件订阅（价格变动、资金费率更新、仓位开平、盈亏阈值、保证金预警、订单生命周期、强平警报等），支持状态持久化、Webhook 告警、审计日志与优雅退出处理。

背景监控：独立的位置监视器以 30 秒间隔轮询账户，自动检测持仓变化、大额盈亏波动、高保证金使用率，并通过 webhook 即时唤醒代理通知用户。

显著优点

1. 双模式架构：既可作为独立 CLI 使用，也可启用 OpenClaw 插件获得结构化工具调用与背景监控能力
2. 企业级可靠性：自动化脚本跨网关重启自动恢复、SQLite 审计追踪、幂等性状态管理
3. 风险前置设计：强制 TP/SL 建议、保证金预警、强平事件订阅、--dry 预览模式、API 钱包隔离权限
4. HIP-3 原生支持：无需手动切换协议，统一接口访问 10+ 第三方永续 DEX 的流动性

局限与风险

• 资金门槛：需预先在 Arbitrum 网络充值 USDC 并跨链至 Hyperliquid L1
• Web3 操作摩擦：API 钱包设置需主钱包浏览器签名，对非技术用户不够友好
• 托管依赖：私钥以明文形式存储于 ~/.openbroker/.env，虽符合 CLI 工具惯例，但存在本地文件泄露风险
• 策略风险：捆绑示例策略仅为参考，直接运行默认参数可能导致意外亏损；自动化脚本的无限循环逻辑若编写不当可能快速耗尽保证金

适合人群

量化交易者、DeFi 高级用户、需要 7×24 小时仓位监控的机构或高净值个人、熟悉 TypeScript 希望自定义策略的开发者。

常规风险

• 杠杆交易存在强平风险，自动化策略可能放大亏损
• WebSocket 连接中断时会降级至 REST 轮询，高频策略可能错过瞬时价格
• 背景监控依赖正确配置的 webhook 令牌，配置错误将导致静默失效
• HIP-3 第三方协议的智能合约风险独立于 Hyperliquid 主协议

核心功能

OpenBroker 是一款面向 Hyperliquid DEX 的专业交易 CLI 工具与自动化框架，由社区开发者 monemetrics 维护。其核心能力涵盖：

交易执行：支持市价单、限价单、触发单（TP/SL）、TWAP、网格订单、追击单等高级订单类型，兼容主网永续合约、HIP-3 跨 DEX 资产及现货市场。

自动化策略：基于 TypeScript 的事件驱动脚本系统，提供 tick、price_change、funding_update、position_opened/closed 等 8+ 种事件订阅，内置持久化状态管理、实时 WebSocket 数据流及审计日志。

风险管理：自动仓位监控（PnL 阈值、保证金警告）、 liquidation 预警、优雅关闭时的仓位清理机制。

集成能力：可作为 OpenClaw 插件运行，通过 webhook 向代理发送实时告警，支持后台持续监控与多通道通知。

显著优点

• 功能完整：覆盖从基础交易到复杂自动化（DCA、网格、资金费率套利）的全链路
• 事件驱动架构：WebSocket 实时事件 + REST 轮询双模式，延迟低且可靠性高
• 安全实践优良：私钥仅通过环境变量配置，无硬编码；支持 API 钱包实现权限隔离
• HIP-3 原生支持：无缝交易跨 DEX 资产（如 xyz:CL 原油、km:USOIL）
• 审计与可观测性：本地 SQLite 审计日志、结构化日志、api.publish() 代理通信

潜在局限

• 来源可信度 T3：社区个人项目，非顶级机构背书，需关注维护持续性
• 外部依赖单一：核心功能完全依赖 openbroker npm 包，版本锁定建议手动管理
• 金融固有风险：加密货币交易存在市场波动、智能合约及操作风险，策略需充分测试
• Webhook 配置复杂度：实时告警需手动配置 OpenClaw 网关 hooks，对非技术用户有门槛
• 无图形界面：纯 CLI/代码驱动，不适合偏好可视化操作的用户

适合人群

• 量化交易者与算法策略开发者
• DeFi 高级用户需自动化仓位管理
• Hyperliquid 生态重度使用者
• 具备 Node.js/TypeScript 基础的技术用户

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 交易执行风险 | 网络延迟、滑点、订单拒绝 | 使用 `--dry` 预览，`--slippage` 控制滑点，小单测试 |

|  liquidation 风险 | 高杠杆仓位可能被强平 | 监控 `margin_warning` 事件，设置止损，控制杠杆 |

| 自动化脚本风险 | 逻辑错误导致意外交易 | 充分回测，`--dry` 验证，设置 `onStop` 清理逻辑 |

| 密钥安全风险 | 私钥泄露导致资金损失 | 文件权限 600，使用 API 钱包，隔离环境运行 |

| 依赖供应链风险 | npm 包被篡改或存在漏洞 | 版本锁定，定期 `npm audit`，关注安全公告 |