hyperliquid – OpenClaw Skill

---

name: hyperliquid description: Read-only Hyperliquid market data assistant (perps + spot optional) with support for natural-language requests and deterministic command parsing (terminal-style hl ... and slash-style /hl ...). Use to fetch quotes (mark/mid/oracle/funding/OI/volume), top movers, funding rankings, L2 order book, and candle snapshots via https://api.hyperliquid.xyz/info, and to format results for chat.

Hyperliquid (read-only)

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

• POST https://api.hyperliquid.xyz/info
• Content-Type: application/json

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, hl movers --top 10 --window 24h
• Slash style: /hl quote BTC, /hl overview

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
• movers [--window 24h] [--top N]: rank by 24h % change (markPx vs prevDayPx)
• funding-top|funding-bottom [--n N]: rank by funding (perps only)
• book <coin>: show top 20 levels per side (and spread)
• candles <coin> --interval <1m|...|1M> (--last N | --start <ms> --end <ms>)
• overview: concise dashboard: top movers, top funding, top OI, top volume

Account (read-only):

• positions <HL:0x..|0x..|label>: show perp positions + margin summary
• balances <HL:0x..|0x..|label>: show spot balances
• orders <HL:0x..|0x..|label>: show open orders
• fills <HL:0x..|0x..|label> [--n N]: show recent fills

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

• account list
• account add "sub account 1" HL:0x... [--default]
• account remove "sub account 1"
• account default "sub account 1"

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
• l2Book
• candleSnapshot

Spot (optional later):

• spotMetaAndAssetCtxs, spotMeta

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)
• scripts/hyperliquid_chat.mjs: 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:

node skills/hyperliquid/scripts/hyperliquid_chat.mjs "hl quote BTC"
node skills/hyperliquid/scripts/hyperliquid_chat.mjs "/hl movers --top 5"

Hyperliquid Skill (Clawdbot)

Read-only Hyperliquid assistant for market data + account views.

• Supports natural language, terminal-style (hl ...), and slash-style (/hl ...).
• Uses Hyperliquid Info endpoint: POST https://api.hyperliquid.xyz/info
• No trading, no private keys.

Features

Market data (perps)

• Quotes: mark/mid/oracle, 24h change, 24h notional volume, open interest, funding, premium, impact prices
• Movers (24h)
• Funding rankings (top/bottom)
• L2 order book (top levels)
• Candle snapshots (common intervals)
• Overview dashboard

Account (read-only)

Given an EVM address (master or sub-account), you can view:

• Perp positions + margin summary
• Spot balances
• Open orders
• Recent fills

Note: Use the address that actually owns the account/positions. Using an agent wallet address may return empty results.

Usage

Natural language examples

• “What are the top movers on Hyperliquid today?”
• “Hyperliquid quote BTC”
• “Show me the order book for ETH”
• “Give me 1h candles for SOL for the last 48 bars”
• “Show my Hyperliquid positions HL:0x….”

Terminal / slash commands

Market

• hl quote BTC
• /hl movers --top 10
• hl funding-top --n 10
• hl funding-bottom --n 10
• hl book ETH
• hl candles SOL --interval 1h --last 48
• hl overview

Account (read-only)

• hl positions HL:0x...
• hl balances HL:0x...
• hl orders HL:0x...
• hl fills HL:0x... --n 10

Saved account aliases (recommended)

Accounts are stored locally in:

• ~/.clawdbot/hyperliquid/config.json

Add / list / remove

• hl account add "sub account 1" HL:0x... --default
• hl account list
• hl account remove "sub account 1"
• hl account default "sub account 1"

Use by label

• hl positions "sub account 1"
• hl balances "sub account 1"
• hl orders "sub account 1"
• hl fills "sub account 1" --n 5

If a default account is set, you can omit the argument:

• hl positions

Local dev

Run the chat script directly:

node scripts/hyperliquid_chat.mjs "hl quote BTC"
node scripts/hyperliquid_chat.mjs "What are the top movers on Hyperliquid today?"
node scripts/hyperliquid_chat.mjs "hl positions HL:0x..."

Files

• SKILL.md — skill instructions/triggering
• scripts/hyperliquid_api.mjs — HTTP client + helpers
• scripts/hyperliquid_chat.mjs — parser + command dispatcher + formatting
• scripts/hyperliquid_config.mjs — saved account aliases
• references/hyperliquid-api.md — API notes