Hyperliquid Reader
Read Hyperliquid (app.hyperliquid.xyz) perp and spot market data through opencli and...
Install
npx skills add himself65/finance-skills --skill hyperliquid-reader -g -a claude-code -y- Repository
- himself65/finance-skills3.5k
- Category
- Engineering
- Updated
- 10d ago
- License
- MIT
- Context cost
- Mediumabout 2,229 tokens
- Runs scripts
- No, instructions only
What it does
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)
If your host has not already executed the shell probes below (for example, in Codex), run the commands inside the ! wrappers with its shell tool before choosing a setup path. Use the actual output; if shell access is unavailable, report that limitation.
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
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:
