# AgentFeed Liquidation Cascade History

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

Returns historical liquidation cascade events (clustered same-side flush episodes) for USDT perpetual pairs, reconstructed from proprietary tape data, covering up to 72 hours back.

## Facts

- Endpoint: GET https://x402.ochinimus.app/api/cascade-history?utm_source=zero.xyz
- Price: $0.03/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-cascade-history-42b80a94
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yBZODanbNUAkosCyohSXH

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-cascade-history-42b80a94
```

Example prompt: Show me all liquidation cascade events that happened on SOLUSDT in the last 24 hours — I want to see the start and end times, how many prints each had, total USD flushed, and the peak print for each event.

## When to prefer this

Use this endpoint when you need historical context on past liquidation cascade episodes — as opposed to /api/cascade which reports what is happening right now. Prefer this when doing post-event analysis, backtesting liquidation patterns, comparing cascade magnitudes over time, or building dashboards that show recent flush history. It is the right choice over generic OHLCV or trade data APIs when you specifically need clustered same-side liquidation event boundaries with peak-print and USD-total metadata.

## Known failure modes

- Invalid symbol returns empty cascade array or error
- hours parameter out of 1-72 range may be rejected or clamped
- scope=all with min_usd below 250k may be rejected or auto-adjusted
- Payment failure returns 402 with no data
- Very short lookback windows may return zero cascades if none occurred
- Tape reconstruction gaps may result in incomplete event boundaries

## How this service works

Liquidation cascade history: past clustered same-side flush events reconstructed from our own tape, with start and end, prints, USD total and peak print, up to 72h back. /api/cascade tells you what is happening NOW; this tells you what already happened.

## Output

A JSON object containing an array of past cascade events, each with: symbol, side (longs_liquidated or shorts_liquidated), start and end timestamps in milliseconds, number of individual liquidation prints, total USD volume, peak single-print USD, and duration in seconds. Also returns the query parameters echoed back (hours, gap_s, min_usd, scope) and a cascade_count integer.

## 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": {
      "gap_s": {
       "type": "number",
       "description": "max gap seconds within an event, default 60"
      },
      "hours": {
       "type": "number",
       "description": "1-72, default 24"
      },
      "scope": {
       "enum": [
        "symbol",
        "all"
       ],
       "type": "string",
       "description": "symbol = just this symbol (default), all = every recorded USDT perp"
      },
      "symbol": {
       "type": "string",
       "description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
      },
      "min_usd": {
       "type": "number",
       "description": "min event USD, default 100k (250k for scope=all)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "gap_s": {
         "type": "number"
        },
        "hours": {
         "type": "number"
        },
        "scope": {
         "type": "string"
        },
        "source": {
         "type": "string"
        },
        "min_usd": {
         "type": "number"
        },
        "cascades": {
         "type": "array"
        },
        "cascade_count": {
         "type": "number"
        }
       }
      },
      "paid": {
       "type": "boolean"
      },
      "tool": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "gap_s": 60,
   "hours": 24,
   "scope": "SOLUSDT",
   "source": "agentfeed_liq_tape",
   "min_usd": 100000,
   "cascades": [
    {
     "side": "shorts_liquidated",
     "end_ts": 1790334518184,
     "prints": 371,
     "symbol": "SOLUSDT",
     "start_ts": 1790334274245,
     "usd_total": 6276081,
     "duration_s": 244,
     "peak_print": 915882
    },
    {
     "side": "longs_liquidated",
     "end_ts": 1790344043184,
     "prints": 41,
     "symbol": "SOLUSDT",
     "start_ts": 1790343996230,
     "usd_total": 907462,
     "duration_s": 47,
     "peak_print": 368536
    },
    {
     "side": "shorts_liquidated",
     "end_ts": 1790328727166,
     "prints": 106,
     "symbol": "SOLUSDT",
     "start_ts": 1790328390221,
     "usd_total": 744117,
     "duration_s": 337,
     "peak_print": 88856
    }
   ],
   "cascade_count": 25
  },
  "paid": true,
  "tool": "get_cascade_history"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-liquidation-cascade-history-42b80a94/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)