Agent skill

Hyperliquid

by Luciole-Studio in Luciole-Studio/Misaka-Agent

Hyperliquid market data, account history, trade review. An agent skill from Luciole-Studio/Misaka-Agent.

MITAuto-check: notesBusiness, Finance & HR

Install Hyperliquid

skills CLI
$ npx skills add Luciole-Studio/Misaka-Agent --skill hyperliquid -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Luciole-Studio/Misaka-Agent hyperliquid --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/misaka/core/skills/assets/optional/blockchain/hyperliquid .claude/skills/hyperliquid && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hyperliquid
GitHub stars
125
Used in
2 other repos
Token cost
~1.7k tokens
SKILL.md length
519 words
Files
2 (incl. scripts)
Skills in repo
76
Repo updated
First seen
Licence
MIT

At a glance

Hyperliquid market data, account history, trade review. An agent skill from Luciole-Studio/Misaka-Agent.

  • Works in 7 steps: Discover DEXs and Markets → Pull Historical Market Data → Inspect Live Order Book → …
  • Tasks that involve Stock and market analysis
  • SKILL.md covers When to Use, Prerequisites, How to Run and Quick Reference, plus 3 more sections
  • Runs Python scripts from its folder; calls python; reaches api.hyperliquid.xyz and api.hyperliquid-testnet.xyz

What it does

Hyperliquid is an agent skill from Luciole-Studio/Misaka-Agent. Hyperliquid market data, account history, trade review.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/hyperliquid_client.py`).

It sits in Business, Finance & HR, covering Stock and market analysis. It works with Hyperliquid. The repository describes itself as: A multi-agent research system for the humanities and social sciences. The licence is MIT.

When your agent uses it

  • Tasks that involve Stock and market analysis

Example prompts

  • “/hyperliquid”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Discover DEXs and Markets
  2. Pull Historical Market Data
  3. Inspect Live Order Book
  4. Review an Account
  5. Review Fills and Orders
  6. Generate a Trade Review
  7. Export a Reusable Dataset

What it can do on your machine

Read from SKILL.md and the folder at commit 77871d7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.hyperliquid.xyz
    • api.hyperliquid-testnet.xyz

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hyperliquid loads about 1.7k tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 519 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:39
    script reads `${HERMES_HOME:-~/.hermes}/.env` for two optional defaults:
  • NoteMentions a .env fileSKILL.md:47
    A project `.env` in the current working directory is honored as a dev fallback.
  • NoteMentions a .env fileSKILL.md:83
    SS` is set in `${HERMES_HOME:-~/.hermes}/.env`.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Luciole-Studio/Misaka-Agent at commit 77871d7, republished under its MIT licence (© Luciole-Studio). 519 words, ~1,728 tokens.

Download SKILL.mdSave it as .claude/skills/hyperliquid/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
hyperliquid
description
Hyperliquid market data, account history, trade review.
version
0.1.0
author
Hugo Sequier (Hugo-SEQUIER), Hermes Agent
license
MIT
platforms
linux, macos, windows

Hyperliquid Skill

Query Hyperliquid market and account data through the public /info endpoint. Read-only — no API key, no signing, no order placement.

12 commands: dexs, markets, spots, candles, funding, l2, state, spot-balances, fills, orders, review, export. Stdlib only (urllib, json, argparse).


When to Use

  • User asks for Hyperliquid perp or spot market data, candles, funding, or L2 book
  • User wants to inspect a wallet's perp positions, spot balances, fills, or orders
  • User wants a post-trade review combining recent fills with market context
  • User wants to inspect builder-deployed perp dexs or HIP-3 markets
  • User wants a normalized JSON export of candles + funding for backtesting prep

Prerequisites

Stdlib only — no external packages, no API key.

The script reads ${HERMES_HOME:-~/.hermes}/.env for two optional defaults:

  • HYPERLIQUID_API_URL — defaults to https://api.hyperliquid.xyz. Set to https://api.hyperliquid-testnet.xyz for testnet.
  • HYPERLIQUID_USER_ADDRESS — default address for state, spot-balances, fills, orders, and review. If unset, pass the address as the first positional argument.

A project .env in the current working directory is honored as a dev fallback.

Helper script: ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py


How to Run

Invoke through the terminal tool:

bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py <command> [args]

Add --json to any command for machine-readable output.


Quick Reference

