Install
Terminal · npx$
npx skills add https://github.com/franalgaba/grimoire --skill grimoire-hyperliquidWorks with Paperclip
How Grimoire Hyperliquid fits into a Paperclip company.
Grimoire Hyperliquid drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.
S
SaaS FactoryPaired
Pre-configured AI company — 18 agents, 18 skills, one-time purchase.
$27$59
Explore packSource file
SKILL.md90 linesExpandCollapse
---name: grimoire-hyperliquiddescription: 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 ```bashgrimoire venue hyperliquid mids --format tablegrimoire venue hyperliquid mids --format spellgrimoire venue hyperliquid l2-book --coin BTCgrimoire venue hyperliquid l2-book --coin BTC --format spellgrimoire venue hyperliquid open-orders --user 0x0000000000000000000000000000000000000000grimoire venue hyperliquid metagrimoire venue hyperliquid mids-snapshotgrimoire venue hyperliquid l2-book-snapshot --coin BTCgrimoire 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: ```spellhyperliquid.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: ```spellhl_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.