grimoire-hyperliquid — Claude Code skill: Hyperliquid market data
A skill that lets your agent pull Hyperliquid market data through the Grimoire CLI: mids, order books, metadata, open orders. Withdrawals too, when asked.
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a claude-codeWhat grimoire-hyperliquid does
The skill wires the Grimoire venue CLI into your agent under grimoire venue hyperliquid. Read-only calls cover mids for perp mid prices, l2-book --coin <symbol>, open-orders --user <address>, plus meta and spot-meta. The -snapshot variants emit params: blocks for spell inputs and are meant for the agent alone — interactive output is suppressed.
Run grimoire venue doctor --adapter hyperliquid --json first. The withdraw command is stateful: it wants HYPERLIQUID_PRIVATE_KEY in the environment, a keystore, and a clear confirmation from you. Orders go through a custom action with op: "order"; accepted TIF values are Gtc, Ioc, Alo and FrontendMarket. Runtime constraints such as max_slippage are not supported — order parameters get checked at the adapter boundary instead.
To compare symbols by midpoint, use the mid_price metric: hl_mid = metric("mid_price", hyperliquid, ETH). Pick --format spell for spell inputs, --format json when scripting meta or spot-meta, and --format table for compact summaries of nested payloads. EVM tooling like anvil or cast is of no use here.
What it helps with
- read mid prices across all perp assets
- pull the L2 book for one coin
- list open orders for an address
- grab perp and spot market metadata
- emit a
params:block for a spell input
Example prompts for the agent
- Show Hyperliquid mid prices as a table
- Fetch the L2 book for BTC and output it as a spell
- Run the Hyperliquid doctor check and print the JSON
How to install grimoire-hyperliquid
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a claude-code2Manually: put the files in place
~/.claude/skills/grimoire-hyperliquid/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grimoire-hyperliquid/
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a codex2Manually: put the files in place
.agents/skills/grimoire-hyperliquid/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a cursor2Manually: put the files in place
.cursor/skills/grimoire-hyperliquid/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franalgaba/grimoire grimoire-hyperliquid2Manually: put the files in place
.github/skills/grimoire-hyperliquid/SKILL.md1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a gemini-cli2Platform CLI
gemini skills install https://github.com/franalgaba/grimoire --path skills/grimoire-hyperliquidManually: put the files in place
.devin/skills/grimoire-hyperliquid/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about grimoire-hyperliquid
How do I install grimoire-hyperliquid in Claude Code?
Run npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a claude-code, then check ~/.claude/skills/grimoire-hyperliquid/SKILL.md.
What does grimoire-hyperliquid do?
It gives your agent Grimoire commands for Hyperliquid data: mid prices, order books, open orders, perp and spot metadata. It also handles withdrawals when you ask for one.
What do I need before a withdrawal?
HYPERLIQUID_PRIVATE_KEY set in your environment, keystore credentials, and your explicit confirmation. Without the key the stateful action will not go through.
