{"uid":"cap_kCilhhzaCGWhfS0Aj-UcK","slug":"swaphunt-liquidation-history-api-860ff819","name":"SwapHunt Liquidation History API","description":"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.","url":"https://x402.swaphunt.dev/v1/derivatives/liquidations/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","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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qq-Y1wCM6wGAYLqN5ifWo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Charting liquidation waves for BTC","prompt":"Show me BTC liquidation history in 4-hour buckets for the past 30 days — I want to see where the big liquidation waves hit and what the largest single order was."},{"title":"Backtesting ETH liquidation spikes","prompt":"Get me ETH liquidation data for the last 720 hours in daily buckets so I can backtest how liquidation cascades correlated with price moves."},{"title":"Monitoring SOL liquidation pressure","prompt":"Fetch the last 24 hours of SOL liquidation history in 1-hour intervals — I want to see if there's been any unusual liquidation pressure building up recently."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T12:40:40.743Z","isFirstParty":false,"canonicalSlug":"swaphunt-liquidation-history-api-860ff819"}