# Hyperliquid Perpetuals Level 1 Order Book (x402)

> Hyperliquid Perpetuals Level 1 Order Book (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 top-of-book Level 1 order book (bids, asks, spread, mid price) for BTC, ETH, or SOL perpetual futures on Hyperliquid, paid per-call via x402 USDC on Base.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/v1/perpetuals/level1?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-perpetuals-level-1-order-book-x402-f5133795
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fi1BgfzNds4nLhxCJcV-T

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-perpetuals-level-1-order-book-x402-f5133795
```

Example prompt: Pull the current BTC perpetuals order book from Hyperliquid — I want the best bid, best ask, mid price, and spread in bps, showing 10 levels per side.

## When to prefer this

Choose this endpoint when your trading or onchain AI agent needs real-time, exchange-level perpetuals order book data from Hyperliquid specifically — including precise bid/ask levels and spread in bps — without needing to manage API keys. Prefer it over generic price feeds when you need depth beyond best-price, or when you are operating on Hyperliquid and need venue-native quotes. The pay-per-call x402 micropayment model makes it ideal for agents that call infrequently or want to avoid subscription overhead.

## Known failure modes

- Invalid or unsupported coin symbol returns an error (only BTC, ETH, SOL supported)
- Depth parameter outside 1–20 range rejected with validation error
- x402 payment failure (insufficient USDC balance, wrong chain, or wallet not configured) blocks the call
- Hyperliquid upstream API unavailability causes data fetch failure
- Stale or missing updated_at if upstream is slow to respond

## 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 with the coin symbol, venue (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), 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-perpetuals-level-1-order-book-x402-f5133795/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)