SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场dapp-hyperliquid

dapp-hyperliquid

智能体与模型

查看项目

更新于 10-16 08:14

技能介绍

用途

dapp-hyperliquid 是一个面向 Hyperliquid 的永续合约与现货交易命令行工具，提供 11 条命令，用于查询市场数据、订单簿、资金费率，以及进行订单管理。它通过 plugin-store 命令调用，适合需要以命令行方式研究行情并执行交易的场景。

主要能力

工具包含以下 11 条命令：

  1. plugin-store hyperliquid markets（无需认证）：列出永续市场，返回价格、杠杆、成交量等。
  2. plugin-store hyperliquid spot-markets（无需认证）：列出现货市场。
  3. plugin-store hyperliquid price <symbol>（无需认证）：获取某交易对的实时中间价。
  4. plugin-store hyperliquid orderbook <symbol>（无需认证）：获取 L2 订单簿快照。
  5. plugin-store hyperliquid funding <symbol>（无需认证）：获取当前及历史资金费率。
  6. plugin-store hyperliquid buy --symbol <s> --size <n> --price <p> [--leverage <l>]（需认证）：买入（做多永续或现货买入）。
  7. plugin-store hyperliquid sell --symbol <s> --size <n> --price <p>（需认证）：卖出（做空永续或现货卖出）。
  8. plugin-store hyperliquid cancel --symbol <s> --order-id <oid>（需认证）：撤销挂单。
  9. plugin-store hyperliquid positions（需认证）：查看永续持仓。
  10. plugin-store hyperliquid balances（需认证）：查看 USDC 保证金与现货余额。
  11. plugin-store hyperliquid orders [--symbol <s>]（需认证）：列出未成交订单。

使用方式

前置检查

每次运行任何 plugin-store 命令前，按顺序执行以下步骤：

  1. 确认已安装：运行 which plugin-store。若未找到，执行安装：
curl -sSL https://raw.githubusercontent.com/purong-huang-1121/skills-store/main/install.sh | sh

若安装脚本失败，请用户参照 https://github.com/okx/plugin-store 的说明手动安装。

  1. 检查更新：读取 ~/.plugin-store/last_check 并与当前时间戳比较：
cached_ts=$(cat ~/.plugin-store/last_check 2>/dev/null || true)
now=$(date +%s)

若 cached_ts 非空且 (now - cached_ts) < 43200（12 小时），跳过更新继续。否则（文件缺失或超过 12 小时），运行安装脚本检查更新。

  1. 若本次会话中任何 plugin-store 命令出现意外错误，可先尝试重新安装。

认证

数据类命令（markets、spot-markets、price、orderbook、funding）无需认证，可直接使用。

交易类命令（buy、sell、cancel、positions、balances、orders）需要 EVM 钱包私钥，在 .env 文件中添加：

EVM_PRIVATE_KEY=0x...

私钥用于通过 EIP-712 类型化数据签名签署 Hyperliquid L1 操作。

快速上手示例

浏览与研究：

plugin-store hyperliquid markets
plugin-store hyperliquid spot-markets
plugin-store hyperliquid price BTC
plugin-store hyperliquid orderbook BTC
plugin-store hyperliquid funding BTC

交易：

plugin-store hyperliquid buy --symbol BTC --size 0.01 --price 65000 --leverage 10
plugin-store hyperliquid sell --symbol ETH --size 0.5 --price 3500
plugin-store hyperliquid cancel --symbol BTC --order-id 123456
plugin-store hyperliquid positions
plugin-store hyperliquid balances
plugin-store hyperliquid orders

技能路由

  • 代币搜索/分析 -> 使用 okx-dex-token
  • DEX 兑换 -> 使用 okx-dex-swap
  • 代币价格/图表 -> 使用 okx-dex-market
  • 钱包余额 -> 使用 okx-wallet-portfolio
  • 交易广播 -> 使用 okx-onchain-gateway
  • 预测市场 -> 使用 okx-dapp-polymarket
  • DeFi 借贷 -> 使用 okx-dapp-aave

