# SwapHunt Liquidation History API

> SwapHunt Liquidation History API is a paid API for AI agents from x402.swaphunt.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-11-13).

Returns historical crypto liquidation data in 1h, 4h, or 1d buckets for up to 30 days, including window totals and the largest single liquidation order, sourced from SwapHunt's proprietary Binance and Bybit data store.

## Facts

- Endpoint: GET https://x402.swaphunt.dev/v1/derivatives/liquidations/history?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/swaphunt-liquidation-history-api-860ff819
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kCilhhzaCGWhfS0Aj-UcK

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-liquidation-history-api-860ff819
```

Example prompt: Pull the BTC liquidation history from SwapHunt for the last 168 hours so I can chart the liquidation waves and see the biggest single liquidation order in that window.

## When to prefer this

Choose this endpoint when you need historical liquidation data that is not available from exchange free APIs — specifically Binance and Bybit combined liquidation history bucketed into 1h, 4h, or 1d intervals for backtesting or charting liquidation waves. It is especially valuable for analyzing liquidation cascades, identifying large single liquidation events, or building liquidation-aware trading strategies for BTC, ETH, SOL, XRP, or BNB.

## Known failure modes

- Unsupported coin symbol (only BTC, ETH, SOL, XRP, BNB accepted) returns an error
- Hours parameter out of range (must be 1-720) returns a validation error
- Payment failure or insufficient USDC balance results in 402 Payment Required
- Temporary data gaps if SwapHunt's Binance/Bybit ingestion pipeline lags
- Rate limiting if too many requests are made in quick succession

## How this service works

Liquidation history in 1h, 4h or 1d buckets for up to 30 days, with window totals and the largest single order, from SwapHunt's own stored record of Binance and Bybit liquidations (not available from the exchanges' free APIs). Use to chart liquidation waves or backtest them.

## Output

A time-series of liquidation data broken into 1h, 4h, or 1d buckets covering the requested lookback window. Each bucket includes the total liquidation volume for that period. The response also includes an overall window total and the single largest liquidation order recorded. Data is sourced from SwapHunt's proprietary store of Binance and Bybit liquidations, which is not available through the exchanges' free public APIs.

## 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"
      },
      "hours": {
       "type": "integer",
       "default": 24,
       "description": "Lookback in hours, 1-720"
      }
     }
    }
   },
   "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-liquidation-history-api-860ff819/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)
