grimoire-hyperliquid
Queries Hyperliquid market data using the Grimoire venue CLI. Use when you need mids, books, metadata, open orders, or a withdrawal call.
By franalgaba · 1,092 installs
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid
Source repository · Upstream listing
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
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:
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:
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.