# Crypto Order Book Snapshot

> Crypto Order Book Snapshot is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-23).

Returns a spot order-book snapshot with best bid, best ask, mid-price, spread, and spread in basis points for a given trading pair, aggregated from Coinbase Exchange, Kraken, OKX, and Binance.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/crypto-orderbook?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-order-book-snapshot-fd31ea52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q9taiEptvaaCVOMkysFDz

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-order-book-snapshot-fd31ea52 -d '<json body>'
```

Example prompt: Can you pull a live order book snapshot for BTC-USD showing the top 5 bid and ask levels — I need the best bid, best ask, mid price, and spread in basis points?

## When to prefer this

Choose this endpoint when you need a fast, multi-exchange-aggregated order book snapshot for spot crypto markets with best bid/ask, mid, spread, and spread in bps all in one call. It is ideal when you do not have direct exchange API keys, want automatic exchange fallback across Coinbase, Kraken, OKX, and Binance, and need a normalized symbol format. Prefer alternatives if you need full historical order book data, streaming WebSocket updates, or derivatives/futures markets.

## Known failure modes

- Unsupported or unrecognized symbol returns an error — ensure symbol is a valid spot pair on at least one of the four supported exchanges
- Depth exceeding 100 is rejected with a validation error
- All four exchanges (Coinbase, Kraken, OKX, Binance) unavailable results in a 503 or error response
- Payment not provided or incorrect amount results in a 402 Payment Required response
- Malformed symbol format (too short, too long) rejected by schema validation

## How this service works

Call when an agent needs a spot order-book snapshot with best bid, best ask, mid, spread, and spread in bps. depth defaults to 20 and is at most 100. Tries Coinbase Exchange, Kraken, OKX, then Binance. Send JSON {"symbol":"BTC-USD","depth":2}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/crypto-orderbook first.

## Output

A JSON object containing the normalized symbol (BASE-QUOTE format), best bid price, best ask price, mid-price, spread (in price units), spread in basis points, and arrays of bid and ask levels up to the requested depth. The source exchange that provided the data is also indicated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "depth": {
   "type": "integer",
   "default": 20,
   "maximum": 100,
   "minimum": 1,
   "examples": [
    2
   ],
   "description": "Bid and ask levels to return. Example: 2. Default 20. At most 100."
  },
  "symbol": {
   "type": "string",
   "examples": [
    "BTC-USD"
   ],
   "maxLength": 24,
   "minLength": 5,
   "description": "Spot symbol. Example: BTC-USD or BTCUSDT. XBT is read as BTC. A slash is accepted. The response symbol is BASE-QUOTE."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-order-book-snapshot-fd31ea52/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)