核心用法
Hyperliquid Prime 是一个基于 TypeScript 的 SDK,作为 Hyperliquid 永续合约市场的主经纪商层,同时覆盖原生市场(ETH、BTC)和 HIP-3 部署者市场。核心功能包括:
- 智能路由:自动发现某资产的所有永续市场,比较流动性、资金费率和成本,选择最优执行路径
- 订单拆分:大额订单可拆分到多个市场执行,降低价格冲击
- 抵押品自动转换:当非 USDC 市场提供更优价格时,自动完成 USDC → USDH/USDT0 的转换
- 统一仓位视图:聚合展示跨多个抵押品类型的持仓
使用模式采用报价-执行分离的安全设计::quote()() / quoteSplit()() 为只读操作,返回执行计划供用户审查;execute()() / executeSplit()() 需显式调用才会上链。CLI 和 SDK 均支持此流程。
显著优点
1. 执行优化:通过多市场聚合和智能评分算法(价格冲击为主、资金费率为辅),显著降低交易成本
2. 市场覆盖广:支持加密货币、股票(AAPL、NVDA、TSLA)、指数和大宗商品(GOLD、SILVER)
3. 安全设计:quote-then-execute 模式避免误操作;私钥仅本地签名使用,不上传远程
4. 透明可控:Builder Fee(1 bps)可禁用,抵押品转换有 1% 滑点缓冲说明,源码完全开源可审计
5. 灵活接入:支持只读查询(无需钱包)和完整交易,提供 TypeScript SDK 和 CLI 两种接口
潜在缺点与局限性
- 来源可信度:作者为个人开发者(T3),虽代码开源,但长期维护能力和安全响应速度存疑
- 依赖外部审计:Skill 本身为纯文档,实际 SDK 需通过 npm 安装,用户需自行审计
hyperliquid-prime包代码 - 费用结构复杂:除 Builder Fee 外,抵押品转换涉及 DEX 滑点,大额拆单可能产生多笔 Gas 成本
- 杠杆设置限制:
isCross参数必须配合leverage使用,省略杠杆时不会设置保证金模式 - 生态依赖:完全绑定 Hyperliquid 生态,无法跨链或接入其他交易所流动性
适合的目标群体
- 活跃衍生品交易者:在 Hyperliquid 上频繁交易、追求最优执行价格的用户
- 机构/大额交易者:需要拆分大单、管理多市场仓位的专业交易者
- 量化策略开发者:需要程序化接入 Hyperliquid 多市场数据的策略团队
- DeFi 高级用户:熟悉永续合约、资金费率和抵押品机制,能自主审计代码的成熟用户
使用风险
- 私钥泄露风险:
HP_PRIVATE_KEY环境变量配置不当可能导致资金损失 - 智能合约风险:依赖 Hyperliquid 协议和 HIP-3 部署者市场的合约安全性
- 滑点与执行偏差:自动抵押品转换的 1% 缓冲可能不足,极端行情下实际成本可能高于预估
- API 与网络依赖:Hyperliquid API 故障或网络延迟可能影响订单执行
- npm 供应链风险:需确保安装的
hyperliquid-prime包未被篡改,建议锁定版本并校验哈希