# HALOWERK marktwerk Order Book

> HALOWERK marktwerk Order Book is a paid API for AI agents from markt.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Returns the live order book (bids and asks) for a BASE/QUOTE trading pair from Binance, Coinbase, Kraken, OKX, or Bybit, with depth statistics and optional price-band grouping

## Facts

- Endpoint: POST https://markt.halowerk.com/orderbook?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-marktwerk-order-book-7426f032
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CRD00EVYWdmtO2DK6TTFD

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 halowerk-marktwerk-order-book-7426f032 -d '<json body>'
```

Example prompt: Pull the current order book for ETH/USDT on Binance with 100 levels per side, grouped into 5 bps bands, and tell me how much liquidity sits within 1% of the mid price.

## When to prefer this

Choose this endpoint when you need live, per-exchange order book data for a specific crypto pair — especially when you want structured depth statistics (liquidity within X% of mid) or want to fold a raw book into price bands for easier consumption. Prefer it over a generic ticker when you need more than just best bid/ask, and over a consolidated quote endpoint when you want exchange-specific microstructure. It is ideal for pre-trade liquidity analysis, algorithmic strategy inputs, and market-making research.

## Known failure modes

- Invalid or unsupported trading pair symbol returns an error — the symbol must match BASE/QUOTE format and be listed on the chosen venue
- Exchange API outage or rate limit causes upstream failure and may return a 5xx or timeout
- group_bps value out of range (below 0.1 or above 500) is rejected
- levels value outside 10–1000 range is rejected
- Unsupported venue name returns a validation error
- Some pairs may not be available on all venues, returning a not-found or empty book error

## How this service works

Returns the visible order book of Binance, Coinbase, Kraken, OKX or Bybit for one BASE/QUOTE pair. Levels come as [price, size] with bids descending and asks ascending. depth[] states how much turnover sits within 0.5, 1 and 2 percent of the mid per side, in the quote currency, and additionally as depth_usd where the quote is a US dollar unit. group_bps folds levels into price bands whose price is the size weighted average of the band, for agents that do not want a thousand rows. The exchange up

## Output

Returns a structured order book with bid levels (descending) and ask levels (ascending) as [price, size] arrays, depth statistics showing quote-currency and USD turnover within 0.5%, 1%, and 2% of mid price per side, the venue's actual level cap used, and optionally grouped price bands using size-weighted average prices when group_bps is specified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "venue": {
   "enum": [
    "binance",
    "coinbase",
    "kraken",
    "okx",
    "bybit"
   ],
   "type": "string",
   "default": "binance",
   "description": "Exchange to read the book from."
  },
  "levels": {
   "type": "integer",
   "default": 100,
   "maximum": 1000,
   "minimum": 10,
   "description": "Number of levels per side. Exchanges cap this differently; venue_max_levels names the cap actually used."
  },
  "symbol": {
   "type": "string",
   "pattern": "^[A-Za-z0-9]{2,15}/[A-Za-z0-9]{2,15}$",
   "description": "Trading pair as BASE/QUOTE, for example ETH/USDC."
  },
  "group_bps": {
   "type": "number",
   "maximum": 500,
   "minimum": 0.1,
   "description": "Optional band width in basis points. Without it the book is returned ungrouped."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-marktwerk-order-book-7426f032/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from markt.halowerk.com](https://www.zero.xyz/host/markt.halowerk.com/llms.txt)
