功能描述

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.

使用说明 (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"

安全使用建议

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.

功能分析

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`.

能力评估

✓ 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.

版本历史

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.

元数据

Slug hyperliquid

版本 1.0.0

许可证 —

累计安装 12

当前安装数 12

历史版本数 1

常见问题

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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2967 次。

如何安装 Hyperliquid？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install hyperliquid」即可一键安装，无需额外配置。

Hyperliquid 是免费的吗？

是的，Hyperliquid 完全免费（开源免费），可自由下载、安装和使用。

Hyperliquid 支持哪些平台？

Hyperliquid 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Hyperliquid？

由 The Ton Le（@k0nkupa）开发并维护，当前版本 v1.0.0。

Hyperliquid