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.