Queries Hyperliquid market data using the Grimoire venue CLI. Use when you need mids, books, metadata, open orders, or a withdrawal call.
Grimoire Hyperliquid Skill
Use this skill for Hyperliquid metadata snapshots and, when explicitly requested, withdrawals.
Preferred invocations:
grimoire venue hyperliquid ...
npx -y @grimoirelabs/cli venue hyperliquid ... (no-install)
bun run packages/cli/src/index.ts venue hyperliquid ... (repo-local)
grimoire-hyperliquid ... (direct binary from @grimoirelabs/venues)
Recommended preflight:
grimoire venue doctor --adapter hyperliquid --json
Ensure HYPERLIQUID_PRIVATE_KEY is set before stateful actions (withdraw).
Use --format spell for snapshot params: blocks.
Commands
Read-only data:
grimoire venue hyperliquid mids — mid prices for all perp assets
grimoire venue hyperliquid l2-book --coin <symbol> — L2 order book for a coin
grimoire venue hyperliquid open-orders --user <address> — open orders for an address
grimoire venue hyperliquid meta — perp market metadata (universe, margin tables)
grimoire venue hyperliquid spot-meta — spot market metadata (tokens, universe)
Snapshot commands (agent-only, generate spell params: blocks):
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
Stateful:
grimoire venue hyperliquid withdraw --amount <usdc> --keystore <path> [--password-env <name>] [--destination <addr>]
Examples
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
Use -snapshot variants to emit params: blocks for spell inputs. These are agent-only (output suppressed in interactive mode).
Spell Actions
Hyperliquid uses custom action type with op: "order" for order placement:
hyperliquid.custom(op="order", coin="ETH", price="3500", size="0.1", side="buy", order_type="Gtc")
The adapter does not support runtime constraints (max_slippage, etc.). Order parameters are validated at the adapter boundary.
Supported TIF values: Gtc, Ioc, Alo, FrontendMarket.
Metric Surface (Spell Comparisons)
Hyperliquid exposes mid_price for symbol midpoint comparisons:
hl_mid = metric("mid_price", hyperliquid, ETH)
The third argument is the Hyperliquid symbol to read (for example ETH, BTC, SOL).
Notes
withdraw is stateful and requires explicit user confirmation plus keystore credentials.
mids, l2-book, open-orders, meta, spot-meta are read-only info calls.
Use --format spell for snapshot-based spell inputs.
Use --format json for meta/spot-meta in automation; --format table shows compact summaries for nested payloads.
anvil/cast are EVM tools and are not applicable for Hyperliquid execution/diagnostics.don't have the plugin yet? install it then click "run inline in claude" again.