# SwapHunt Derivatives Liquidations

> SwapHunt Derivatives Liquidations is a paid API for AI agents from x402.swaphunt.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-20).

Returns real-time long and short liquidation events for BTC, ETH, SOL, XRP, or BNB from Binance and Bybit USDT perpetuals over the last 1–60 minutes, including counts, USD volume, bias, largest order, cascade flag, and individual events.

## Facts

- Endpoint: GET https://x402.swaphunt.dev/v1/derivatives/liquidations?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/swaphunt-derivatives-liquidations-37c23642
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o-TvuCLww6-89fWwUaKLH

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 swaphunt-derivatives-liquidations-37c23642
```

Example prompt: Can you pull the BTC liquidation data from Binance and Bybit perps for the last 15 minutes and tell me if there's a short squeeze or cascade happening?

## When to prefer this

Use this endpoint when you need real-time liquidation flow data from major centralized exchanges (Binance and Bybit) for the five largest perp markets. Prefer this over historical endpoints when monitoring live market stress, short squeezes, or cascade events as they happen. Best suited for intraday trading signals and reactive automation rather than backtesting.

## Known failure modes

- Invalid coin parameter — only BTC, ETH, SOL, XRP, BNB accepted
- Minutes out of range — must be 1–60
- No liquidation events in the window — returns empty event list with zero counts
- Exchange data feed delay — totals may undercount during high-volatility periods
- Payment failure — x402 micropayment not satisfied, returns 402 status

## How this service works

Long and short liquidations for BTC, ETH, SOL, XRP or BNB in the last 1-60 minutes from Binance and Bybit USDT perps: counts, USD volume, bias, largest order, cascade flag and the individual events. Use to see forced selling or a short squeeze as it happens. Totals are a floor.

## Output

Returns aggregated liquidation data including total long and short counts and USD volume, overall bias (long-heavy or short-heavy), the largest single liquidation order, a cascade flag indicating abnormal liquidation clustering, and a list of individual liquidation events — all sourced from Binance and Bybit USDT perpetual markets for the chosen coin over the specified lookback window. Totals are a floor (may undercount due to data latency).

## 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",
     "properties": {
      "coin": {
       "type": "string",
       "default": "BTC",
       "description": "BTC, ETH, SOL, XRP or BNB"
      },
      "minutes": {
       "type": "integer",
       "default": 5,
       "description": "Lookback in minutes, 1-60"
      }
     }
    }
   },
   "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/swaphunt-derivatives-liquidations-37c23642/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.swaphunt.dev](https://www.zero.xyz/host/x402.swaphunt.dev/llms.txt)
