Liquidation — Recent Events

GET /liquidation/recent

Recent liquidation events from the OKX perpetual futures WebSocket stream.

Cost: $0.03 USDC

Query Parameters

Param	Type	Default	Description
limit	int	50	Number of events to return (max: 1000)
symbol	string	—	Filter by symbol (e.g. BTCUSDT)

Request Example

curl -H "x-payment: <proof>" \
  "https://api.foursec.xyz/liquidation/recent?limit=20&symbol=BTCUSDT"

Response

{
  "count": 20,
  "symbol_filter": "BTCUSDT",
  "events": [
    {
      "id": "liq_1720447800_001",
      "symbol": "BTCUSDT",
      "side": "long",
      "size": 0.25,
      "price": 57500,
      "value_usd": 14375,
      "timestamp": "2026-07-08T14:29:55Z",
      "exchange": "OKX"
    },
    {
      "id": "liq_1720447750_002",
      "symbol": "BTCUSDT",
      "side": "short",
      "size": 0.10,
      "price": 57850,
      "value_usd": 5785,
      "timestamp": "2026-07-08T14:29:50Z",
      "exchange": "OKX"
    }
  ],
  "stats": {
    "last_1h": {
      "total_events": 145,
      "long_liquidations": 98,
      "short_liquidations": 47,
      "total_value_usd": 2450000
    },
    "last_24h": {
      "total_events": 1820,
      "total_value_usd": 45000000
    }
  }
}

Data Source

OKX WebSocket public stream (wss://ws.okx.com:8443/ws/v5/public, channel liquidation-orders). Events buffered in-memory with 24-hour rolling window (max 1000 events). Cache TTL: 15 seconds.

Side Values

Value	Description
long	Long position was liquidated (price dropped)
short	Short position was liquidated (price rose)

Related Endpoints

• Liquidation Heatmap — cluster analysis
• Liquidation Alert — webhook notifications