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` 与连接状态，准备手动干预预案 |