mcpField
G
grimoire-hyperliquid

grimoire-hyperliquid

github.com/franalgaba其他61.1k 次安装25 周前更新
代码仓库

关于 grimoire-hyperliquid

用于通过 Grimoire 命令行查询 Hyperliquid 市场数据并生成 Spell 快照输入的技能；提现命令属于有状态操作，需明确确认。适用于处理 Hyperliquid 数据或 Spell 工作流的 Agent 和用户。

主要功能

  1. 01永续合约中间价查询
  2. 02L2 订单簿与未结订单查询
  3. 03永续及现货市场元数据
  4. 04生成 Spell 快照输入的命令
  5. 05需确认的提现命令

适用场景

  1. 01查看 Hyperliquid 价格和订单簿
  2. 02查询某地址的未结订单
  3. 03为 Spell 准备快照输入
  4. 04明确确认后执行提现

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/franalgaba/grimoire --skill grimoire-hyperliquid

安装后在 Claude Code 中输入/grimoire-hyperliquid确认已加载。

详细介绍

Grimoire Hyperliquid 技能

使用此技能获取 Hyperliquid 元数据快照，并在明确请求时执行提现。

首选调用方式：

  • grimoire venue hyperliquid ...
  • npx -y @grimoirelabs/cli venue hyperliquid ...（无需安装）
  • bun run packages/cli/src/index.ts venue hyperliquid ...（仓库本地调用）
  • grimoire-hyperliquid ...（来自 @grimoirelabs/venues 的直接二进制文件）

建议的预检步骤：

  • grimoire venue doctor --adapter hyperliquid --json
  • 在执行有状态操作（withdraw）之前，确保已设置 HYPERLIQUID_PRIVATE_KEY。

快照的 params: 块请使用 --format spell。

命令

只读数据：

  • grimoire venue hyperliquid mids — 所有永续合约资产的中间价
  • grimoire venue hyperliquid l2-book --coin <symbol> — 某个币种的 L2 订单簿
  • grimoire venue hyperliquid open-orders --user <address> — 某个地址的未成交订单
  • grimoire venue hyperliquid meta — 永续合约市场元数据（资产列表、保证金表）
  • grimoire venue hyperliquid spot-meta — 现货市场元数据（代币、资产列表）

快照命令（仅限 Agent，可生成 spell params: 块）：

  • grimoire venue hyperliquid mids-snapshot
  • grimoire venue hyperliquid l2-book-snapshot --coin <symbol>
  • grimoire venue hyperliquid open-orders-snapshot --user <address>
  • grimoire venue hyperliquid meta-snapshot
  • grimoire venue hyperliquid spot-meta-snapshot

有状态操作：

  • grimoire venue hyperliquid withdraw --amount <usdc> --keystore <path> [--password-env <name>] [--destination <addr>]

示例

grimoire venue hyperliquid mids --format table
grimoire venue hyperliquid mids --format spell
grimoire venue hyperliquid l2-book --coin BTC
grimoire venue hyperliquid l2-book --coin BTC --format spell
grimoire venue hyperliquid open-orders --user 0x0000000000000000000000000000000000000000
grimoire venue hyperliquid meta
grimoire venue hyperliquid mids-snapshot
grimoire venue hyperliquid l2-book-snapshot --coin BTC
grimoire venue hyperliquid meta-snapshot

使用 -snapshot 变体为 spell 输入生成 params: 块。这些命令仅限 Agent 使用（交互模式下会隐藏输出）。

Spell 操作

Hyperliquid 使用 custom 操作类型，并通过 op: "order" 下单：

hyperliquid.custom(op="order", coin="ETH", price="3500", size="0.1", side="buy", order_type="Gtc")

适配器不支持运行时约束（max_slippage 等）。订单参数会在适配器边界处进行验证。

支持的 TIF 值：Gtc、Ioc、Alo、FrontendMarket。

指标范围（Spell 比较）

Hyperliquid 提供 mid_price，用于比较交易对的中间价：

hl_mid = metric("mid_price", hyperliquid, ETH)

第三个参数是要读取的 Hyperliquid 交易对（例如 ETH、BTC、SOL）。

备注

  • withdraw 是有状态操作，需要用户明确确认并提供 keystore 凭据。
  • mids、l2-book、open-orders、meta、spot-meta 是只读信息调用。
  • 基于快照的 spell 输入请使用 --format spell。
  • 自动化场景下，meta/spot-meta 请使用 --format json；对于嵌套负载，--format table 会显示精简摘要。
  • anvil/cast 是 EVM 工具，不适用于 Hyperliquid 执行或诊断。

评论

支持 Markdown