# HALOWERK marktwerk — Order Book Imbalance

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

Computes bid/ask imbalance metrics from a live order book for a given trading pair on a specified exchange, within a configurable price window around the mid price.

## Facts

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

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

Example prompt: What's the order book imbalance for ETH/USDC on Binance right now? Use 200 levels per side and a 1% depth window around the mid price.

## When to prefer this

Choose this endpoint when you need real-time order book imbalance specifically computed from live exchange data across major venues (Binance, Coinbase, Kraken, OKX, Bybit), with configurable depth and price window. Prefer it over generic market data APIs when you specifically need the bid/ask imbalance metric as a trading signal or for market microstructure analysis, especially in an x402 micropayment-enabled agent workflow where per-call billing is acceptable.

## Known failure modes

- Invalid or unsupported trading pair symbol (pattern mismatch) returns a validation error
- Exchange venue not available or experiencing downtime returns an error
- Depth levels outside the allowed range (50–1000) returns a validation error
- depth_pct outside allowed range (0.1–5.0) returns a validation error
- Payment not completed or USDC balance insufficient returns HTTP 402
- Network timeout if the upstream exchange API is slow

## How this service works

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

## Output

Returns computed order book imbalance metrics for the specified trading pair and venue, including the volume of bids and asks within the configured price window around the mid, and a quantified imbalance ratio or score indicating directional skew.

## 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": 200,
   "maximum": 1000,
   "minimum": 50,
   "description": "Levels per side to request. Exchanges cap this differently."
  },
  "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."
  },
  "depth_pct": {
   "type": "number",
   "default": 1,
   "maximum": 5,
   "minimum": 0.1,
   "description": "Half width of the window around the mid, in percent."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-marktwerk-order-book-imbalance-cfe172ae/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)