{"uid":"cap_oI-RzPcWPn9ipfu5svJv2","slug":"agentfeed-liquidation-history-7eaeb843","name":"AgentFeed Liquidation History","description":"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.","url":"https://x402.ochinimus.app/api/liq-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":{"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"}}}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7gPsvLEojz6PaGCdPnvXe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Detect peak liquidation windows for SOL","prompt":"Give me the hourly liquidation history for SOLUSDT over the last 24 hours — I want to see when the biggest liquidation spikes happened, the long vs short split, and the largest single print in each bucket."},{"title":"Cross-market liquidation review for risk management","prompt":"Pull the full liquidation history across all USDT perps you track for the past 7 days using 1440-minute daily buckets — I need to see total USD wiped, longs vs shorts, and the biggest single event per day to assess systemic risk."},{"title":"Post-event liquidation forensics on ETHUSDT","prompt":"Show me 5-minute bucketed liquidation data for ETHUSDT over the last 6 hours — I'm trying to pinpoint exactly when the cascade happened, how large the individual prints were, and whether longs or shorts got hit harder."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:47:19.879Z","isFirstParty":false,"canonicalSlug":"agentfeed-liquidation-history-7eaeb843"}