# HALOWERK marktwerk Liquidations

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

Returns aggregated perpetual futures liquidation volume for a given trading pair on OKX over a specified time window

## Facts

- Endpoint: POST https://markt.netzhandwerker.de/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-85d46ca8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JSLxH-wRAsNVMDeTHyHpx

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

Example prompt: What was the total liquidation volume for BTC/USDT on OKX over the last hour?

## When to prefer this

Use this endpoint when you need real-time or recent aggregated liquidation volume for a specific crypto perpetual pair on OKX. It is the right choice for assessing liquidation pressure, detecting leverage cascades, or building trading signals based on forced selling. Prefer this over generic market data endpoints when you specifically need liquidation (not just price or volume) data for OKX perpetuals.

## Known failure modes

- Invalid symbol format (not matching BASE/QUOTE pattern) returns a validation error
- Unsupported venue other than OKX returns an error since only OKX exposes a public liquidation feed
- Invalid window value outside of 5m/1h/24h enum returns a schema validation error
- Payment failure via x402 (insufficient USDC balance on Base Mainnet) results in a 402 response
- OKX upstream data unavailability may cause a timeout or empty response

## How this service works

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

## Output

Aggregated liquidation volume data for the specified perpetual futures pair (e.g. BTC/USDT) on OKX for the chosen time window (5m, 1h, or 24h), expressed as a numeric sum of liquidated value.

## 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-85d46ca8/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)