# Hyperliquid L2 Orderbook via x402

> Hyperliquid L2 Orderbook via x402 is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns the live L2 order book (bids, asks, spread, mid price) for BTC, ETH, or SOL perpetuals on Hyperliquid, paid per-call via x402 USDC micropayment.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/v1/hyperliquid/node/l2-orderbook?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-l2-orderbook-via-x402-7a9a479f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ouBwk4YsRZ1gYNDSHYJke

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-l2-orderbook-via-x402-7a9a479f
```

Example prompt: Pull the live Hyperliquid L2 order book for BTC perps with 10 levels on each side — I need the best bid, best ask, and spread in basis points.

## When to prefer this

Choose this endpoint when you need real-time L2 order book depth specifically from Hyperliquid for BTC, ETH, or SOL perpetuals, and you want pay-per-call micropayment access with no API key setup. Prefer it over CEX order book APIs when targeting Hyperliquid liquidity specifically, or over generic aggregators when you need venue-specific depth with spread in basis points already computed.

## Known failure modes

- Invalid coin symbol returns 400 (only BTC, ETH, SOL supported)
- Depth out of range (must be 1-20) returns 422 validation error
- Payment not received or x402 handshake fails returns 402 Payment Required
- Hyperliquid upstream API unavailable causes 503 or stale data
- Network timeout from Workers edge returns 504

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

Returns a JSON object containing the coin symbol, venue name ('hyperliquid'), best bid and ask prices, mid price, spread in basis points, arrays of bid and ask levels (each with price, size, and order count), data sources, and an updated_at timestamp.

## 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": {
       "enum": [
        "BTC",
        "ETH",
        "SOL"
       ],
       "type": "string",
       "examples": [
        "BTC",
        "ETH",
        "SOL"
       ],
       "description": "Perp coin (default BTC)"
      },
      "depth": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1,
       "description": "Levels per side (default 5)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mid": 80860.5,
  "asks": [
   {
    "n": 3,
    "px": 80861,
    "sz": 0.8
   }
  ],
  "bids": [
   {
    "n": 4,
    "px": 80860,
    "sz": 1.2
   }
  ],
  "coin": "BTC",
  "venue": "hyperliquid",
  "sources": [
   "https://api.hyperliquid.xyz/info"
  ],
  "best_ask": 80861,
  "best_bid": 80860,
  "spread_bps": 0.124,
  "updated_at": "2026-10-28T11:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-l2-orderbook-via-x402-7a9a479f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)