# OKX Crypto Perpetual Forced Liquidations

> OKX Crypto Perpetual Forced Liquidations is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.007/call, status unknown (last checked 2026-09-15).

Returns recent forced liquidation orders for any crypto perpetual futures symbol from OKX, split by long and short side, providing real-time liquidation cascade data.

## Facts

- Endpoint: GET https://api.x402node.dev/market/liquidations
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/okx-crypto-perpetual-forced-liquidations-1cba4fd5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__rtekkGPr-ZyYp9WA51iU

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 okx-crypto-perpetual-forced-liquidations-1cba4fd5
```

Example prompt: Pull the latest forced liquidation orders for the BTC perpetual on OKX and break them down by long and short side — I want to see if there's a liquidation cascade building.

## When to prefer this

Use this endpoint when you need real-time forced liquidation data for crypto perpetual futures, especially to detect liquidation cascades or gauge market stress. Prefer this over general market data endpoints when the user specifically wants to see who got liquidated long vs short and by how much.

## Known failure modes

- Invalid or unsupported symbol returns an error or empty result
- Symbol not traded as a perpetual on OKX returns no data
- Network timeout or upstream OKX API unavailability
- Payment of 0.007 USDC not fulfilled triggers 402 Payment Required
- Rate limiting if called too frequently

## How this service works

Recent forced liquidation orders for any crypto perpetual from OKX, split by long/short - real-time liquidation cascade data not available to LLMs. liquidations, liquidation data, forced liquidation, long short liquidations, liquidation cascade Accepts payment on Base or Solana — either network works.

## Output

Returns a list of recent forced liquidation orders for the specified crypto perpetual futures symbol, split into long liquidations and short liquidations, including order sizes, timestamps, and prices — data that reflects real-time liquidation cascades not accessible to LLMs by default.

## Example request

```json
{
 "limit": 10,
 "symbol": "BTC-USDT-SWAP"
}
```

## 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": {
      "coin": {
       "type": "string",
       "description": "Coin (optional)"
      },
      "symbol": {
       "type": "string",
       "description": "Crypto symbol, e.g. BTC (default), ETH, SOL"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/okx-crypto-perpetual-forced-liquidations-1cba4fd5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)