操作流程

  1. 识别意图：根据用户需求对应到具体命令（浏览永续市场用 markets，浏览现货市场用 spot-markets，查价格用 price，查订单簿深度用 orderbook，查资金费率用 funding，开多/现货买入用 buy，开空/现货卖出用 sell，撤单用 cancel，查看持仓用 positions，查余额用 balances，查看挂单用 orders）。
  2. 收集参数：缺少 symbol 时先用 markets 或 spot-markets 列出可选资产；缺少 size 时询问用户交易数量；缺少 price 时先用 price 获取当前中间价再询问限价；缺少 leverage 时默认使用当前账户杠杆，并询问是否更改；缺少 order-id 时先用 orders 列出挂单再选择；缺少私钥时提示在 .env 中设置 EVM_PRIVATE_KEY。
  3. 执行：数据阶段展示市场信息、价格、资金费率、订单簿深度；确认阶段在任何 buy/sell 前展示 symbol、size、price、leverage、预估强平价并请求确认；执行阶段提交订单并展示结果与订单状态。
  4. 建议下一步：根据刚完成的命令给出后续操作建议（例如 markets 后建议查价格、查资金费率、看订单簿）。

跨技能工作流

工作流 A：研究与交易（最常见）——先查资金费率，再查价格与订单簿，确认后检查 EVM_PRIVATE_KEY，最后下单。

工作流 B：持仓管理——查看持仓、查看某交易对挂单、撤销过期订单、通过卖出平多。

工作流 C：现货交易——浏览现货市场、查价格、查订单簿、买入现货代币。

工作流 D：与 OKX 技能配合——查 Arbitrum 上 USDC 余额、浏览永续市场、开仓、验证持仓。

关键概念

  • 永续合约：无到期日、跟踪标的指数价格的合约，可无限期持有，通过资金费使合约价格与指数保持一致。
  • 资金费率：多空之间每小时支付的费用，用于使永续价格贴近指数。正费率表示多头支付空头，负费率表示空头支付多头，每小时上限 4%。
  • 杠杆：相对于所提交保证金的头寸敞口倍数。BTC 最高支持 50 倍，其他资产各不相同。杠杆越高，所需保证金越少，但强平价越近。
  • 全仓与逐仓保证金：Hyperliquid 默认使用全仓保证金，所有头寸共享同一保证金池。
  • 强平价：因保证金不足而强制平仓的标记价格，需始终关注。
  • szDecimals：每种资产有特定数量精度，例如 BTC 的 szDecimals=5，最小下单增量为 0.00001 BTC，精度不正确的订单会被拒绝。
  • 现货资产索引：现货资产以 index = 10000 + universe_index 标识。
  • 标记价格与中间价：标记价格用于盈亏与强平计算；中间价为（最优买价+最优卖价）/2。
  • USDC 保证金：所有永续头寸以 USDC 作为保证金，需要在 Hyperliquid L1 上持有 USDC 才能交易永续。

适用场景

  • 在命令行中研究 Hyperliquid 永续与现货市场行情、订单簿深度和资金费率。
  • 通过命令行开多/开空永续合约、买卖现货代币、撤销订单。
  • 查看持仓、余额与未成交订单。
  • 与其他 OKX 技能配合完成跨链余额查询与交易流程。

限制与边界情况

  • 保证金不足：若开仓规模超过可用余额在给定杠杆下可支持的范围，订单会被拒绝，应先通过 balances 检查余额。
  • 数量精度无效：订单必须遵守各资产的 szDecimals，精度过多会被拒绝，下单前可用 markets 检查所需精度。
  • 杠杆上限：各资产最大杠杆不同（如 BTC 为 50 倍，较小资产为 20 倍），超出会失败，可从 markets 查看 maxLeverage。
  • 自我成交防护：Hyperliquid 会阻止与自己成交的订单。
  • 私钥未设置：交易命令会提示“Set EVM_PRIVATE_KEY in your .env file”。
  • 交易对未找到：建议使用 markets 或 spot-markets 查看可用资产。
  • 速率限制：Hyperliquid 对 API 调用有速率限制，需使用带退避的重试。
  • 最小订单规模：资料中该部分内容被截断，暂未提供完整信息。