# Hyperliquid Perpetual Order Book

> Hyperliquid Perpetual Order Book is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-28).

Returns live bid/ask levels, spread, mid price, and depth for a Hyperliquid perpetual futures market

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/hyperliquid/orderbook?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Provider: agent-data-tools.revmesh2074.workers.dev
- Website: https://agent-data-tools.revmesh2074.workers.dev
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetual-order-82a60082
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-i4fPfuopaAfB_JT3SrFp

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 agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetual-order-82a60082
```

Example prompt: Pull the live order book for ETH perp on Hyperliquid — give me the top 15 levels on each side with prices, sizes, and spread in basis points so I can judge slippage before I trade.

## When to prefer this

Use this endpoint when you need real-time order book data specifically from Hyperliquid's perpetual futures markets — it is ideal for pre-trade slippage estimation, market-making quote placement, or arbitrage checks. Choose this over generic price feeds when you need depth, spread, and multi-level order book structure rather than just a last-traded price.

## Known failure modes

- Unknown coin symbol returns an error or empty book — verify the symbol is listed as a Hyperliquid perpetual
- Levels parameter out of range (less than 1 or more than 20) may be clamped or return an error
- Hyperliquid API downtime or rate-limiting causes upstream failures
- Network timeout from Cloudflare Worker if Hyperliquid's API is slow

## How this service works

Live order book of a Hyperliquid perpetual (BTC, ETH, SOL, HYPE…): the best bid and ask levels with price, size and order count, the mid price, the spread in USD and basis points, and the summed depth on each side. Up to 20 levels a side (default 10). Read from Hyperliquid's public API. Use to judge liquidity and slippage before a trade, or for market-making and arbitrage checks.

## Output

Returns a JSON object with: mid price, arrays of bid and ask level objects (each with price px, size sz, and order count n), best spread in USD and basis points, summed bid and ask depth in units and USD, the coin symbol, and a timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "description": "Coin symbol such as BTC, ETH, SOL or HYPE (default BTC)"
  },
  "levels": {
   "type": "integer",
   "description": "Levels per side, 1-20 (default 10)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mid": {
   "type": "number"
  },
  "asks": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "n": {
      "type": "number"
     },
     "px": {
      "type": "number"
     },
     "sz": {
      "type": "number"
     }
    }
   }
  },
  "bids": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "n": {
      "type": "number"
     },
     "px": {
      "type": "number"
     },
     "sz": {
      "type": "number"
     }
    }
   }
  },
  "coin": {
   "type": "string"
  },
  "time": {
   "type": "string"
  },
  "source": {
   "type": "string"
  },
  "spread": {
   "type": "number"
  },
  "askDepth": {
   "type": "number"
  },
  "bidDepth": {
   "type": "number"
  },
  "spreadBps": {
   "type": "number"
  },
  "askDepthUsd": {
   "type": "number"
  },
  "bidDepthUsd": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetual-order-82a60082/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)