# Hyperliquid Reader

Read Hyperliquid (app.hyperliquid.xyz) perp and spot market data through opencli and...

- Repository: https://github.com/himself65/finance-skills (3487 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-25
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add himself65/finance-skills --skill hyperliquid-reader -g -a claude-code -y`
Codex: `npx skills add himself65/finance-skills --skill hyperliquid-reader -g -a codex -y`
Cursor: `npx skills add himself65/finance-skills --skill hyperliquid-reader -g -a cursor -y`
Gemini CLI: `npx skills add himself65/finance-skills --skill hyperliquid-reader -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add himself65/finance-skills`

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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](https://app.hyperliquid.xyz), the on-chain perps/spot DEX, for market data via [opencli](https://github.com/jackwener/opencli) and the `hyperliquid` plugin in this repo's [`opencli-plugins/hyperliquid`](https://github.com/himself65/finance-skills/tree/main/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:

The rest: https://github.com/himself65/finance-skills/blob/HEAD/plugins/data-providers/skills/hyperliquid-reader/SKILL.md