# Crypto Perpetual Market Order Book

> Crypto Perpetual Market Order Book is a paid API for AI agents from crypto.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Returns a real-time L2 order book snapshot for a crypto perpetual futures market, including aggregated bids/asks by price level, best bid/ask spread, spread percentage, and mid price.

## Facts

- Endpoint: POST https://crypto.openverbs.com/v1/orderbook?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-perpetual-market-order-book-d82142d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QGfM-PAxo6Xq7pa0IDxFR

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 crypto-perpetual-market-order-book-d82142d8 -d '<json body>'
```

Example prompt: Pull me the live order book for BTC perpetuals right now — give me the top 20 price levels on each side so I can see the spread and mid price.

## When to prefer this

Choose this endpoint when you need a real-time, granular L2 order book snapshot for a crypto perpetual futures market from on-chain DEX sources (Hyperliquid/dYdX), especially when you need per-level resting order counts, spread metrics, and mid price in a single call. Prefer over generic price feeds when market depth and liquidity structure matter, such as for pre-trade analysis, slippage estimation, or arbitrage detection.

## Known failure modes

- Unsupported coin symbol returns an error or empty book
- Depth value out of range (>100 or <1) returns a validation error
- Hyperliquid and dYdX both unavailable causes a service error
- Network timeout if upstream DEX data feed is slow
- Stale data if the upstream source has a temporary feed interruption

## How this service works

Live L2 order book for a crypto perp market: aggregated bids and asks with price, size and resting-order count per level, plus the best bid/ask spread, spread % and mid price. Real-time market-depth snapshot for a coin (BTC, ETH, SOL, and more); pass `depth` for how many price levels per side. Data source: Hyperliquid (dYdX fallback).

## Output

A JSON snapshot containing aggregated bid and ask levels (each with price, size, and resting order count), the best bid price, best ask price, raw spread, spread as a percentage, and mid price. Sourced from Hyperliquid with dYdX as a fallback.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "maxLength": 20,
   "minLength": 1,
   "description": "Coin symbol, e.g. \"BTC\", \"ETH\", \"SOL\"."
  },
  "depth": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "How many price levels per side (default 20; Hyperliquid serves up to 20, dYdX up to 100)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-perpetual-market-order-book-d82142d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto.openverbs.com](https://www.zero.xyz/host/crypto.openverbs.com/llms.txt)
