核心用法
Hyperliquid Prime 是一个基于 TypeScript 的 SDK,作为 Hyperliquid 永续合约市场的「主经纪商层」,同时覆盖原生市场(ETH、BTC)与 HIP-3 部署者市场。核心能力包括:
智能路由与聚合
quote(asset, side, size)—— 扫描所有相关市场订单簿,模拟成交路径,综合价格冲击、资金费率、抵押品转换成本,选择最优单市场执行quoteSplit()—— 针对大额订单,跨多个市场合并流动性,按价格优先原则拆分成交,降低滑点
自动抵押品管理
- 执行拆单时,若目标市场需要非 USDC 抵押(如 USDH、USDT0),SDK 自动启用 DEX 抽象、完成跨账户划转与现货兑换,并预留 1% 滑点缓冲
交易模式
- 只读模式:无需钱包,可获取市场列表、聚合订单簿、资金费率对比、路由报价
- 交易模式:需私钥,支持单步快捷交易(
long/short)或「报价-确认-执行」两步模式,确保透明可控
CLI 工具链
提供完整命令行接口,支持市场查询、订单簿查看、报价获取、杠杆交易、仓位管理等全流程操作。
显著优点
1. 流动性聚合:打破原生/HIP-3 市场壁垒,统一发现最佳价格
2. 智能拆单:大额订单自动拆分,显著降低价格冲击
3. 无缝抵押转换:USDC↔USDH/USDT0 自动兑换,无需手动操作
4. 低门槛接入:TypeScript SDK + CLI,支持 testnet,开发友好
5. 透明收费:默认 1 bps 构建者费用,可配置或关闭;拆单仅在实际执行时产生链上动作
潜在局限与风险
| 类别 | 说明 |
|------|------|
| **资金费率敞口** | 跨市场持仓可能暴露于不同资金费率方向,需主动监控 |
| **抵押品转换成本** | 自动换币产生额外滑点与手续费,极端行情可能扩大损失 |
| **智能合约依赖** | 依赖 Hyperliquid 原生机制与 HIP-3 部署者合约,第三方市场存在额外信用风险 |
| **杠杆清算风险** | 高杠杆交易(如 5x、10x)在波动行情中快速触发清算 |
| **API 稳定性** | 路由决策依赖实时订单簿数据,网络延迟或 API 故障可能影响执行质量 |
| **权限管理** | 首次交易需链上授权构建者费用,私钥泄露将导致资产损失 |
适合人群
- 量化交易员/机构:需要大额拆单、多市场最优执行的专业用户
- DeFi 高级用户:熟悉永续合约、杠杆交易,追求资金效率的活跃交易者
- 开发者/交易机器人:需要程序化接入 Hyperliquid 多市场生态的构建者
常规风险管控建议
- 使用 testnet 充分验证策略后再上主网
- 大额拆单前通过
quoteSplit预览完整执行计划与预估成本 - 监控分组仓位(
getGroupedPositions)避免 unintended 资金费率净敞口 - 妥善保管私钥,考虑使用硬件签名或托管方案
- 关注 HIP-3 市场流动性深度,避免在小众市场执行大额订单