{"uid":"cap_yBZODanbNUAkosCyohSXH","slug":"agentfeed-liquidation-cascade-history-42b80a94","name":"AgentFeed Liquidation Cascade History","description":"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.","url":"https://x402.ochinimus.app/api/cascade-history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lolWwHXyiG4P22QfN1QWz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Post-mortem on violent SOL selloff","prompt":"Can you pull the liquidation cascade history for SOLUSDT over the past 12 hours? I want to see every shorts-flushed and longs-flushed episode — give me start/end times, USD totals, and the peak print so I can understand what happened during the drop."},{"title":"Cross-market cascade scan after CPI print","prompt":"After the macro event this morning, I want to see all liquidation cascade events across every USDT perp in the last 6 hours with a minimum size of $250k — use scope=all so I can see which markets got hit hardest."},{"title":"Backtesting cascade thresholds for a trading bot","prompt":"Fetch the last 72 hours of liquidation cascade history for BTCUSDT with a gap tolerance of 30 seconds and a minimum event size of $500k — I'm trying to calibrate how often large cascades occur to set my entry triggers."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:51:58.606Z","isFirstParty":false,"canonicalSlug":"agentfeed-liquidation-cascade-history-42b80a94"}