hyperliquid_skill

Overview

This skill provides a read-only Hyperliquid market-data assistant that answers natural-language and deterministic terminal/slash commands. It fetches perp (and optional spot) data from the Hyperliquid Info HTTP endpoint and formats compact, chat-friendly summaries for quotes, movers, funding, order books, candles, and account reads. Use it for fast market checks, dashboards, and reproducible command-line queries.

How this skill works

The skill sends JSON POST requests to https://api.hyperliquid.xyz/info and consumes endpoints such as metaAndAssetCtxs, l2Book, and candleSnapshot. It supports three input styles: deterministic prefixes (hl or /hl), terminal-style commands, and natural-language fallbacks. Responses are parsed and formatted into short bullet lists with units and timeframes, handling missing fields gracefully (e.g., null midPx).

When to use it

• Quickly fetch a mark/mid/oracle quote for a perp or spot symbol
• Rank markets by 24h movers, funding rates, open interest, or volume
• Inspect L2 order book top levels and spread before placing trades
• Grab candle snapshots for charting or back-of-envelope analysis
• Generate concise dashboards (overview) for market monitoring

Best practices

• Prefer deterministic commands (hl or /hl) for reproducible results
• Use the HTTP snapshot flow for v1 rather than streaming WebSocket
• Include --interval and --last or start/end for precise candle queries
• Request top-N or window flags to limit results and reduce payload
• Interpret null or missing fields conservatively and show fallbacks

Example use cases

• hl quote BTC — get mark/mid/oracle, 24h change, funding, OI and volume
• hl movers --window 24h --top 10 — identify top 24h % winners and losers
• hl book ETH — view top 20 levels per side and current spread
• hl candles SOL --interval 1h --last 48 — fetch last 48 hourly candle snapshots
• hl overview — compact dashboard: top movers, funding leaders, top OI and volume