Open-broker

核心用法

OpenBroker 是基于 Hyperliquid DEX 的专业交易命令行工具，支持现货与永续合约交易。核心工作流：
1. 初始化：openbroker setup 生成钱包并自动批准 builder fee（1 bps）
2. 资金准备：向生成的钱包地址充值 USDC（Arbitrum 网络）
3. 交易执行：支持市价/限价/触发单、TWAP、网格定投、追踪委托等高级订单类型
4. 自动化策略：通过 TypeScript 脚本编写事件驱动策略，支持实时 WebSocket 数据流

关键功能模块：

• 订单执行：buy/sell 市价单、limit 限价单、tpsl 止盈止损、bracket bracket 订单、chase 追踪委托
• 高级执行：twap 时间加权均价、scale 网格订单、trigger 条件触发单
• 市场数据：实时资金费率扫描、K线数据、订单簿深度、成交记录
• 自动化框架：30+ 种事件订阅（价格变动、仓位变化、资金费率更新、保证金警告等），支持持久化状态与 webhook 告警

显著优点

• 原生 Hyperliquid 支持：完整支持 HIP-3 生态资产（xyz:CL、km:USOIL 等），自动处理资产 ID 映射
• 零配置即交易：单命令完成钱包生成、配置保存、builder fee 授权，无需浏览器交互
• 实时自动化：WebSocket 驱动的亚秒级事件响应，支持无人值守策略运行
• 风控内置：自动保证金监控（80% 阈值告警）、PnL 波动检测（5% 阈值）、强制清算预警
• 审计追踪：本地 SQLite 自动化审计日志，记录所有交易、状态变更与自定义指标

潜在缺点与局限性

• 私钥管理风险：HYPERLIQUID_PRIVATE_KEY 以明文存储于 ~/.openbroker/.env，无硬件钱包或密钥派生支持
• 单一网络依赖：仅支持 Hyperliquid，无法跨链聚合其他 DEX 流动性
• 策略执行权限：自动化脚本拥有完整交易权限，错误逻辑可能导致快速亏损
• API 限流：高频策略可能触发 rate limit（需监控 ob_rate_limit）
• WebSocket 可靠性：实时事件依赖 WebSocket 连接，断线时降级为 10s 轮询，可能错过快速行情
• 无回测框架：策略需通过 --dry 模拟或实盘验证，缺乏历史数据回测能力

适合人群

• 量化交易者：需要程序化执行与复杂事件驱动策略
• DeFi 高级用户：熟悉 Hyperliquid 生态，追求低费率（1 bps builder fee）与深流动性
• 机构/资管团队：需多账户管理、TWAP 执行、实时风控监控
• 自动化需求者：希望 7×24 小时运行定投、网格、资金费率套利等策略

不适合：加密货币新手、无法妥善保管私钥的用户、需要多链交易或硬件钱包集成的场景。

常规风险

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

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

| 私钥泄露 | `.env` 文件权限不当导致资金被盗 | 设置 600 权限，使用专用服务器/VM，定期轮换密钥 |

| 过度交易 | 自动化策略在波动市场频繁开仓 | 设置单日最大交易次数、仓位上限、强制冷却期 |

| 极端行情 | 快速价格变动导致滑点过大或无法成交 | 使用 `slippage` 参数限制、设置止损单、避免高杠杆 |

| 保证金不足 | 未及时追加保证金导致强平 | 启用 `margin_warning` 事件监听，设置自动减仓或告警 |

| 策略错误 | 代码逻辑缺陷导致意外亏损 | 始终先用 `--dry` 测试，小额实盘验证，逐步放大资金 |

| 网络/节点 | Hyperliquid API 或 Arbitrum 网络故障 | 监控 `rate_limit` 与连接状态，准备手动干预预案 |

核心用法

OpenBroker 是 Hyperliquid DEX 的专业级 CLI 交易工具，提供完整交易生命周期管理：

基础交易：openbroker buy/sell --coin ETH --size 0.1 快速市价单；openbroker limit 限价单；openbroker tpsl 为持仓设置止盈止损；openbroker trigger 创建条件触发单。

高级执行：TWAP 大单拆分（openbroker twap）、网格挂单（scale）、追踪订单（chase）、括号单（bracket 同时设入场+TP+SL）。支持 HIP-3 生态资产（xyz:CL 等格式）。

自动化策略：TypeScript 脚本驱动的事件系统，支持 WebSocket 实时数据（价格变动、成交、资金费率更新等），内置 position_opened/closed、pnl_threshold、margin_warning 等事件。提供完整 SDK（api.client）访问 Hyperliquid 全部功能。

仓位监控：可选 OpenClaw 插件启用后台监控，30秒轮询，超阈值时通过 webhook 推送警报。

显著优点

• 功能完整：覆盖 Hyperliquid 全部交易功能，包括 HIP-3 新兴资产
• 自动化能力：事件驱动架构，支持复杂策略（资金费率套利、DCA、网格、做市）
• 风险控制内置：强制建议设置 TP/SL，提供 margin_warning/pnl_threshold 自动预警
• HIP-3 原生支持：无缝交易 xyz、km、hyna 等 HIP-3 永续合约
• 审计追溯：本地 SQLite 记录所有操作、状态变更、自定义指标

局限性与风险

• 私钥暴露风险：必须设置 HYPERLIQUID_PRIVATE_KEY，用户需自行保障密钥安全
• 无内置 UI：纯 CLI 工具，依赖命令行或自动化脚本交互
• WebSocket 依赖：实时事件需稳定 WebSocket 连接，网络波动时回退到 10秒 REST 轮询
• 策略风险：自动化脚本需用户自行编写/审查，示例代码仅为参考，非生产级策略
• 清算风险：高杠杆永续合约存在强平风险，需主动监控

适合人群

• 量化交易者、DeFi 高级用户
• 需要自动化策略执行的机构/专业交易者
• 熟悉 TypeScript/JavaScript 的开发者
• 已熟悉 Hyperliquid 生态的用户

常规风险

| 风险类型 | 说明 | 缓解建议 |

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

| 私钥泄露 | 私钥存储于本地环境变量 | 使用 API 钱包（无提现权限）、`.env` 文件隔离、定期轮换 |

| 意外交易 | 自动化脚本逻辑错误 | 始终先用 `--dry` 预览，测试网验证 |

| 清算损失 | 高杠杆仓位价格波动 | 设置止损单，启用 `margin_warning` 监控 |

| 网络延迟 | 极端行情下价格滑点 | 使用限价单控制成交价格，设置合理滑点容忍 |

| 策略失效 | 市场条件变化导致自动化亏损 | 定期审查审计日志，`api.publish()` 关键事件通知 |

安全认证显示无代码层恶意行为，但交易类工具的资金风险完全由用户承担。