bash
hyperliquid_client.py dexs
hyperliquid_client.py markets [--dex DEX] [--limit N] [--sort volume|oi|funding_abs|change_abs|name]
hyperliquid_client.py spots [--limit N]
hyperliquid_client.py candles <coin> [--interval 1h] [--hours 24] [--limit N]
hyperliquid_client.py funding <coin> [--hours 72] [--limit N]
hyperliquid_client.py l2 <coin> [--levels N]
hyperliquid_client.py state [address] [--dex DEX]
hyperliquid_client.py spot-balances [address] [--limit N]
hyperliquid_client.py fills [address] [--hours N] [--limit N] [--aggregate-by-time]
hyperliquid_client.py orders [address] [--limit N]
hyperliquid_client.py review [address] [--coin COIN] [--hours N] [--fills N]
hyperliquid_client.py export <coin> [--interval 1h] [--hours N] [--output PATH]

For state, spot-balances, fills, orders, and review, the address is optional when HYPERLIQUID_USER_ADDRESS is set in ${HERMES_HOME:-~/.hermes}/.env.


Procedure

1. Discover DEXs and Markets
bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py dexs

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  markets --limit 15 --sort volume

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  spots --limit 15
  • --dex only applies to perp endpoints; omit for the first perp dex.
  • Spot pairs may show as PURR/USDC or aliases like @107.
  • HIP-3 markets prefix the coin with the dex, e.g. mydex:BTC.
2. Pull Historical Market Data
bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  candles BTC --interval 1h --hours 72 --limit 48

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  funding BTC --hours 168 --limit 30

Time-range endpoints paginate. For larger windows, repeat with a later startTime or use export (below).

3. Inspect Live Order Book
bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  l2 BTC --levels 10

Use when asked about book depth, near-term liquidity, or potential market impact of a large order.

4. Review an Account
bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  state 0xabc...

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  spot-balances

state returns perp positions; spot-balances returns spot inventory. Use these for "how are my positions?", "what am I holding?", "how much is withdrawable?".

5. Review Fills and Orders
bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  fills 0xabc... --hours 72 --limit 25

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  orders --limit 25
Show full SKILL.md (206 more words)Show less
6. Generate a Trade Review
bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  review 0xabc... --hours 72 --fills 50

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  review --coin BTC --hours 168

Reports realized PnL, fees, win/loss counts, coin breakdowns, market trend and average funding for each traded perp, plus heuristics (fee drag, concentration, counter-trend losses).

For deeper post-trade analysis: start with review to find problem coins or windows → pull fills and orders for that period → pull candles and funding for each traded coin → judge decision quality separately from outcome quality.

7. Export a Reusable Dataset
bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  export BTC --interval 1h --hours 168 --output ./btc-1h-7d.json

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  export BTC --interval 15m --hours 72 --end-time-ms 1760000000000

Output JSON contains: schema version, source metadata, exact time window, normalized candle rows, normalized funding rows, summary stats. Use --end-time-ms for reproducible windows.


Pitfalls

  • Public info endpoints are rate-limited. Large historical queries may return capped windows; iterate with later startTime values.
  • fills --hours ... uses userFillsByTime, which only exposes a recent rolling window — not full archive history.
  • historicalOrders returns recent orders only; not a full export.
  • The review command is heuristic. It cannot reconstruct intent, order placement quality, or true slippage from fills alone.
  • The export command writes a normalized dataset, not a backtest engine. You still need your own slippage/fill model.
  • Spot aliases like @107 are valid identifiers even when the UI shows a friendlier name.
  • l2 is a point-in-time snapshot, not a time series.

Verification

bash
python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  markets --limit 5

Should print the top Hyperliquid perp markets by 24h notional volume.

© Luciole-Studio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in misaka/core/skills/assets/optional/blockchain/hyperliquid of Luciole-Studio/Misaka-Agent.

  • SKILL.md
  • scripts/hyperliquid_client.py

Open the folder on GitHubat commit 77871d7

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in Luciole-Studio/Misaka-Agent, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hyperliquid next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hyperliquid compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hyperliquid this skillLuciole-Studio/Misaka-Agent1252 repos~1.7kAutomated safety check: NotesMIT
Crypto Pricesundial-org/awesome-openclaw-skills663—~489Automated safety check: PassNone
Hyperliquid Readermajiayu000/claude-skill-registry6661 repos~2.3kAutomated safety check: PassMIT
Heytraders APILeoYeAI/openclaw-master-skills2.2k—~4.2kAutomated safety check: PassMIT
0xarchiveLeoYeAI/openclaw-master-skills2.2k—~4.4kAutomated safety check: NotesMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT

