Agent skill

Hyperliquid Reader

by majiayu000 in 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…

MITAuto-check passedBusiness, Finance & HR

Install Hyperliquid Reader

skills CLI
$ npx skills add majiayu000/claude-skill-registry --skill hyperliquid-reader -a claude-code

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

GitHub CLI
$ gh skill install majiayu000/claude-skill-registry hyperliquid-reader --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/majiayu000/claude-skill-registry.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/api/hyperliquid-reader .claude/skills/hyperliquid-reader && 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-reader
GitHub stars
666
Used in
1 other repo
Token cost
~2.3k tokens
SKILL.md length
1,037 words
Files
2
Skills in repo
1,273
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 5 steps: Ensure opencli + Plugin Are Installed… → Identify What the User Needs → Execute the Command → …
  • The user mentions Hyperliquid (HL
  • SKILL.md covers Step 1: Ensure opencli +…, Step 2: Identify What the User…, Step 3: Execute the Command and Step 4: Present the Results, plus 3 more sections
  • Calls npm; reaches api.hyperliquid.xyz

What it does

Hyperliquid Reader is an agent skill from 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 APR), open interest, volume, the L2 order book, OHLCV candles, funding history, and cross-venue funding comparisons (Hyperliquid vs Binance vs Bybit) for funding arbitrage. Use this skill whenever the user mentions Hyperliquid (HL, HL DEX, hyperliquid.xyz) or asks about its perps, spot pairs such as PURR, funding, open…

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `metadata.json`).

It sits in Business, Finance & HR, covering Stock and market analysis. It works with Hyperliquid and Binance. The repository describes itself as: Searchable Claude Code skills catalog with source-linked guides and generated registry artifacts. The licence is MIT.

When your agent uses it

  • The user mentions Hyperliquid (HL
  • Hyperliquid.xyz)
  • Asks about its perps
  • Spot pairs such as PURR

Example prompts

  • “/hyperliquid-reader”

Requirements

  • Node.js

Workflow steps

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

  1. Ensure opencli + Plugin Are Installed and Ready
  2. Identify What the User Needs
  3. Execute the Command
  4. Present the Results
  5. Diagnostics

What it can do on your machine

Read from SKILL.md and the folder at commit 2d14a69. 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

    Shell commands in SKILL.md call:

    • npm

    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

    Also links to:

    • github.com

    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 Reader loads about 2.3k tokens when it runs. Until then it costs about 159 tokens; SKILL.md has 1,037 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from majiayu000/claude-skill-registry at commit 2d14a69, republished under its MIT licence (© majiayu000). 1,037 words, ~2,335 tokens.

Download SKILL.mdSave it as .claude/skills/hyperliquid-reader/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
hyperliquid-reader
description
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 APR), open interest, volume, the L2 order book, OHLCV candles, funding history, and cross-venue funding comparisons (Hyperliquid vs Binance vs Bybit) for funding arbitrage. Use this skill whenever the user mentions Hyperliquid (HL, HL DEX, hyperliquid.xyz) or asks about its perps, spot pairs such as PURR, funding, open interest, order book, or candles. Read-only market data: no account, order, or transfer operations.

Hyperliquid Reader (Read-Only)

Reads Hyperliquid — the on-chain perps/spot DEX — for market data via opencli and the hyperliquid plugin in this repo's opencli-plugins/hyperliquid tree (a separate plugin from opencli's built-in adapters, installed via opencli's monorepo subpath syntax).

This skill is read-only and market-data only. It reads Hyperliquid's fully public info API for analysis: market tables, funding, order book, and candles. It does NOT read individual accounts, place/modify/cancel orders, or move funds. There is no trading path in the plugin — order placement requires wallet-signed actions on a separate endpoint this adapter never calls.

How it works: every command issues a single POST https://api.hyperliquid.xyz/info with a { "type": "..." } body and normalizes the response. No API key, no wallet, no login, no running app — the info API is public.


Step 1: Ensure opencli + Plugin Are Installed and Ready

Current environment status:

