# Hyperliquid Perp Market Data API [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/Br0ski777/hyperliquid-data-x402  
**GitHub Stars:** 0  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/hyperliquid-perp-market-data-api

## Description
Hyperliquid perp order book, prices, funding, OI, candles. x402 paid.

## Tools
Capabilities this server exposes over MCP:

- **hyperliquid_get_market_data** — L2 order book for a Hyperliquid perp pair
- **hyperliquid_get_all_markets** — All mid prices, funding rates, OI, volume for every Hyperliquid asset
- **hyperliquid_get_candles** — OHLCV candlestick data for a Hyperliquid perp pair
- **coin** — Coin symbol (e.g. BTC, ETH, SOL, ARB, DOGE)
- **interval** — Candle interval (1m, 5m, 15m, 1h, 4h, 1d)
- **limit** — Number of candles to return (default 100, max 5000)

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "hyperliquid-perp-market-data-api": {
    "url": "https://hyperliquid-data.api.klymax402.com/mcp"
  }
}
```

## Documentation

## What Hyperliquid Perp Market Data API MCP server does

The Hyperliquid Perp Market Data API MCP server gives MCP-compatible agents access to data from Hyperliquid perpetual markets. It belongs in the Finance & Fintech category and focuses on market data rather than order execution or account management.

A coin-specific market-data request returns L2 bids and asks, the current mid price, mark price, hourly funding rate, open interest in USD, and 24-hour volume. A separate market snapshot covers every listed Hyperliquid asset, including each market’s mid price, funding rate, open interest, volume, and day change. Candle requests provide OHLCV history for a selected perpetual pair.

## How it works

The Hyperliquid Perp Market Data API MCP server is available at a hosted MCP URL:

`https://hyperliquid-data.api.klymax402.com/mcp`

MCP clients call the exposed tools, while the service retrieves the requested Hyperliquid data. The available operations correspond to order-book data, an all-markets snapshot, and historical candles. The underlying HTTP API also provides GET and POST variants for each operation, with query parameters for GET and JSON bodies for POST.

Requests use x402 pay-per-call billing. Payment is made in USDC on Base L2, identified by network `eip155:8453`. The README identifies Coinbase CDP as the primary facilitator and PayAI as a fallback. x402-aware clients can handle the payment challenge and retry flow. The service states that no API key or signup is required.

## Setup and configuration

Add the hosted MCP endpoint to the client’s MCP configuration. The documented example uses the `hyperliquid-data` server name and the URL above. Claude Desktop and Cursor are listed as supported configuration targets; ElizaOS is also named in the setup documentation.

No environment variables or API credentials are documented as required. Your payment setup must support x402 payments in USDC on Base. The listed prices are $0.003 for order-book and all-markets requests, and $0.002 for candle requests.

## Tools and capabilities

The Hyperliquid Perp Market Data API MCP server exposes these tools:

- `hyperliquid_get_market_data`: accepts a required coin symbol such as BTC, ETH, SOL, ARB, or DOGE and returns L2 depth plus pricing and market metrics.
- `hyperliquid_get_all_markets`: takes no parameters and returns the listed markets, total market count, and an ISO timestamp.
- `hyperliquid_get_candles`: accepts a coin and optional interval and limit. Supported intervals are `1m`, `5m`, `15m`, `1h`, `4h`, and `1d`. The default is 100 candles and the maximum is 5,000.

The Hyperliquid Perp Market Data API MCP server can support spread and depth checks before a trade, funding-rate screening across markets, dashboard data collection, technical analysis, backtesting inputs, and historical charting. It does not document tools for placing trades.

## Limitations and notes

Data is limited to Hyperliquid perpetual market information described by the available tools. Candle intervals are restricted to the documented values, and candle requests cannot exceed 5,000 records. Each call incurs an x402 payment, so clients need access to USDC on Base and an x402-compatible payment flow. The documentation does not describe an API-key authentication option, local deployment procedure, or trading and account-management functionality.

_Full upstream README: https://allmcps.com/mcp/hyperliquid-perp-market-data-api/readme_