Hyperliquid (read-only)

Implement read-only market-data queries for Hyperliquid using the Info HTTP endpoint:

• - INLINECODE0
• INLINECODE1

Prefer HTTP snapshot flows for v1. WebSocket streaming can be added later.

Supported user input styles

Treat these as equivalent:

• - Natural language: “Hyperliquid quote BTC”, “top movers 24h”, “book ETH”, “1h candles for SOL last 48”
• Terminal style: hl quote BTC, INLINECODE3
• Slash style: /hl quote BTC, INLINECODE5

Parse /hl and hl first (deterministic). If no prefix, fall back to intent extraction from natural language.

Canonical commands (v1)

Market data:

• - quote <coin>: show mark/mid/oracle, 24h change (prevDayPx), 24h notional volume, open interest (perps), funding (perps), premium, impact prices
• INLINECODE9: rank by 24h % change (markPx vs prevDayPx)
• INLINECODE10: rank by funding (perps only)
• INLINECODE11: show top 20 levels per side (and spread)
• INLINECODE12
• INLINECODE13: concise dashboard: top movers, top funding, top OI, top volume

Account (read-only):

• - positions <HL:0x..|0x..|label>: show perp positions + margin summary
• INLINECODE15: show spot balances
• INLINECODE16: show open orders
• INLINECODE17: show recent fills

Saved account aliases (stored locally in ~/.clawdbot/hyperliquid/config.json):

• - INLINECODE19
• INLINECODE20
• INLINECODE21
• INLINECODE22

Natural language equivalents should work too:

• - “store this address HL:0x... as sub account 1”
• “show me positions of sub account 1”

Data sources

Perpetuals:

• - metaAndAssetCtxs (preferred): universe + asset contexts for all perps
• INLINECODE24
• INLINECODE25

Spot (optional later):

• - spotMetaAndAssetCtxs, INLINECODE27

See references/hyperliquid-api.md for request bodies and field meanings.

Implementation guidance

Use the bundled scripts:

• - scripts/hyperliquid_api.mjs: thin HTTP client + helpers (safe defaults, timeouts)
• INLINECODE30: parses user text into an intent + args, calls API helpers, and prints a compact chat-friendly response

When responding:

• - Prefer short bullet output.
• Show units and timeframes.
• Handle missing fields gracefully (e.g., midPx sometimes null).

Quick manual test

Run locally:

CODEBLOCK0