hyperliquid-market-data-orderbooks-prices-ohlcv

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

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

Tool Method Path Price Description
hyperliquid_get_market_data GET /api/orderbook $0.003 L2 order book for a Hyperliquid perp pair
hyperliquid_get_market_data POST /api/orderbook $0.003 L2 order book for a Hyperliquid perp pair (POST variant)
hyperliquid_get_all_markets GET /api/markets $0.003 All mid prices, funding rates, OI, volume for every Hyperliquid asset
hyperliquid_get_all_markets POST /api/markets $0.003 All mid prices, funding rates, OI, volume for every Hyperliquid asset (POST variant)
hyperliquid_get_candles GET /api/candles $0.002 OHLCV candlestick data for a Hyperliquid perp pair
hyperliquid_get_candles POST /api/candles $0.002 OHLCV 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

Name Type Required Description
coin string yes Coin 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

Name Type Required Description
coin string yes Coin 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

Name Type Required Description
coin string yes Coin symbol (e.g. BTC, ETH, SOL)
interval string no Candle interval (1m, 5m, 15m, 1h, 4h, 1d)
limit number no Number 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

Name Type Required Description
coin string yes Coin symbol (e.g. BTC, ETH, SOL)
interval string no Candle interval (1m, 5m, 15m, 1h, 4h, 1d)
limit number no Number 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

本页内容由上游仓库自动镜像，如有疑问请访问原始仓库。