# WickedAPI Liquidations Data API

> WickedAPI Liquidations Data API is a paid API for AI agents from api.wickedapi.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Returns recent forced liquidation events on OKX USDT perpetual swaps for a specified coin, including per-event details and aggregate long/short totals.

## Facts

- Endpoint: GET https://api.wickedapi.com/v1/liquidations?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wickedapi-liquidations-data-api-13a44d6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sVAdhJtPiUcJcweDOPlks

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 wickedapi-liquidations-data-api-13a44d6f
```

Example prompt: Pull the latest forced liquidation data for Bitcoin on OKX USDT perpetual swaps — I want to see each liquidation event with the side, size, and price, plus the overall long vs short totals and the single biggest liquidation.

## When to prefer this

Choose this endpoint when you need real exchange liquidation data from OKX USDT perpetual swaps specifically, rather than estimates or aggregated multi-exchange data. It is ideal for trading bots, sentiment dashboards, or risk monitors that need per-event granularity (time, side, price, size) alongside aggregate long/short totals and the peak liquidation event — all from a single low-cost call.

## Known failure modes

- Invalid or unsupported coin symbol returns an error or empty result
- OKX data feed downtime may cause stale or missing data
- Missing required coin parameter results in a 400-level error
- Payment failure (x402) if USDC balance is insufficient
- Rate limiting if called too frequently in a short window

## How this service works

Recent forced liquidations on OKX USDT perpetual swaps for a coin: each event with time, liquidated side, bankruptcy price, size and USD notional, plus long vs short liquidated totals and the largest event. Real exchange data, no estimates.

## Output

Returns a list of recent forced liquidation events on OKX USDT perpetual swaps for the specified coin, each containing timestamp, liquidated side (long or short), bankruptcy price, size, and USD notional value. Also includes aggregate totals of USD value liquidated on the long side and the short side, plus details on the single largest liquidation event in the dataset.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wickedapi-liquidations-data-api-13a44d6f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.wickedapi.com](https://www.zero.xyz/host/api.wickedapi.com/llms.txt)