# HALOWERK marktwerk Options Book Aggregator

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

Aggregates Deribit public options book data per expiry for BTC or ETH, providing ATM implied volatility, term structure, put/call ratios, open interest by strike, and max pain.

## Facts

- Endpoint: POST https://markt.halowerk.com/options?utm_source=zero.xyz
- Price: $0.008/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-options-book-aggregator-fec59f8a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V2JDLRCCTkJJlZhJ7g0sn

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-options-book-aggregator-fec59f8a -d '<json body>'
```

Example prompt: Pull the options market summary for BTC on Deribit for the nearest expiry — I want ATM implied vol, the term structure, put/call ratios by volume and open interest, and where max pain sits, with a moneyness range of 30%.

## When to prefer this

Choose this endpoint when you need a structured, aggregated view of Deribit's crypto options market for BTC or ETH — specifically ATM implied volatility, term structure, put/call sentiment, and strike-level open interest — rather than raw order book data or single-instrument Greeks. It is purpose-built for options market structure analysis and max pain computation on Deribit, not for generic options data from other exchanges.

## Known failure modes

- Invalid or unsupported underlying (not BTC or ETH) returns validation error
- Expiry date not found on Deribit returns empty or error response
- moneyness_range outside [0.1, 1.0] returns schema validation error
- Deribit API unavailable causes upstream timeout or failure
- No open interest data for specified expiry may result in sparse output

## How this service works

Reads the public option book summaries of Deribit and aggregates them per expiry. iv_atm is the mark implied volatility of the strike closest to the forward, averaged over call and put, and the strike used is named. term_structure lists iv_atm against days to expiry. put_call_ratio is reported twice and never mixed: once by 24h volume and once by open interest. open_interest_by_strike and key_strikes show where positions actually sit, above and below the forward. max_pain comes with the complete

## Output

Returns aggregated options book data for the requested underlying and expiry, including: ATM implied volatility (averaged over nearest-to-forward call and put), term structure (IV vs. days to expiry), put/call ratio by 24h volume, put/call ratio by open interest, open interest by strike, key strikes above and below the forward, and max pain with full supporting data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "expiry": {
   "type": "string",
   "default": "naechste",
   "description": "naechste for the nearest expiry, an exact date as YYYY-MM-DD, or alle for every open expiry."
  },
  "underlying": {
   "enum": [
    "BTC",
    "ETH",
    "btc",
    "eth"
   ],
   "type": "string",
   "description": "Underlying. Deribit lists crypto options for BTC and ETH."
  },
  "moneyness_range": {
   "type": "number",
   "default": 0.3,
   "maximum": 1,
   "minimum": 0.1,
   "description": "How far strikes may sit from the forward to be listed, as a fraction. 0.3 means plus or minus 30 percent."
  }
 }
}
```

## More

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