Similar skills

  • Crypto Price

    sundial-org/awesome-openclaw-skills

    Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API.

    663 GitHub stars~489 tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • Hyperliquid Reader

    majiayu000/claude-skill-registry

    Read Hyperliquid (app.hyperliquid.xyz) perp and spot market data through opencli and Hyperliquid's public info API: mark, oracle, and mid prices, 24h change, funding rates (hourly and annualized…

    666 GitHub starsUsed in 1 repo~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Heytraders API

    LeoYeAI/openclaw-master-skills

    Trade crypto (Binance, Upbit, Hyperliquid, Lighter) and prediction markets (Polymarket).

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • 0xarchive

    LeoYeAI/openclaw-master-skills

    Query historical crypto market data from 0xArchive across Hyperliquid, Lighter.xyz, and HIP-3.

    2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
    Data & AnalyticsAuto-check: notes
  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    318 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed

More from Luciole-Studio/Misaka-Agent

All 76 skills in this repo
  • Kanban Video Orchestrator

    Luciole-Studio/Misaka-Agent

    Plan and run multi-agent video production pipelines. An agent skill from Luciole-Studio/Misaka-Agent.

    125 GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check: notes
  • Ast Grep

    Luciole-Studio/Misaka-Agent

    AST-aware structural code search and rewrite via ast-grep. An agent skill from Luciole-Studio/Misaka-Agent.

    125 GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Drug Discovery

    Luciole-Studio/Misaka-Agent

    Drug discovery: ChEMBL search, drug-likeness, interactions. An agent skill from Luciole-Studio/Misaka-Agent.

    125 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Fitness Nutrition

    Luciole-Studio/Misaka-Agent

    Workout planning, macros, and body metrics via wger/USDA. An agent skill from Luciole-Studio/Misaka-Agent.

    125 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Hyperframes

    Luciole-Studio/Misaka-Agent

    Render MP4/WebM videos from HTML compositions. An agent skill from Luciole-Studio/Misaka-Agent.

    125 GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check passed
  • Osint Investigation

    Luciole-Studio/Misaka-Agent

    Follow the money via public records and sanctions data. An agent skill from Luciole-Studio/Misaka-Agent.

    125 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed

Works with

Questions about Hyperliquid

What does Hyperliquid do?

Hyperliquid market data, account history, trade review. An agent skill from Luciole-Studio/Misaka-Agent. Hyperliquid is an agent skill from Luciole-Studio/Misaka-Agent. Hyperliquid market data, account history, trade review.

When should I use Hyperliquid?

Hyperliquid fits situations like: tasks that involve Stock and market analysis.

How do I install Hyperliquid in Claude Code?

Run `npx skills add Luciole-Studio/Misaka-Agent --skill hyperliquid -a claude-code`. Or copy the skill folder (misaka/core/skills/assets/optional/blockchain/hyperliquid in Luciole-Studio/Misaka-Agent) into .claude/skills/hyperliquid in your project. Claude Code loads it when a task matches its description.

How do I install Hyperliquid in Codex?

Run `npx skills add Luciole-Studio/Misaka-Agent --skill hyperliquid -a codex`. Or copy the skill folder (misaka/core/skills/assets/optional/blockchain/hyperliquid in Luciole-Studio/Misaka-Agent) into .agents/skills/hyperliquid in your project. Codex loads it when a task matches its description.

Can I use Hyperliquid in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Luciole-Studio/Misaka-Agent --skill hyperliquid -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hyperliquid, .gemini/skills/hyperliquid, .github/skills/hyperliquid and .opencode/skills/hyperliquid in your project.

What does Hyperliquid need to run?

Going by SKILL.md and its folder, Hyperliquid needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Hyperliquid access the network?

SKILL.md names 2 domains. In commands or code: api.hyperliquid.xyz and api.hyperliquid-testnet.xyz; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Hyperliquid safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Hyperliquid use?

Hyperliquid is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hyperliquid use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hyperliquid?

Skills that share tags, products or a category with Hyperliquid: Crypto Price (sundial-org/awesome-openclaw-skills, 663 stars), Hyperliquid Reader (majiayu000/claude-skill-registry, 666 stars), Heytraders API (LeoYeAI/openclaw-master-skills, 2.2k stars) and 0xarchive (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hyperliquid?

Luciole-Studio (a GitHub organization) maintains it in Luciole-Studio/Misaka-Agent, which has 125 GitHub stars. The repository holds 76 skills in this directory. The repository was last updated on October 7, 2026.

Source: Luciole-Studio/Misaka-Agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.