Open-broker

核心用法

Open Broker 是面向 Hyperliquid 去中心化衍生品交易所的 Node.js 命令行工具与 OpenClaw 插件，提供从账户管理到复杂自动化的完整交易能力。

基础交易：

• 支持市价/限价/触发/止盈止损（TP/SL）/括号订单（Bracket）等多种订单类型
• 原生支持 HIP-3 跨 DEX 资产（如 xyz:CL 原油、km:USOIL 等），统一通过 search 工具发现
• TWAP 拆单、Chase 追价、Grid 网格等高级执行策略

实时监控系统：

• 后台 30 秒轮询仓位状态，通过 Webhook 推送 PnL 异动、保证金告警、强平风险
• 支持 position_opened/closed/changed、pnl_threshold、margin_warning 等 10+ 事件驱动编程

自动化框架：

• TypeScript 编写策略，提供完整的 AutomationAPI（市场数据、下单、状态持久化、审计日志）
• 内置事件订阅：tick/price_change/funding_update/order_update（WebSocket 实时）
• 自动本地 SQLite 审计 + 可选 Dashboard 实时转发

显著优点

1. 完整的 HIP-3 跨 DEX 支持：自动处理资产前缀（xyz:、km: 等），统一 API 访问主网与第三方永续合约
2. 企业级自动化基础设施：WebSocket 实时数据 + REST 心跳保底，策略崩溃自动重启，状态持久化跨会话
3. 风控优先设计：margin_warning（80% 保证金）、pnl_threshold（5% 仓位波动）、liquidation 强平事件内置，强制建议配套监控自动化
4. 灵活的接入方式：纯 CLI 独立使用，或作为 OpenClaw 插件获得结构化工具调用与 Agent 推送能力
5. 审计与透明：所有操作写入本地 SQLite，支持事后报告生成，满足合规与复盘需求

潜在缺点与局限性

• 托管风险：需配置 HYPERLIQUID_PRIVATE_KEY，虽然支持 API 子钱包（不可提现），但主私钥泄露仍可能导致资金损失
• WebSocket 依赖：实时事件需稳定网络，断线后自动降级为 10 秒 REST 轮询，高波动期间可能延迟
• 策略编写门槛：自动化需 TypeScript 编程，非可视化界面，普通用户学习曲线陡峭
• 无内置回测：自动化框架仅支持实盘或 --dry 模拟，无历史数据回测功能
• 平台单一性：仅支持 Hyperliquid 生态，无法跨 CEX/DEX 聚合执行

适合人群

• 量化交易者：需要程序化策略、实时事件驱动、精确风控的进阶用户
• DeFi 原生用户：已在 Hyperliquid 活跃，希望提升自动化程度的永续合约交易者
• 机构/资管团队：需要多账号监控、审计日志、团队协同的资产管理场景
• 开发者：熟悉 Node.js/TypeScript，希望扩展自定义交易逻辑的工程师

常规风险

1. 智能合约与桥接风险：Hyperliquid 虽为成熟 DEX，仍存在合约漏洞、跨链桥资产脱锚等系统性风险
2. 高杠杆清算：永续合约支持高杠杆，自动化策略若风控不当可能快速归零
3. API 速率限制：高频策略需关注 rate_limit 配额，超限时操作失败
4. 配置泄露：.env 文件或环境变量中的私钥若泄露，资金可被直接提取
5. 策略逻辑错误：--dry 模拟虽可预览，但真实滑点、资金费率、部分成交等仅在实盘中暴露，建议小资金验证

核心功能

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

交易执行：支持市价单、限价单、触发单（止盈止损）、TWAP 拆分执行、网格定投等高级订单类型，覆盖主网永续合约、HIP-3 第三方永续合约及现货市场。

自动化框架：基于 TypeScript 的事件驱动交易引擎，内置 WebSocket 实时数据流（价格变动、订单状态、成交推送），支持自定义策略脚本（如资金费率套利、突破追涨、DCA 定投等），并提供持久化状态管理、本地审计日志及 webhook 告警机制。

仓位监控：可选插件提供后台 30 秒轮询监控，实时推送 PnL 波动（≥5% 触发）、保证金使用率预警（≥80% 触发）、强平告警等关键风险事件。

显著优点

• 功能完整性：覆盖 Hyperliquid 全市场交易对（含 HIP-3 协议资产），支持 API Wallet 权限隔离模式（仅交易不可提现）
• 自动化友好：完整的 TypeScript SDK 与事件系统（price_change/funding_update/margin_warning 等），状态持久化跨重启保留
• 风控机制：内置 --dry 预览模式、自动 TP/SL 设置、保证金警告事件、强平实时推送
• 可审计性：本地 SQLite 审计日志记录所有交易操作、状态变更与自定义指标

潜在局限与风险

| 风险类别 | 说明 |

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

| **资金安全** | 需配置 `HYPERLIQUID_PRIVATE_KEY` 私钥，泄露即资产损失；建议使用 API Wallet 隔离权限 |

| **策略风险** | 自动化脚本可能因市场极端波动、API 延迟或逻辑缺陷导致意外亏损或强平 |

| **外部依赖** | 核心功能依赖 `openbroker-plugin` npm 包，需用户自行审查供应链安全 |

| **本地配置** | 默认包含 `localhost:3001` 开发服务器示例，生产环境需手动修正 |

| **网络延迟** | WebSocket 断线后回退至 10 秒 REST 轮询，高频策略可能受影响 |

适合人群

• 具备加密货币衍生品交易经验、熟悉 Hyperliquid 平台的中高级交易者
• 需要程序化执行策略（套利、做市、定投）的量化交易员
• 能够安全托管私钥、理解智能合约风险的技术型用户

安全建议

首次使用务必在 HYPERLIQUID_NETWORK=testnet 环境验证策略逻辑；生产环境采用 API Wallet 模式并配置独立的低资金钱包；关键自动化必须订阅 margin_warning 与 pnl_threshold 事件并设置 api.onStop() 清理逻辑。