其他
查询 Hyperliquid 行情/元数据或生成…
适用于通过 Grimoire CLI 访问 Hyperliquid 市场数据、生成 spell 参数快照,以及明确请求时执行提现。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
查询 Hyperliquid 行情/元数特定
解决思路
- 使用首选调用方式:`grimoire venue hyperliquid ...`。
- 无安装时使用:`npx -y @grimoirelabs/cli venue hyperliquid ...`。
- 仓库本地使用:`bun run packages/cli/src/index.ts venue hyperliquid ...`。
- 可直接使用来自 `@grimoirelabs/venues` 的二进制:`grimoire-hyperliquid ...`。
- 推荐先运行预检:`grimoire venue doctor --adapter hyperliquid --json`。
- 在执行有状态操作(`withdraw`)前,确保已设置 `HYPERLIQUID_PRIVATE_KEY`。
- 为快照 `params:` 块使用 `--format spell`。
- 读取所有永续资产中间价:`grimoire venue hyperliquid mids`。
- 读取某个币的 L2 订单簿:`grimoire venue hyperliquid l2-book --coin <symbol>`。
- 读取某地址的未成交订单:`grimoire venue hyperliquid open-orders --user <address>`。
- 读取永续市场元数据(universe、margin tables):`grimoire venue hyperliquid meta`。
- 读取现货市场元数据(tokens、universe):`grimoire venue hyperliquid spot-meta`。
- 生成所有永续资产中间价快照:`grimoire venue hyperliquid mids-snapshot`。
- 生成某币 L2 订单簿快照:`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`。
- 使用 `-snapshot` 变体输出供 spell 输入使用的 `params:` 块;这些命令仅面向 agent,在交互模式下输出会被抑制。
- 执行提现:`grimoire venue hyperliquid withdraw --amount <usdc> --keystore <path> [--password-env <name>] [--destination <addr>]`。
- 在 spell 中下单使用 `custom` action type 与 `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`。
- 对 symbol midpoint 比较使用 `mid_price` 指标:`hl_mid = metric("mid_price", hyperliquid, ETH)`;第三个参数是要读取的 Hyperliquid symbol,例如 `ETH`、`BTC`、`SOL`。
- `withdraw` 是有状态操作,需要用户明确确认以及 keystore 凭据。
- `mids`、`l2-book`、`open-orders`、`meta`、`spot-meta` 是只读信息调用。
- 自动化中 `meta`/`spot-meta` 使用 `--format json`;`--format table` 为嵌套 payload 显示紧凑摘要。
- 可使用 `--format table` 获取紧凑表格,例如 `grimoire venue hyperliquid mids --format table`。
- 可使用 `--format spell` 获取 spell 格式,例如 `grimoire venue hyperliquid mids --format spell`、`grimoire venue hyperliquid l2-book --coin BTC --format spell`。
- 查询示例:`grimoire venue hyperliquid l2-book --coin BTC`、`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`。
- `anvil`/`cast` 是 EVM 工具,不适用于 Hyperliquid 执行/诊断。
适用边界 · 注意事项
- 没有明确用户确认和 keystore 凭据时,不要执行 `withdraw`。
- 不要用 `anvil`/`cast` 进行 Hyperliquid 执行或诊断。
- 不要期望该适配器支持运行时约束如 `max_slippage`。