# Hyperliquid Perps Market Data

> Hyperliquid Perps Market Data is a paid API for AI agents from chain.tollkit.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-30).

Returns mark price, 24h change, hourly funding rate, open interest, volume, and max leverage for Hyperliquid perpetuals markets, plus optional funding rate history for a single coin.

## Facts

- Endpoint: POST https://chain.tollkit.dev/chain/perps?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-perps-market-data-d1a6e8e6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hOPiOt7VkEVqc2X1g-MHf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hyperliquid-perps-market-data-d1a6e8e6 -d '<json body>'
```

Example prompt: Show me the top 5 Hyperliquid perp markets sorted by open interest, and also pull the last 24 hours of hourly funding rate history for BTC.

## When to prefer this

Use this endpoint when you need real-time or recent market data specifically from Hyperliquid's perpetuals exchange, including funding rates, open interest, and volume rankings. Prefer this over generic crypto price APIs when the user is specifically interested in Hyperliquid perp mechanics like funding rates or leverage tiers.

## Known failure modes

- Invalid coin name returns no data or error for that symbol
- Requesting funding_hours with more than one coin in the coins array returns an error
- limit or funding_hours out of allowed range returns validation error
- Hyperliquid API downtime causes upstream fetch failure
- Empty result set if coin has no active perpetual market

## How this service works

Hyperliquid perpetuals market data: mark price, 24h change, hourly funding rate, open interest, volume and max leverage for any perp or the top markets, plus funding history for one coin.

## Output

Returns a list of perpetual market objects, each containing mark price, 24-hour percentage change, hourly funding rate, open interest, trading volume, and max leverage. If funding_hours is specified for a single coin, also includes an array of hourly historical funding rate data points.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "volume",
    "open_interest",
    "funding_high",
    "funding_low",
    "change_24h"
   ],
   "type": "string",
   "default": "volume"
  },
  "coins": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 20,
   "description": "Hyperliquid coin names, e.g. [\"BTC\", \"ETH\"]. Leave out for the top markets."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 20,
   "minimum": 1
  },
  "funding_hours": {
   "type": "integer",
   "maximum": 168,
   "minimum": 1,
   "description": "Hourly funding history for this many hours; needs exactly one coin."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "Hyperliquid info API (api.hyperliquid.xyz)",
  "markets": [
   {
    "coin": "BTC",
    "mid_price": 81696,
    "mark_price": 81692,
    "premium_pct": -0.0174,
    "max_leverage": 40,
    "oracle_price": 81711.2,
    "open_interest": 39978.25728,
    "change_24h_pct": -1.4,
    "prev_day_price": 82851,
    "volume_24h_usd": 1911332316,
    "open_interest_usd": 3265903794,
    "funding_hourly_pct": 0.00125,
    "funding_annualized_pct": 10.95
   },
   {
    "coin": "ETH",
    "mid_price": 2395.25,
    "mark_price": 2395.5,
    "premium_pct": -0.0584,
    "max_leverage": 25,
    "oracle_price": 2396.7,
    "open_interest": 1077867.046800002,
    "change_24h_pct": -1.57,
    "prev_day_price": 2433.6,
    "volume_24h_usd": 679086982,
    "open_interest_usd": 2582030511,
    "funding_hourly_pct": 0.000771,
    "funding_annualized_pct": 6.76
   },
   {
    "coin": "SOL",
    "mid_price": 104.515,
    "mark_price": 104.53,
    "premium_pct": -0.0574,
    "max_leverage": 20,
    "oracle_price": 104.58,
    "open_interest": 5481889.080000001,
    "change_24h_pct": -1.27,
    "prev_day_price": 105.87,
    "volume_24h_usd": 136218624,
    "open_interest_usd": 573021866,
    "funding_hourly_pct": 0.000851,
    "funding_annualized_pct": 7.46
   }
  ],
  "read_at": "2026-10-20T07:22:33.282Z",
  "not_found": [],
  "funding_note": "Hyperliquid pays funding every hour. funding_hourly_pct is the current hourly rate; when it is positive, longs pay shorts. funding_annualized_pct is that rate × 24 × 365, for comparison only."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perps-market-data-d1a6e8e6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.tollkit.dev](https://www.zero.xyz/host/chain.tollkit.dev/llms.txt)