# Crypto Liquidations Feed

> Crypto Liquidations Feed is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Returns recent forced liquidations for a coin's USDT perpetual contract on OKX, including time, side, price, size, and summaries of long vs short liquidations.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/crypto/liquidations?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-liquidations-feed-b8746563
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mz-i-cEVhRLxug_7vaYVB

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 crypto-liquidations-feed-b8746563
```

Example prompt: Show me the last 50 forced liquidations for BTC on OKX's USDT perpetual — I want to see which side (longs or shorts) is getting hit harder and what the biggest ones were.

## When to prefer this

Use this endpoint when you need recent forced liquidation data for a specific coin's USDT perpetual contract on OKX, especially when you want both individual liquidation events and aggregate long/short summaries. Prefer it over generic market data endpoints when your goal is to assess liquidation pressure, identify cascades, or gauge leveraged positioning stress in the derivatives market.

## Known failure modes

- Invalid or unsupported coin ticker returns an error or empty result
- Limit out of range (outside 1-100) may return a validation error
- OKX data unavailable or delayed if upstream feed is down
- No liquidations in the recent window returns an empty list
- Network timeout from the hosted service on Render

## How this service works

Recent forced liquidations of a coin's USDT perpetual on OKX: time, side, price, size in coin and USD, with totals of longs vs shorts liquidated and the largest ones.

## Output

A list of recent forced liquidation events for the specified coin's USDT perpetual on OKX, each with timestamp, side (long or short), liquidation price, size in coin and USD. Also includes aggregate totals of longs vs shorts liquidated and the largest individual liquidation events.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "coin": {
       "type": "string",
       "description": "Coin ticker, e.g. BTC"
      },
      "limit": {
       "type": "integer",
       "description": "Liquidations to return (1-100)"
      }
     }
    }
   },
   "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/crypto-liquidations-feed-b8746563/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)