Hyperliquid CLI (with HIP3 Support)

核心用法

Hyperliquid CLI Skill 是一款命令行交易工具的配套文档，让用户无需离开终端即可完成加密货币永续合约、美股（AAPL/NVDA/TSLA 等）及大宗商品（黄金/白银）的全天候交易。核心工作流包含三步：安装 npm install -g hyperliquid-cli → 通过 hl account add 配置 API 钱包私钥 → 启动 hl server start 获取亚毫秒级连接性能。

交易指令体系：现货使用 buy/sell，合约使用 long/short，均支持限价/市价单。HIP-3 创新机制将传统资产代币化，实现加密式的 24 小时不间断交易与杠杆操作，美股也能像 BTC 一样夜间开仓。

高频性能：后台服务器模式将价格查询从 ~200ms 压缩至 ~5ms，订单延迟降至 ~50ms，配合 WebSocket 实时推送，满足量化级需求。

显著优点

1. 资产覆盖广度：单一接口打通 100+ 加密货币与主流美股、黄金，无需切换券商或等待美股开盘。
2. 性能极致优化：官方宣称 sub-5ms 延迟，实测服务器模式下较无服务器提升 20-50 倍响应速度。
3. 多账户管理：本地加密存储多组 API 密钥，支持快速切换，适合资金分仓或团队操作。
4. 透明开源：作者 chrisling-dev 公开 GitHub 仓库， Skill 本身纯 Markdown 无隐藏代码。

潜在局限与风险

1. 外部依赖隔离：Skill 仅为使用指南，核心交易逻辑托管于 npm 包 hyperliquid-cli，安全边界延伸至第三方包；用户需自行审计依赖完整性。
2. 私钥暴露模式：必须提供 HYPERLIQUID_PRIVATE_KEY 环境变量，虽支持本地加密存储，但仍存在终端历史记录、进程环境泄露等攻击面。
3. HIP-3 隔离保证金：第三方部署的美股/黄金市场（如 xyz:AAPL）采用独立保证金系统，需手动关闭"Disable HIP-3 Dex Abstraction"方可共享主账户资金，操作门槛较高。
4. 交易所单点风险：全部交易依托 Hyperliquid 单一平台，面临停机、API 变更或智能合约漏洞风险；无跨所套利或备份通道。
5. 杠杆清算风险：支持最高 50 倍杠杆，加密市场波动剧烈，新手极易触发强制平仓。

适合人群

• 量化交易者/开发者：需要脚本化、低延迟自动化策略的 CLI 重度用户
• 跨市场套利者：希望利用加密与美股时间差进行 24 小时轮动的进阶玩家
• 隐私优先用户：反感 KYC 券商、偏好链上自托管的交易者

常规风险

加密货币交易本身具有极高市场风险，HIP-3 代币化美股尚属新兴机制，流动性与定价机制可能偏离传统市场。务必使用独立 API 钱包、限制资金规模、启用 IP 白名单，并在测试网充分验证策略后再投入主网资金。

概述

Hyperliquid CLI Skill 是一款面向 Hyperliquid 去中心化交易所的命令行交易封装工具，支持加密货币永续合约、HIP3 传统资产（股票、商品）的全天候交易，并提供实时仓位监控、订单簿追踪和多账户管理功能。

核心用法

该 Skill 本质为文档型封装，需用户先行安装 hyperliquid-cli npm 包。核心工作流包括：

1. 账户配置：通过 hl account add 交互式添加 API 钱包私钥，或设置 HYPERLIQUID_PRIVATE_KEY 环境变量
2. 服务启动：运行 hl server start 启动后台 WebSocket 服务，实现亚 5ms 延迟（对比直连约 200-300ms）
3. 交易执行：支持限价/市价单，永续合约使用 long/short 方向，现货使用 buy/sell
4. HIP3 资产交易：通过 xyz: 前缀标识非官方部署市场（如 xyz:AAPL、xyz:GOLD），需先执行 hl markets ls 确认 coin 值
5. 实时监控：hl account positions -w 与 hl asset book <coin> -w 提供 WebSocket 实时数据流

显著优点

• 低延迟高性能：后台服务模式将查询延迟从 200ms+ 降至 5ms 级别，满足高频交易需求
• 统一交易界面：HIP3 机制将传统股票、商品以加密永续合约形式呈现，实现 24/7 交易与杠杆操作
• 多账户管理：本地加密存储多组 API 密钥，支持快速切换
• 纯文档零风险：Skill 本身无可执行代码，仅提供官方 CLI 的调用指南与安全提示

潜在缺点与局限性

• HIP3 保证金隔离：非官方部署的 HIP3 市场（如 xyz 系列）采用独立保证金系统，默认不与主账户共享保证金，需用户在网页端手动关闭 "Disable HIP-3 Dex Abstraction" 设置
• 依赖外部 CLI：Skill 本身不捆绑可执行文件，需用户全局安装 npm 包，版本兼容性依赖上游维护
• 私钥管理风险：交易功能要求明文私钥或环境变量配置，无硬件钱包原生支持，存在密钥泄露风险
• T3 来源限制：维护者为个人开发者，虽代码质量良好但缺乏企业级背书，长期维护稳定性存疑

适合人群

• 熟悉命令行操作的加密货币交易者
• 需要 24/7 交易美股的非美国时区用户
• 追求低延迟执行的高频交易策略开发者
• 希望统一管理多 Hyperliquid 账户的专业交易员

常规风险

• 密钥安全：HYPERLIQUID_PRIVATE_KEY 为完整控制权限密钥，一旦泄露将导致资产损失，建议使用专用 API 钱包而非主钱包
• 杠杆清算：永续合约与 HIP3 资产均支持高杠杆（最高 50x），价格波动可能导致快速清算
• 智能合约风险：Hyperliquid 作为链上协议，存在潜在合约漏洞或升级风险
• HIP3 运营方风险：非官方部署市场（xyz 前缀）由第三方运营，存在流动性、喂价或运营中断风险