!`(command -v opencli && opencli hyperliquid markets --coin BTC -f json 2>&1 | head -3 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

If the status above shows READY, skip to Step 2. Otherwise:

NOT_INSTALLED — Install opencli
bash
npm install -g @jackwener/opencli

Requires Node.js >= 24 — the hyperliquid plugin declares engines.node >= 24.

SETUP_NEEDED — Install the Hyperliquid plugin

The Hyperliquid adapter is not built into opencli — it's a separate plugin:

bash
opencli plugin install github:himself65/finance-skills/hyperliquid

That's the entire setup — no auth, no launch step. Verify with opencli hyperliquid markets --coin BTC.

Common setup issues
SymptomFix
opencli: command not foundnpm install -g @jackwener/opencli (Node ≥ 24)
Unknown command: hyperliquidopencli plugin install github:himself65/finance-skills/hyperliquid
hyperliquid info 429Rate limited — wait a few seconds and retry

Step 2: Identify What the User Needs

User RequestCommandKey Flags
Perp markets overview / top by volumeopencli hyperliquid markets--sort, --limit, --coin
One perp's price + funding + OIopencli hyperliquid markets --coin BTC—
Spot pairs overviewopencli hyperliquid spot-markets--sort, --limit, --pair, --canonical-only
All current mid pricesopencli hyperliquid mids--coin <substring>
Order book for a coinopencli hyperliquid book --coin ETH--depth, --n-sig-figs
OHLCV candlesopencli hyperliquid candles --coin BTC --interval 1h--limit
Historical funding for a coinopencli hyperliquid funding-history --coin BTC--hours, --limit
Funding arb: HL vs Binance vs Bybitopencli hyperliquid funding-compare--coin, --sort, --limit

Step 3: Execute the Command

General pattern
bash
# Use -f json or -f yaml for structured output
opencli hyperliquid markets --sort fundingAprPct --limit 15 -f json
opencli hyperliquid funding-compare --sort hlVsBinancePct --limit 20 -f md
opencli hyperliquid candles --coin BTC --interval 4h --limit 50 -f csv
opencli hyperliquid book --coin ETH --depth 5 -f json
Key rules
  1. Coin symbols are bare perp names — BTC, ETH, SOL, HYPE (no exchange prefix). Spot pairs are BASE/USDC (e.g. PURR/USDC); for book/candles you can pass either a perp coin or a spot pair.
  2. markets is the default lens for "how is X / the market doing" — it carries mark/oracle/mid price, 24h change, hourly funding + APR, open interest (coins and notional), and 24h volume in one row per perp. Filter with --coin for a single asset.
  3. Funding is reported two ways — fundingHrPct is the raw hourly rate as a percent; fundingAprPct annualizes it (hourly × 24 × 365). Lead with APR when comparing carry across assets; use the hourly figure for "what will I pay next hour".
  4. funding-compare is the funding-arb screen — it annualizes each venue with its own interval (HL hourly, Binance/Bybit usually 4h) and reports hlVsBinancePct / hlVsBybitPct spreads. Default sort ranks by absolute HL-vs-Binance spread (widest dislocations first). A positive hlVsBinancePct means HL longs pay more than Binance longs.
  5. book defaults to 10 levels per side — raise --depth (max 20) for more, or --n-sig-figs 2..5 to aggregate price levels. Compute the spread/mid from the top bid and ask.
  6. candles pulls the most recent --limit candles of --interval (default 1h, 100 candles). Valid intervals: 1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d 3d 1w 1M. Max 5000.
  7. -f json for programmatic processing / feeding other skills; -f md or -f table for human-readable output.
  8. Read-only market data. No account reads, no order placement, modification, or cancellation, and no transfers — the plugin intentionally exposes no write endpoints, so don't look for workarounds.
Output format flag (-f)
FormatFlagBest for
Table-f table (default)Human-readable terminal output
JSON-f jsonProgrammatic processing, LLM context
YAML-f yamlStructured, readable
Markdown-f mdReports
CSV-f csvSpreadsheet export
Show full SKILL.md (400 more words)Show less
Output columns
  • markets — coin, markPx, midPx, oraclePx, change24hPct, fundingHrPct, fundingAprPct, openInterest, oiNotional, dayNtlVlm, premiumPct, maxLeverage
  • spot-markets — pair, base, markPx, midPx, change24hPct, dayNtlVlm, circulatingSupply, marketCap, canonical
  • mids — coin, mid
  • book — side, level, px, sz, orders
  • candles — time, open, high, low, close, volume, trades
  • funding-history — coin, fundingRatePct, fundingAprPct, premiumPct, time
  • funding-compare — coin, hlAprPct, binanceAprPct, bybitAprPct, hlVsBinancePct, hlVsBybitPct, nextHlFunding

Step 4: Present the Results

  1. Lead with the headline number, then the table. For markets --coin BTC: state mark price, 24h change, funding APR, and open interest in prose first. For a full markets dump: lead with the count and the top movers / highest-funding names.
  2. Frame funding in carry terms — e.g. "BTC perp funding is +10.9% APR (longs pay shorts)". Positive funding ⇒ longs pay shorts; negative ⇒ shorts pay longs.
  3. For funding-compare, surface the widest dislocations first — name the coin, both venues' APRs, and the spread, and remember the spread is annualized; a real arb also pays exchange/withdrawal frictions, so present it as a screen, not a guaranteed edge.
  4. For book, report the spread — best bid, best ask, mid, and spread in bps before (or instead of) dumping every level. Don't paste 20 levels unless asked.
  5. For candles, describe the move — first/last close, high/low, and direction; only show the full OHLCV table when the user wants the series.
  6. Filter aggressively before showing — markets has ~180 perps and mids ~700 markets; cap to top 15-20 by the relevant sort unless the user asks for the full list.
  7. Cross-reference for trade decisions — Hyperliquid is the on-chain venue; for equities/options context pair it with the tradingview-reader skill. For funding/basis trades, funding-compare plus markets (premium, OI) is the core view.

Step 5: Diagnostics

bash
opencli hyperliquid markets --coin BTC

A successful BTC row confirms opencli, the plugin, and the public API are all reachable. If it errors with Unknown command: hyperliquid, reinstall the plugin (Step 1). A hyperliquid info 4xx/5xx is an upstream API issue — retry after a short wait.


Error Reference

ErrorCauseFix
Unknown command: hyperliquidPlugin not installedopencli plugin install github:himself65/finance-skills/hyperliquid
hyperliquid info 429Rate limitedWait a few seconds, then retry
hyperliquid info 422/500Malformed body or upstream issueRe-check the coin/interval; retry after a wait
No perp market for coin "X"Wrong/unlisted symbolRun opencli hyperliquid markets (or mids) to find the exact symbol

Reference Files

  • references/commands.md — Every command with all flags, output schemas, and analyst workflows (funding carry, basis/arb, spot snapshot)

© majiayu000, 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 in skills/api/hyperliquid-reader of majiayu000/claude-skill-registry.

  • SKILL.md
  • metadata.json

Open the folder on GitHubat commit 2d14a69

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in majiayu000/claude-skill-registry, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hyperliquid Reader 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 Reader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hyperliquid Reader this skillmajiayu000/claude-skill-registry6661 repos~2.3kAutomated safety check: PassMIT
Heytraders APILeoYeAI/openclaw-master-skills2.2k—~4.2kAutomated safety check: PassMIT
Fintoolsecond-state/fintool3161 repos~5.9kAutomated safety check: PassNone
Query Token Infobinance/binance-skills-hub1.1k—~922Automated safety check: PassNone
Crypto Reportaahl/skills1622 repos~122Automated safety check: PassMIT
Exchange ConnectorSignal-Execution-Labs/forex-trading-ai-agent161—~1kAutomated safety check: PassMIT

Similar skills

  • 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
  • Fintool

    second-state/fintool

    Financial trading CLIs — spot and perp trading on Hyperliquid, Binance, Coinbase, OKX.

    316 GitHub starsUsed in 1 repo~5.9k tokens
    Business, Finance & HRAuto-check passed
  • Query Token Info

    binance/binance-skills-hub

    Per-token details for a specific token identified by keyword, symbol, or contract address: (1) search — find tokens by keyword/symbol/contract; (2) meta — static info: name, symbol, logo, social…

    1.1k GitHub stars~922 tokensUpdated 27 days ago
    Business, Finance & HRAuto-check passed
  • Crypto Report

    aahl/skills

    Get cryptocurrency market data. An agent skill from aahl/skills.

    162 GitHub starsUsed in 2 repos~122 tokens
    Business, Finance & HRAuto-check passed
  • Exchange Connector

    Signal-Execution-Labs/forex-trading-ai-agent

    Connect to crypto exchanges (Binance, Kraken, Coinbase, etc.).

    161 GitHub stars~1k tokensUpdated 24 days ago
    Business, Finance & HRAuto-check passed
  • Hyperliquid

    Luciole-Studio/Misaka-Agent

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

    139 GitHub starsUsed in 2 repos~1.7k tokens
    Business, Finance & HRAuto-check: notes

More from majiayu000/claude-skill-registry

All 1,273 skills in this repo
  • Deep Research

    majiayu000/claude-skill-registry

    Multi-source deep research using firecrawl and exa MCPs. An agent skill from majiayu000/claude-skill-registry.

    666 GitHub starsUsed in 6 repos~1.1k tokens
    Auto-check passed
  • Exa Search

    majiayu000/claude-skill-registry

    Neural search via Exa MCP for web, code, and company research.

    666 GitHub starsUsed in 5 repos~856 tokens
    Auto-check passed
  • Fal AI Media

    majiayu000/claude-skill-registry

    Unified media generation via fal.ai MCP — image, video, and audio.

    666 GitHub starsUsed in 5 repos~1.7k tokens
    Auto-check passed
  • Pyzotero

    majiayu000/claude-skill-registry

    Interact with Zotero reference management libraries using the pyzotero Python client.

    666 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check: notes
  • Bgpt Paper Search

    majiayu000/claude-skill-registry

    Search scientific papers and retrieve structured experimental data extracted from full-text studies via the BGPT MCP server.

    666 GitHub starsUsed in 4 repos~619 tokens
    Auto-check: notes
  • Bio Alignment Pairwise

    majiayu000/claude-skill-registry

    Perform pairwise sequence alignment using Biopython Bio.Align.PairwiseAligner.

    666 GitHub starsUsed in 4 repos~1.7k tokens
    Auto-check passed

Questions about Hyperliquid Reader

What does Hyperliquid Reader do?

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…. Hyperliquid Reader is an agent skill from majiayu000/claude-skill-registry.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 APR), open interest, volume, the L2 order book, OHLCV candles, funding history, and cross-venue funding comparisons (Hyperliquid vs Binance vs Bybit) for funding arbitrage.

When should I use Hyperliquid Reader?

Hyperliquid Reader fits situations like: the user mentions Hyperliquid (HL; hyperliquid.xyz); asks about its perps; spot pairs such as PURR.

How do I install Hyperliquid Reader in Claude Code?

Run `npx skills add majiayu000/claude-skill-registry --skill hyperliquid-reader -a claude-code`. Or copy the skill folder (skills/api/hyperliquid-reader in majiayu000/claude-skill-registry) into .claude/skills/hyperliquid-reader in your project. Claude Code loads it when a task matches its description.

How do I install Hyperliquid Reader in Codex?

Run `npx skills add majiayu000/claude-skill-registry --skill hyperliquid-reader -a codex`. Or copy the skill folder (skills/api/hyperliquid-reader in majiayu000/claude-skill-registry) into .agents/skills/hyperliquid-reader in your project. Codex loads it when a task matches its description.

Can I use Hyperliquid Reader 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 majiayu000/claude-skill-registry --skill hyperliquid-reader -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-reader, .gemini/skills/hyperliquid-reader, .github/skills/hyperliquid-reader and .opencode/skills/hyperliquid-reader in your project.

What does Hyperliquid Reader need to run?

Going by SKILL.md and its folder, Hyperliquid Reader needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Hyperliquid Reader access the network?

SKILL.md names 2 domains. In commands or code: api.hyperliquid.xyz; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is Hyperliquid Reader safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hyperliquid Reader use?

Hyperliquid Reader is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hyperliquid Reader use?

About 2.3k tokens (SKILL.md is roughly 9.3k 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 Reader?

Skills that share tags, products or a category with Hyperliquid Reader: Heytraders API (LeoYeAI/openclaw-master-skills, 2.2k stars), Fintool (second-state/fintool, 316 stars), Query Token Info (binance/binance-skills-hub, 1.1k stars) and Crypto Report (aahl/skills, 162 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hyperliquid Reader?

majiayu000 (a GitHub user) maintains it in majiayu000/claude-skill-registry, which has 666 GitHub stars. The repository holds 1,273 skills in this directory. The repository was last updated on October 7, 2026.

Source: majiayu000/claude-skill-registry on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.