# Vextorium Hyperliquid Orderbook

> Vextorium Hyperliquid Orderbook is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Returns the current bid/ask orderbook for a given asset on Hyperliquid, including price levels, sizes, spread, and market depth in USD.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hyperliquid-orderbook?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hyperliquid-orderbook-33f4139b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WMujJk_2Hjst7jWLaGpXm

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 vextorium-hyperliquid-orderbook-33f4139b -d '<json body>'
```

Example prompt: What does the Hyperliquid order book look like for ETH right now? Show me the top 5 levels per side including prices, sizes, and the bid-ask spread.

## When to prefer this

Choose this endpoint when you need real-time Hyperliquid-specific orderbook data including depth, spread, and level-by-level order counts. It is ideal for pre-trade analysis, liquidity assessment, and market microstructure monitoring on the Hyperliquid perpetuals exchange. Prefer this over generic CEX order book APIs when the user explicitly wants Hyperliquid data or is trading on that platform.

## Known failure modes

- Unknown or unsupported asset symbol returns an error or null data
- Hyperliquid API downtime causes empty or failed response
- Invalid levels value outside 1-20 range may cause validation error
- Malformed request body missing required currency field returns 400-level error
- Stale data possible during periods of extreme market activity

## How this service works

Order book of a Hyperliquid perpetual: best bid/ask, spread in basis points, mid price, top levels and USD liquidity within ±0.5%, ±1% and ±2% of mid. Use it to estimate slippage before trading.

## Output

Returns a structured JSON object containing: arrays of bid and ask price levels each with price, size, and order count; the best bid (best_buy) and best ask (best_sell); average mid price; absolute spread and spread in basis points; USD market depth at 0.5%, 1%, and 2% from mid; the asset symbol; data source label; and a UTC timestamp of the snapshot.

## 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": {
     "required": [
      "currency"
     ],
     "properties": {
      "levels": {
       "type": "integer",
       "description": "Levels per side (1-20, default 10)"
      },
      "currency": {
       "type": "string",
       "description": "Asset, e.g. BTC, ETH, SOL, HYPE"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "buys": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "size": {
          "type": [
           "null",
           "number"
          ]
         },
         "price": {
          "type": [
           "null",
           "number"
          ]
         },
         "orders": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "note": {
       "type": [
        "string",
        "null"
       ]
      },
      "asset": {
       "type": [
        "string",
        "null"
       ]
      },
      "sells": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "size": {
          "type": [
           "null",
           "number"
          ]
         },
         "price": {
          "type": [
           "null",
           "number"
          ]
         },
         "orders": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "moment": {
       "type": [
        "string",
        "null"
       ]
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "spread": {
       "ty
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "buys": [
   {
    "size": 10.6164,
    "price": 2721.2,
    "orders": 6
   },
   {
    "size": 1.2147,
    "price": 2721.1,
    "orders": 5
   }
  ],
  "note": "Approximate depth, from the Hyperliquid aggregated book (20 levels per side).",
  "asset": "ETH",
  "sells": [
   {
    "size": 9.8106,
    "price": 2721.3,
    "orders": 3
   },
   {
    "size": 19.6975,
    "price": 2721.4,
    "orders": 3
   }
  ],
  "moment": "2026-10-02T14:53:27+00:00",
  "source": "Hyperliquid (open data)",
  "spread": 0.1,
  "best_buy": 2721.2,
  "avg_price": 2721.25,
  "best_sell": 2721.3,
  "depth_usd": {
   "1%": {
    "buys": 59229054,
    "sells": 46808022
   },
   "2%": {
    "buys": 102648588,
    "sells": 86066756
   },
   "0.5%": {
    "buys": 46015761,
    "sells": 42536775
   }
  },
  "spread_bp": 0.367
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hyperliquid-orderbook-33f4139b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)