# HALOWERK Liquidation Price Calculator

> HALOWERK Liquidation Price Calculator is a paid API for AI agents from handel.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-17).

Computes the liquidation price for linear perpetual/futures positions in either isolated or cross margin mode by solving the equity-equals-maintenance equation.

## Facts

- Endpoint: POST https://handel.halowerk.com/v1/rechner/liquidation?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-liquidation-price-calculator-15b9f5be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u0R_MR51uGCNsP4-Z4i1q

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-liquidation-price-calculator-15b9f5be -d '<json body>'
```

Example prompt: Calculate the liquidation price for a long isolated-margin position: entry price 30000, leverage 10x, quantity 0.5, collateral cash 1500, maintenance rate 0.5%, and closing fee rate 0.04%.

## When to prefer this

Choose this endpoint when you need a fast, deterministic mathematical computation of a liquidation price for a linear (non-inverse) perpetual or futures position in isolated or cross margin mode, and you already have all the required parameters (entry, leverage, quantity, collateral, rates). It does not provide market data, broker connectivity, or investment advice — it is purely a calculation tool. Prefer it over generic calculators when you need programmatic, fee-aware liquidation math with cross-margin support via other_pnl and other_maintenance fields.

## Known failure modes

- Invalid or missing required fields (mode, entry, leverage, quantity, direction) return a validation error
- Out-of-range values (e.g. leverage or entry below minimum threshold) are rejected
- Negative collateral_cash is rejected (minimum is 0)
- Fee rates at or above 1.0 are rejected (maximum 0.99)
- Inverse contracts, tiered exchange fee schedules, and guaranteed liquidation prices are explicitly out of scope
- Result may not match actual broker liquidation price due to simplified model assumptions

## How this service works

Liquidationsreferenz für lineare Positionen. Löst Equity = Maintenance plus Schließgebühr. Cross hält andere PnL und Maintenance konstant. Keine inversen Kontrakte, Börsenstaffeln oder Garantie eines tatsächlichen Liquidationskurses. Alle Zahlen, Kurse und Vorgaben liefert der Aufrufer. Keine eigenen Kursdaten, kein Brokerzugriff, keine Ausführung. Rechenwerkzeug, keine Anlageberatung, keine Empfehlung.

## Output

Returns the computed liquidation price as a number — the price at which the account equity equals the maintenance margin plus closing fee, triggering liquidation. No market data, brokerage access, or trade execution is involved; this is a pure mathematical result based on the caller-supplied inputs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "isolated",
    "cross"
   ],
   "type": "string"
  },
  "entry": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 1e-12
  },
  "leverage": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 1e-12
  },
  "quantity": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 1e-12
  },
  "direction": {
   "enum": [
    -1,
    1
   ],
   "type": "integer"
  },
  "other_pnl": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": -1000000000000
  },
  "collateral_cash": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 0
  },
  "closing_fee_rate": {
   "type": "number",
   "maximum": 0.99,
   "minimum": 0
  },
  "maintenance_rate": {
   "type": "number",
   "maximum": 0.99,
   "minimum": 0
  },
  "other_maintenance": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-liquidation-price-calculator-15b9f5be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from handel.halowerk.com](https://www.zero.xyz/host/handel.halowerk.com/llms.txt)