# AgentFeed Liquidation History

> AgentFeed Liquidation History is a paid API for AI agents from x402.ochinimus.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-01).

Returns time-bucketed historical liquidation data (total, long, short USD, print count, biggest print) for any USDT perpetual or the full universe, up to 7 days back, sourced from Bybit's complete liquidation tape plus OKX and Binance.

## Facts

- Endpoint: GET https://x402.ochinimus.app/api/liq-history?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeed-liquidation-history-7eaeb843
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oI-RzPcWPn9ipfu5svJv2

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 agentfeed-liquidation-history-7eaeb843
```

Example prompt: Pull the last 48 hours of liquidation history for BTCUSDT in 60-minute buckets — I want to see long vs short USD split, total liquidations, and the biggest single print per bucket.

## When to prefer this

Use this endpoint when you need historical (up to 7 days) time-bucketed liquidation data for crypto perpetual futures — especially when you need Bybit's complete liquidation tape, which no exchange publishes publicly. Prefer this over live/real-time liquidation endpoints when doing retrospective analysis, forensic review of past cascades, or building time-series charts of liquidation activity. Use the scope='all' parameter when you need market-wide liquidation aggregates rather than a single symbol.

## Known failure modes

- Invalid symbol returns an error or empty data if the symbol is not a tracked USDT perp
- hours parameter outside 1-168 range may return an error or be clamped
- bucket_min outside 5-1440 range may be rejected or defaulted
- Payment failure via x402 protocol results in unpaid/no data response
- Very recent data may be incomplete if the liquidation tape hasn't been ingested yet

## How this service works

Liquidation history, time-bucketed: total, long and short USD, prints and biggest print per bucket, for any USDT perp or the whole recorded universe, up to 7 days back. Bybit is the only complete liq tape in crypto and no exchange publishes history of it.

## Output

Returns a JSON object containing an array of time buckets, each with a Unix millisecond timestamp, number of liquidation prints, total USD liquidated, USD of longs liquidated, USD of shorts liquidated, and the biggest single print in that window. Also includes summary totals (total_usd, longs_usd, shorts_usd), the scope (symbol or 'all'), bucket size in minutes, lookback in hours, and data source attribution.

## 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",
     "required": [],
     "properties": {
      "hours": {
       "type": "number",
       "description": "lookback 1-168, default 24"
      },
      "scope": {
       "enum": [
        "symbol",
        "all"
       ],
       "type": "string",
       "description": "all = whole universe"
      },
      "symbol": {
       "type": "string",
       "description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
      },
      "bucket_min": {
       "type": "number",
       "description": "bucket minutes 5-1440, default 60"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "hours": {
         "type": "number"
        },
        "scope": {
         "type": "string"
        },
        "source": {
         "type": "string"
        },
        "buckets": {
         "type": "array"
        },
        "longs_usd": {
         "type": "number"
        },
        "total_usd": {
         "type": "number"
        },
        "bucket_min": {
         "type": "number"
        },
        "shorts_usd": {
         "type": "number"
        }
       }
      },
      "paid": {
       "type": "boolean"
      },
      "tool": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "hours": 24,
   "scope": "SOLUSDT",
   "source": "agentfeed_liq_tape (bybit complete + okx + binance)",
   "buckets": [
    {
     "bucket": 1790265600000,
     "prints": 2,
     "longs_usd": 2317,
     "usd_total": 2317,
     "shorts_usd": 0,
     "biggest_print": 2231
    },
    {
     "bucket": 1790269200000,
     "prints": 18,
     "longs_usd": 50932,
     "usd_total": 50932,
     "shorts_usd": 0,
     "biggest_print": 33022
    },
    {
     "bucket": 1790272800000,
     "prints": 41,
     "longs_usd": 90426,
     "usd_total": 127842,
     "shorts_usd": 37416,
     "biggest_print": 48865
    }
   ],
   "longs_usd": 3920646,
   "total_usd": 16129695,
   "bucket_min": 60,
   "shorts_usd": 12209051
  },
  "paid": true,
  "tool": "get_liq_history"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-liquidation-history-7eaeb843/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ochinimus.app](https://www.zero.xyz/host/x402.ochinimus.app/llms.txt)