# Hyperliquid Perpetual Futures Market Data

> Hyperliquid Perpetual Futures Market Data is a paid API for AI agents from crypto.apitoll.cloud, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-13).

Returns real-time perpetual futures market data from Hyperliquid for 200+ crypto perp markets, including mark price, hourly funding rate, annualized funding APR, open interest, 24h volume, price change, and max leverage.

## Facts

- Endpoint: GET https://crypto.apitoll.cloud/v1/crypto/perps?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-perpetual-futures-market-data-3b1745e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wHXjHqxM06aMhA1qS3bty

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-perpetual-futures-market-data-3b1745e3
```

Example prompt: Pull the top 20 perp markets from Hyperliquid sorted by open interest — I want to see mark price, hourly funding rate, annualized funding APR, and 24h volume for each.

## When to prefer this

Use this endpoint when you need real-time perpetual futures market data specifically from Hyperliquid, including funding rates, open interest, and volume across 200+ perp markets. Prefer this over generic spot market data APIs when derivatives metrics like funding rate APR and max leverage are required. Ideal for trading agents, yield-hunting strategies, and market monitoring dashboards.

## Known failure modes

- Invalid coin symbol returns empty markets array or error
- Sort value outside enum (volume/oi/funding) returns 400 bad request
- Limit outside 1–100 range returns validation error
- Hyperliquid data source temporarily unavailable returns 503 or stale data
- Payment failure (insufficient USDC balance) returns 402 Payment Required

## How this service works

Perpetual-futures market data from Hyperliquid for any coin (BTC, ETH, SOL, HYPE…): mark price, hourly funding rate and its annualized APR, open interest in coin and USD, 24-hour notional volume, 24h price change, and max leverage, across 200+ perp markets. Sort by volume, open interest, or funding. Track the perp market the way trading agents do. Sourced from Hyperliquid.

## Output

A JSON object containing an array of up to 100 perp market entries, each with coin symbol, mark price, oracle price, hourly funding rate, annualized funding APR, open interest in coin units and USD, 24h notional volume in USD, 24h price change percentage, and max leverage. Also includes count, applied filters, and source attribution (Hyperliquid).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "sort": "oi",
   "limit": 20
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "coin": {
       "type": "string",
       "description": "Filter to one perp market by symbol (BTC, ETH, SOL…). Omit for the ranking."
      },
      "sort": {
       "enum": [
        "volume",
        "oi",
        "funding"
       ],
       "type": "string",
       "description": "Sort key (default volume)."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Max markets returned (1–100, default 20)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "source": {
       "type": "object",
       "properties": {
        "name": {
         "type": "string"
        }
       }
      },
      "filters": {
       "type": "object",
       "properties": {
        "coin": {
         "type": "string"
        },
        "sort": {
         "type": "string"
        }
       }
      },
      "markets": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "coin": {
          "type": "string"
         },
         "markPrice": {
          "type": "number"
         },
         "maxLeverage": {
          "type": "number"
         },
         "oraclePrice": {
          "type": "number"
         },
         "change24hPct": {
          "type": "number"
         },
         "openInterest": {
          "type": "number"
         },
         "volume24hUsd": {
          "type": "number"
         },
         "fundingAprPct": {
          "type": "number"
         },
         "priceQuotedPer": {
          "type": "number"
         },
         "openInterestUsd": {
          "type": "number"
         },
         "fundingRateHourly": {
          "type": "number"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "source": {
   "name": "Hyperliquid"
  },
  "filters": {
   "coin": "BTC",
   "sort": "volume"
  },
  "markets": [
   {
    "coin": "BTC",
    "markPrice": 66465,
    "maxLeverage": 50,
    "oraclePrice": 66460,
    "change24hPct": 1.2,
    "openInterest": 32915.94,
    "volume24hUsd": 2440195139,
    "fundingAprPct": 10.95,
    "priceQuotedPer": 1,
    "openInterestUsd": 2187000000,
    "fundingRateHourly": 0.0000125
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perpetual-futures-market-data-3b1745e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto.apitoll.cloud](https://www.zero.xyz/host/crypto.apitoll.cloud/llms.txt)