✓ Verified 📊 Data Processing ✓ Enhanced Data

Hyperliquid

Read-only Hyperliquid market data assistant (perps + spot optional)

Rating
4.5 (456 reviews)
Downloads
949 downloads
Version
1.0.0

Overview

Read-only Hyperliquid market data assistant (perps + spot optional)

Complete Documentation

View Source →

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 : 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 : show top 20 levels per side (and spread)
  • candles --interval <1m|...|1M> (--last N | --start --end )
  • overview: concise dashboard: top movers, top funding, top OI, top volume
Account (read-only):
  • positions : show perp positions + margin summary
  • balances : show spot balances
  • orders : show open orders
  • fills [--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:

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

Installation

Terminal bash 

openclaw install hyperliquid
Copied!

Tags

#data_and-analytics #data

Quick Info

Category Data Processing
Model Claude 3.5
Complexity One-Click
Author k0nkupa
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install hyperliquid

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0
✓ Verified 💻 Development

Adversarial Prompting

Adversarial analysis to critique, fix.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.6 (372)
↓ 28,222
v1.0.0