hyperliquid-prime

📈 Hyperliquid 智能路由交易引擎

🥥8总安装量 2评分人数 2
100% 的用户推荐

开源 Hyperliquid 永续合约智能路由 SDK,支持跨市场最优执行与自动抵押品转换,需用户显式确认交易。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 纯文档型 Skill,无可执行代码,无自动执行风险
  • ✅ 采用 quote-then-execute 安全模式,交易需用户显式确认
  • ✅ 私钥仅用于本地签名,不上传远程服务器
  • ⚠️ 实际 SDK 需通过 npm 安装,用户需自行审计 hyperliquid-prime 包源代码
  • ⚠️ Builder Fee(1 bps)首次交易自动授权,可通过配置禁用

使用说明

核心用法

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 包未被篡改,建议锁定版本并校验哈希

hyperliquid-prime 内容

手动下载zip · 5.2 kB
openclaw.plugin.jsonapplication/json
请选择文件