@pipeworx/hyperliquid

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/hyperliquid’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 7

Read-only market data for Hyperliquid, the largest onchain perpetuals exchange (it also runs a spot market) — mid prices, order books, candles, funding rates/history and live open interest — proxied live, per request, from Hyperliquid’s own public info API. No wallet, no signing, no trading: the exchange/signed-order endpoints are out of scope on purpose.

Tools

• hyperliquid_perp_meta(coin?) — the perps universe (symbol, size decimals, max leverage, delisted flag). Pass coin for one symbol, omit for the whole list.
• hyperliquid_spot_meta() — every spot trading pair Hyperliquid lists, each with its pair name, pair index, and the token ids it is composed of.
• hyperliquid_mids(coin?) — current mid price for every perp/spot symbol in one call, or just one symbol’s mid price.
• hyperliquid_asset_context(coin) — a perp’s live funding rate, open interest, mark/oracle/mid price, premium, and 24h volume.
• hyperliquid_l2_book(coin, depth?) — the live bid/ask order book (price, aggregate size, order count per level).
• hyperliquid_candles(coin, interval?, lookback_hours?, start_time?, end_time?) — OHLCV candles for any window Hyperliquid retains.
• hyperliquid_funding_history(coin, lookback_hours?, start_time?, end_time?) — the realized funding-rate series (Hyperliquid pays funding hourly).

Auth

Keyless. Hyperliquid’s info endpoint (POST api.hyperliquid.xyz/info) takes no API key, account, or signature for any read in this pack.

Data sources

• https://api.hyperliquid.xyz/info — Hyperliquid’s public info endpoint. Every tool above sends a different type in the POST body (meta, spotMeta, allMids, metaAndAssetCtxs, l2Book, candleSnapshot, fundingHistory) — there is one URL, not one per resource.

Things the next caller would otherwise rediscover the hard way:

• No per-request rate-limit error observed in testing — Hyperliquid’s public docs describe IP-based weight limits on the info endpoint, but this pack does not special-case a 429; a caller hitting one gets Hyperliquid’s own error body verbatim (via httpError), not a Pipeworx-specific message.
• Perp vs spot coin IDs are DIFFERENT NAMESPACES, same coin argument shape. A perp is addressed by its bare symbol ("BTC", "ETH"). A spot pair is addressed by "@<index>" (e.g. "@0") EXCEPT the one canonical pair per token, which also has a human name ("PURR/USDC"). Get the right id from hyperliquid_spot_meta’s index field — guessing a spot pair’s @N id from its position elsewhere will be wrong, since indices are not contiguous by listing date.
• allMids keys are a flat mix of perp symbols and spot @N ids — there is no type field distinguishing them in the response; you have to already know which namespace a symbol belongs to (perp list from hyperliquid_perp_meta, spot list from hyperliquid_spot_meta).
• candleSnapshot returns [] (not an error) for a startTime/endTime window that contains no interval boundary — e.g. a 100ms window at 1h granularity. This is a legitimate empty answer, not a broken call; widen the window or use a coarser interval.
• Open interest is reported in BASE ASSET UNITS, not USD (e.g. a BTC figure like "37751.7" means 37,751.7 BTC of open interest, not dollars) — multiply by markPx for a USD figure if that’s what’s needed.
• metaAndAssetCtxs returns a two-element array, [meta, assetCtxs], where assetCtxs[i] corresponds to meta.universe[i] — there is no per-asset key; you must look up the coin’s index in universe first and use that same index into assetCtxs. This pack does that lookup for you in hyperliquid_asset_context.
• Historical open-interest is not published separately — only the CURRENT open interest is available (via metaAndAssetCtxs/ hyperliquid_asset_context); there is no openInterestHistory endpoint analogous to fundingHistory.

Tools

• hyperliquid_perp_meta — Hyperliquid’s full list of tradeable perpetual contracts and their leverage/precision limits, from Hyperliquid’s own API.
• hyperliquid_spot_meta — Hyperliquid’s full list of spot trading pairs and the tokens behind them, from Hyperliquid’s own API.
• hyperliquid_mids — Every current mid price on Hyperliquid (perps + spot) in one call, from Hyperliquid’s own API.
• hyperliquid_asset_context — A Hyperliquid perp’s live funding rate, open interest, mark/oracle price and 24h volume, from Hyperliquid’s own API.
• hyperliquid_l2_book — The live bid/ask order book for one Hyperliquid market, from Hyperliquid’s own API.
• hyperliquid_candles — OHLCV price candles for one Hyperliquid market, from Hyperliquid’s own API.
• hyperliquid_funding_history — A Hyperliquid perp’s funding-rate history over time, from Hyperliquid’s own API.