# HALOWERK marktwerk Liquidations

> HALOWERK marktwerk Liquidations is a paid API for AI agents from markt.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Aggregates and analyzes OKX perpetual swap liquidation orders, converting them to USD by contract size and bankruptcy price, and detects cascade liquidation events.

## Facts

- Endpoint: POST https://markt.halowerk.com/liquidations
- Price: $0.004/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-liquidations-175e8fac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7w4a08xl6JX3Mv6HfqWw-

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-liquidations-175e8fac -d '<json body>'
```

Example prompt: Pull the last hour of BTC/USDT liquidation data from OKX perpetual swaps — I want to see the long vs short USD breakdown and whether any cascade events were detected.

## When to prefer this

Choose this endpoint when you need real-time or historical OKX perpetual swap liquidation data converted to USD, specifically when you need long/short split analysis, per-minute granularity, or automated cascade detection. It is the only public endpoint aggregating OKX liquidation orders with USD normalization and cascade logic built in.

## Known failure modes

- Invalid symbol format not matching BASE/QUOTE pattern returns validation error
- Unsupported venue (only OKX is supported) causes rejection
- OKX liquidation feed unavailable results in upstream data error
- Symbol not traded as OKX perpetual swap returns empty or error response
- Invalid window enum value outside 5m/1h/24h causes schema validation failure

## How this service works

Reads the liquidation orders OKX publishes for its perpetual swaps, converts every entry into US dollars with the contract size of that instrument and the bankruptcy price of that event, and sums them by the side of the liquidated position. timeline gives the per minute split of long and short. cascade_detected requires two conditions at once: liquidation volume above five times the median of all five minute buckets in the comparison span, and a price move of at least 0.3 percent in the same buc

## Output

Returns total liquidation volume in USD split by long and short sides for the requested window, a per-minute timeline of liquidation events, and a cascade_detected flag that fires when volume exceeds five times the median of five-minute buckets and price moved at least 0.3% in the same bucket.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string",
   "pattern": "^[A-Za-z0-9]{2,15}/[A-Za-z0-9]{2,15}$",
   "description": "Perpetual as BASE/QUOTE, for example BTC/USDT."
  },
  "venues": {
   "type": "array",
   "items": {
    "enum": [
     "okx"
    ],
    "type": "string"
   },
   "maxItems": 1,
   "minItems": 1,
   "description": "Venues with a public liquidation interface. Only OKX publishes one.",
   "uniqueItems": true
  },
  "window": {
   "enum": [
    "5m",
    "1h",
    "24h"
   ],
   "type": "string",
   "default": "1h",
   "description": "Window to sum over."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-marktwerk-liquidations-175e8fac/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)