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.

README (SKILL.md)

Hyperliquid (read-only)

Name: Hyperliquid
Author: k0nkupa

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 \x3Ccoin>: 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 \x3Ccoin>: show top 20 levels per side (and spread)
candles \x3Ccoin> --interval \x3C1m|...|1M> (--last N | --start \x3Cms> --end \x3Cms>)
overview: concise dashboard: top movers, top funding, top OI, top volume

Account (read-only):

positions \x3CHL:0x..|0x..|label>: show perp positions + margin summary
balances \x3CHL:0x..|0x..|label>: show spot balances
orders \x3CHL:0x..|0x..|label>: show open orders
fills \x3CHL: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"

Usage Guidance

This skill appears to do exactly what it says: read-only market data and account lookups via the Hyperliquid Info POST API. Before installing, consider: 1) It will store any saved EVM addresses in plaintext under ~/.clawdbot/hyperliquid/config.json — don't store private keys or secrets there. 2) When you query positions/balances/orders/fills you are sending addresses to the remote endpoint (https://api.hyperliquid.xyz/info by default), which is expected but may be a privacy concern if you query identifying addresses. 3) The client allows overriding the endpoint via HYPERLIQUID_INFO_URL — ensure your runtime environment hasn't set this to an untrusted host (otherwise queries could be redirected). 4) If you want extra caution, inspect and run the included scripts locally (they are small JS files) or avoid saving sensitive addresses as aliases. Overall the skill is coherent and proportional to its stated purpose.

Capability Analysis

Type: OpenClaw Skill Name: hyperliquid Version: 1.0.0 The OpenClaw skill bundle for Hyperliquid is benign. It is explicitly stated as 'read-only' and interacts solely with the public Hyperliquid Info API (`https://api.hyperliquid.xyz/info`). Local configuration, such as account aliases, is stored transparently in `~/.clawdbot/hyperliquid/config.json`. There is no evidence of data exfiltration, malicious execution, persistence, obfuscation, or prompt injection attempts against the agent beyond legitimate instructions for parsing user input and formatting responses, as seen in `SKILL.md` and `scripts/hyperliquid_chat.mjs`.

Capability Assessment

✓ Purpose & Capability

Name/description, API client, and CLI/chat parser align: the code calls the Hyperliquid Info endpoint to fetch quotes, books, candles and read-only account views. No unrelated credentials or binaries are requested.

ℹ Instruction Scope

SKILL.md and scripts operate within the stated scope, but they do read/write a local config (~/.clawdbot/hyperliquid/config.json) to store account aliases and will POST user-supplied EVM addresses to the Hyperliquid info endpoint when doing account queries. This is expected for account lookups but is worth noting for privacy.

✓ Install Mechanism

No install spec; instruction-only with bundled JS source. Nothing is downloaded from external URLs during install.

ℹ Credentials

The skill requires no env vars or credentials. The code supports optional env overrides (HYPERLIQUID_INFO_URL, HYPERLIQUID_TIMEOUT_MS, CLAWDBOT_HYPERLIQUID_CONFIG) but does not require them. Optional envs allow configuration but could redirect requests if set by the host.

ℹ Persistence & Privilege

always:false (not force-included). The skill persists only its own config file under the user's home directory (~/.clawdbot/hyperliquid/config.json). It does not alter other skills or system-wide agent settings.

Version History

v1.0.0

- Initial release of the Hyperliquid read-only market data assistant. - Supports natural language, terminal-style (`hl ...`), and slash-style (`/hl ...`) commands. - Fetches real-time market data: quotes, top movers, funding rankings, L2 order book, and candle snapshots via Hyperliquid API. - Includes read-only account queries: positions, balances, open orders, and fills, with local account alias management. - Provides concise, chat-friendly output for all queries.

Metadata

Slug hyperliquid

Version 1.0.0

License —

All-time Installs 12

Active Installs 12

Total Versions 1

Frequently Asked Questions

What is Hyperliquid?

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. It is an AI Agent Skill for Claude Code / OpenClaw, with 2967 downloads so far.

How do I install Hyperliquid?

Run "/install hyperliquid" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Hyperliquid free?

Yes, Hyperliquid is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Hyperliquid support?

Hyperliquid is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Hyperliquid?

It is built and maintained by The Ton Le (@k0nkupa); the current version is v1.0.0.

More Skills

Hyperliquid