# Hyperliquid Orderbook Snapshot

> Hyperliquid Orderbook Snapshot is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the current orderbook (bids and asks) for a specified Hyperliquid perpetual market

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/markets/orderbook
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-orderbook-snapshot-5d5b6953
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Obr1eM8g4jrevLuyqr4Wq

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-orderbook-snapshot-5d5b6953 -d '<json body>'
```

Example prompt: Pull the current orderbook for BTC-PERP on Hyperliquid — show me the top 10 bids and asks so I can see the spread and liquidity depth right now.

## When to prefer this

Choose this endpoint when you need real-time orderbook depth specifically from Hyperliquid's perpetual futures markets and want first-party data computed from the operator's own node fills ledger rather than a third-party aggregator. Ideal for pre-trade analysis, spread monitoring, liquidity assessment, or microstructure research on Hyperliquid perps. The pay-per-call x402 model ($0.001 USDC) makes it cost-efficient for spot queries without subscription overhead.

## Known failure modes

- Unknown or delisted market symbol returns a 404 or empty orderbook
- Malformed request body (missing required fields) returns a 400 validation error
- x402 payment failure or insufficient USDC balance returns a 402 Payment Required response
- Hyperliquid node connectivity issues may result in stale or unavailable data
- Rate limiting or node lag may cause delayed responses during high-volatility periods

## How this service works

First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).

## Output

A structured orderbook snapshot containing arrays of bid and ask price levels with corresponding sizes, representing the current state of the limit order book for the requested Hyperliquid perpetual market. Typically includes price, quantity, and cumulative depth at each level.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "description": "Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-orderbook-snapshot-5d5b6953/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid-data.v1337.org](https://www.zero.xyz/host/hyperliquid-data.v1337.org/llms.txt)