Hyperliquid

liveMarkets

Hyperliquid MCP — read-only market data from Hyperliquid's public info API.

10tools
0msauth
free tier50 calls/day

Tools

hyperliquid_perp_meta

Hyperliquid's full list of tradeable perpetual contracts and their leverage/precision limits, from Hyperliquid's own API.

No parameters required.

▶Try it
hyperliquid_spot_meta

Hyperliquid's full list of spot trading pairs and the tokens behind them, from Hyperliquid's own API.

No parameters required.

▶Try it
hyperliquid_mids

Every current mid price on Hyperliquid (perps + spot) in one call, from Hyperliquid's own API.

No parameters required.

▶Try it
hyperliquid_asset_context

A Hyperliquid perp's live funding rate, open interest, mark/oracle price and 24h volume, from Hyperliquid's own API.

No parameters required.

▶Try it
hyperliquid_l2_book

The live bid/ask order book for one Hyperliquid market, from Hyperliquid's own API.

No parameters required.

▶Try it
hyperliquid_candles

OHLCV price candles for one Hyperliquid market, from Hyperliquid's own API.

No parameters required.

▶Try it
hyperliquid_funding_history

A Hyperliquid perp's funding-rate history over time, from Hyperliquid's own API.

No parameters required.

▶Try it
hyperliquid_account_state

Perpetuals account state for one Hyperliquid wallet address -- two separate flags (account_has_balance: non-zero account value, idle dust included; account_has_open_perp_positions: a position is open

No parameters required.

▶Try it
hyperliquid_spot_balances

Spot token balances for one Hyperliquid wallet address -- per token: total, amount on hold in open orders, available (total minus hold) and entry notional in USDC. Includes the spot USDC balance. Publ

No parameters required.

▶Try it
hyperliquid_account_history

Account value and PnL history for one Hyperliquid wallet address over a day, week, month or all time -- starting and ending account value, PnL change, trading volume, then a downsampled series. Scope

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/hyperliquid/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/hyperliquid/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"hyperliquid_perp_meta","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("hyperliquid_perp_meta", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("hyperliquid mcp — read-only market data from hyperliquid's public info api");