# HALOWERK marktwerk Order Book

> HALOWERK marktwerk Order Book is a paid API for AI agents from markt.netzhandwerker.de, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Fetches a live order book (bids and asks) for a trading pair from a specified cryptocurrency exchange, with optional price-level grouping.

## Facts

- Endpoint: POST https://markt.netzhandwerker.de/orderbook
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-marktwerk-order-book-e205f605
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JHccBaZf1Pyqui3HaMKyv

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-e205f605 -d '<json body>'
```

Example prompt: Pull the order book for ETH/USDC on Coinbase — give me 100 levels per side, grouped in 5 bps bands.

## When to prefer this

Use this endpoint when you need real-time order book depth data from a specific centralized exchange (Binance, Coinbase, Kraken, OKX, or Bybit) without managing individual exchange API keys. Prefer it over direct exchange integrations when you want a unified interface across multiple venues, or when you need price-level grouping built in. Pay-per-call via x402/USDC makes it suitable for low-frequency queries where a subscription would be overkill.

## Known failure modes

- Unsupported trading pair for the selected venue returns an error
- Requested levels exceed the venue's maximum cap (capped automatically or returns error)
- Exchange API unavailability causes a timeout or upstream error
- Invalid symbol format (not matching BASE/QUOTE pattern) returns a validation error
- group_bps outside valid range (0.1–500) returns a validation error

## How this service works

HALOWERK marktwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.

## Output

Returns a structured order book for the requested trading pair and exchange, containing bid and ask price levels (up to the requested number of levels), optionally aggregated into price bands of the specified width in basis points. May include metadata such as the effective cap on levels used by the venue.

## 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-e205f605/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from markt.netzhandwerker.de](https://www.zero.xyz/host/markt.netzhandwerker.de/llms.txt)