Hyperliquid Reader - Hyperliquid Perpetual Futures Market Data and Funding Rate Query Skill

Skill Overview

hyperliquid-reader is a read-only Hyperliquid market data query skill. It uses opencli to call Hyperliquid’s public info API to retrieve perpetual and spot market prices, funding rates (hourly rates and annualized APR), open interest, trading volume, order books, and candlestick data in a single operation. It also supports comparing funding rate spreads between Hyperliquid, Binance, and Bybit—no API key or wallet connection required.

Applicable Scenarios

1. Perpetual futures market overview: View the mark/mid prices, 24-hour changes, funding rates, open interest (OI), and trading volume of assets such as BTC, ETH, and SOL. Sort by funding rate or price change to identify the most active contracts or those with the most extreme funding rates.
2. Cross-exchange funding rate arbitrage screening: Use funding-compare to compare the annualized funding rates and spreads of Hyperliquid, Binance, and Bybit side by side, quickly identifying assets with the largest rate discrepancies as potential arbitrage opportunities.
3. Pre-trade depth and trend analysis: Read the top N levels of the order book to calculate spreads, retrieve candlestick data across 14 time intervals ranging from 1 minute to 1 month to review price trends, or query historical funding rates to assess holding costs.

Core Features

1. Perpetual and spot market snapshots: A single command returns each contract’s mark/oracle/mid prices, 24-hour percentage change, hourly funding rate and annualized APR, open interest (in coin terms and nominal USD value), 24-hour trading volume, premium rate, and maximum leverage. The spot market provides prices, market capitalization, and circulating supply for pairs such as PURR/USDC.
2. Funding rate analysis and cross-exchange comparison: Funding rates are presented both as hourly rates and annualized APR (APR = hourly rate × 24 × 365). funding-compare annualizes rates according to each exchange’s own settlement interval, outputs the HL-vs-Binance and HL-vs-Bybit spreads, and sorts them by absolute spread. Historical funding rate series for any asset can also be queried.
3. Order book and candlestick data retrieval: The order book defaults to 10 levels on each side, with a maximum of 20 levels. Price levels can be aggregated to a specified number of significant figures. Candlestick data covers 14 intervals from 1m to 1M, with up to 5,000 candles per request. It outputs OHLCV and trade counts and supports five output formats: table, JSON, YAML, Markdown, and CSV.

Frequently Asked Questions

Do I need an API key or wallet connection to query Hyperliquid data?

No. All commands only request Hyperliquid’s fully public info API (POST https://api.hyperliquid.xyz/info), with no registration, private key, or client required. The skill is therefore free to use and does not access any account information.

Can hyperliquid-reader place trades for me?

No. This is an intentional security boundary. The skill only reads market data—market prices, funding rates, order books, and candlestick data. The plugin provides no interfaces for placing or canceling orders, transferring funds, or reading account data. Placing orders requires wallet-signed write operations and separate endpoints, which this skill never calls.

What do positive and negative funding rates mean? How is APR calculated?

A positive funding rate means that longs pay shorts; a negative rate means that shorts pay longs. Hyperliquid settles funding hourly, and annualized APR = hourly rate × 24 × 365. When comparing Binance and Bybit, funding-compare annualizes each rate according to the exchange’s own settlement interval—typically 4 or 8 hours—before calculating the spread. Note that the spread is only an arbitrage screening signal; actual returns must also account for trading fees and withdrawal friction.