Back to Browse

Hyperliquid Data X402 MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: sse: https://hyperliquid-data.api.klymax402.com/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. Trust signals: trusted author (135/139 approved); 6 highly-trusted packages.

3 tools verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-br0ski777-hyperliquid-data": {
      "url": "https://hyperliquid-data.api.klymax402.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Hyperliquid Perp Market Data API

MCP Server x402 License: MIT

Hyperliquid perp market data -- order books, prices, funding rates, OI, volume, OHLCV candles in one API. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

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

Quickstart -- HTTP (x402)

curl "https://hyperliquid-data.api.klymax402.com/api/orderbook?coin=BTC"
# -> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
hyperliquid_get_market_dataGET/api/orderbook$0.003L2 order book for a Hyperliquid perp pair
hyperliquid_get_market_dataPOST/api/orderbook$0.003L2 order book for a Hyperliquid perp pair (POST variant)
hyperliquid_get_all_marketsGET/api/markets$0.003All mid prices, funding rates, OI, volume for every Hyperliquid asset
hyperliquid_get_all_marketsPOST/api/markets$0.003All mid prices, funding rates, OI, volume for every Hyperliquid asset (POST variant)
hyperliquid_get_candlesGET/api/candles$0.002OHLCV candlestick data for a Hyperliquid perp pair
hyperliquid_get_candlesPOST/api/candles$0.002OHLCV candlestick data for a Hyperliquid perp pair (POST variant)

hyperliquid_get_market_data

Use this when you need Hyperliquid perpetual futures data for a specific coin. Returns full L2 order book depth with real-time pricing and funding metrics in one call.

Parameters

NameTypeRequiredDescription
coinstringyesCoin symbol (e.g. BTC, ETH, SOL, ARB, DOGE)

Returns

  • bids -- array of bid levels with price and size
  • asks -- array of ask levels with price and size
  • midPrice -- current mid price between best bid/ask
  • markPrice -- oracle mark price used for liquidations
  • fundingRate -- current hourly funding rate (e.g. 0.0001 = 0.01%)
  • openInterest -- total open interest in USD
  • volume24h -- 24-hour trading volume in USD

Example response:

{"midPrice":67450.5,"markPrice":67448.2,"fundingRate":0.00008,"openInterest":1250000000,"volume24h":3400000000,"bids":[{"price":67450,"size":12.5}],"asks":[{"price":67451,"size":8.3}]}

When to use: placing trades on Hyperliquid. Essential for checking spread, depth, and funding before entering a position.

hyperliquid_get_market_data

Use this when you need Hyperliquid perpetual futures data for a specific coin. Returns full L2 order book depth with real-time pricing and funding metrics in one call. POST variant of hyperliquid_get_market_data -- same params passed as JSON body instead of query string.

Parameters

NameTypeRequiredDescription
coinstringyesCoin symbol (e.g. BTC, ETH, SOL, ARB, DOGE)

Returns

  • bids -- array of bid levels with price and size
  • asks -- array of ask levels with price and size
  • midPrice -- current mid price between best bid/ask
  • markPrice -- oracle mark price used for liquidations
  • fundingRate -- current hourly funding rate (e.g. 0.0001 = 0.01%)
  • openInterest -- total open interest in USD
  • volume24h -- 24-hour trading volume in USD

Example response:

{"midPrice":67450.5,"markPrice":67448.2,"fundingRate":0.00008,"openInterest":1250000000,"volume24h":3400000000,"bids":[{"price":67450,"size":12.5}],"asks":[{"price":67451,"size":8.3}]}

When to use: placing trades on Hyperliquid. Essential for checking spread, depth, and funding before entering a position.

hyperliquid_get_all_markets

Use this when you need a snapshot of all Hyperliquid perpetual markets at once. Returns pricing, funding, and volume data for every listed asset in a single call.

Parameters: none.

Returns

  • markets -- array of all listed perp assets
  • totalMarkets -- number of listed perp markets
  • timestamp -- data timestamp in ISO format

Example response:

{"markets":[{"coin":"BTC","midPrice":67450,"fundingRate":0.00008,"openInterest":1250000000,"volume24h":3400000000,"dayChange":2.3},{"coin":"ETH","midPrice":3520,"fundingRate":0.00012,"openInterest":890000000,"volume24h":1200000000,"dayChange":1.1}],"totalMarkets":148}

When to use: screening all Hyperliquid markets, finding highest funding rates, or building a market overview dashboard.

hyperliquid_get_all_markets

Use this when you need a snapshot of all Hyperliquid perpetual markets at once. Returns pricing, funding, and volume data for every listed asset in a single call. POST variant of hyperliquid_get_all_markets -- same params passed as JSON body instead of query string.

Parameters: none.

Returns

  • markets -- array of all listed perp assets
  • totalMarkets -- number of listed perp markets
  • timestamp -- data timestamp in ISO format

Example response:

{"markets":[{"coin":"BTC","midPrice":67450,"fundingRate":0.00008,"openInterest":1250000000,"volume24h":3400000000,"dayChange":2.3},{"coin":"ETH","midPrice":3520,"fundingRate":0.00012,"openInterest":890000000,"volume24h":1200000000,"dayChange":1.1}],"totalMarkets":148}

When to use: screening all Hyperliquid markets, finding highest funding rates, or building a market overview dashboard.

hyperliquid_get_candles

Use this when you need historical OHLCV candlestick data for a Hyperliquid perpetual pair. Returns open, high, low, close, volume for the specified interval.

Parameters

NameTypeRequiredDescription
coinstringyesCoin symbol (e.g. BTC, ETH, SOL)
intervalstringnoCandle interval (1m, 5m, 15m, 1h, 4h, 1d)
limitnumbernoNumber of candles to return (default 100, max 5000)

Returns

  • candles -- array of OHLCV bars
  • coin -- the coin symbol queried
  • interval -- the candle interval used
  • count -- number of candles returned

Example response:

{"coin":"BTC","interval":"1h","count":100,"candles":[{"timestamp":"2026-04-13T10:00:00Z","open":67200,"high":67550,"low":67100,"close":67450,"volume":45000000}]}

When to use: technical analysis, backtesting strategies, or charting price history on Hyperliquid perps.

hyperliquid_get_candles

Use this when you need historical OHLCV candlestick data for a Hyperliquid perpetual pair. Returns open, high, low, close, volume for the specified interval. POST variant of hyperliquid_get_candles -- same params passed as JSON body instead of query string.

Parameters

NameTypeRequiredDescription
coinstringyesCoin symbol (e.g. BTC, ETH, SOL)
intervalstringnoCandle interval (1m, 5m, 15m, 1h, 4h, 1d)
limitnumbernoNumber of candles to return (default 100, max 5000)

Returns

  • candles -- array of OHLCV bars
  • coin -- the coin symbol queried
  • interval -- the candle interval used
  • count -- number of candles returned

Example response:

{"coin":"BTC","interval":"1h","count":100,"candles":[{"timestamp":"2026-04-13T10:00:00Z","open":67200,"high":67550,"low":67100,"close":67450,"volume":45000000}]}

When to use: technical analysis, backtesting strategies, or charting price history on Hyperliquid perps.

Example agent prompts

  • "Hyperliquid perpetual futures data for a specific coin"
  • "Hyperliquid perpetual futures data for a specific coin"
  • "A snapshot of all Hyperliquid perpetual markets at once"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)
  • Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

Reviews

No reviews yet

Be the first to review this server!