# Hyperliquid Order Book – Crypto Microdata (x402)

> Hyperliquid Order Book – Crypto Microdata (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-11-02).

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

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/hyperliquid/orderbook?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-order-book-crypto-microdata-x402-91e9901d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5WLQlcxz4mvzhZPze961W

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-order-book-crypto-microdata-x402-91e9901d
```

Example prompt: Pull the Hyperliquid perpetuals order book for ETH right now — show me the top 10 levels on each side so I can see the spread and depth before I size my trade.

## When to prefer this

Choose this endpoint when an AI trading agent needs a real-time Hyperliquid perpetuals order book snapshot without API key setup, paying only for calls made via USDC micropayment. It is ideal for agents that need live depth data for BTC, ETH, or SOL perps and want to avoid rate-limit tiers or subscription overhead. If you need order books from centralized exchanges (Binance, Coinbase) or spot markets, look elsewhere.

## Known failure modes

- Unsupported coin symbol returns validation error (only BTC/ETH/SOL accepted)
- depth out of range (must be 1–20) returns 400-level error
- x402 payment failure or insufficient USDC balance blocks the request
- Hyperliquid upstream API downtime causes stale or missing data
- Network timeout on the Cloudflare Worker edge node

## 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

A JSON object containing the coin symbol, venue name ('hyperliquid'), best bid price, best ask price, mid price, spread in basis points, arrays of bid and ask levels (each with price, size, and level count), the upstream data source URL, and an ISO-8601 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-order-book-crypto-microdata-x402-91e9901d/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)