{"uid":"cap_o-TvuCLww6-89fWwUaKLH","slug":"swaphunt-derivatives-liquidations-37c23642","name":"SwapHunt Derivatives Liquidations","description":"Long and short liquidations for BTC, ETH, SOL, XRP or BNB in the last 1-60 minutes from Binance and Bybit USDT perps: counts, USD volume, bias, largest order, cascade flag and the individual events. Use to see forced selling or a short squeeze as it happens. Totals are a floor.","url":"https://x402.swaphunt.dev/v1/derivatives/liquidations?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"},"minutes":{"type":"integer","default":5,"description":"Lookback in minutes, 1-60"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xjEdgXfaToaNlo9h-qJ0G","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time long and short liquidation events for BTC, ETH, SOL, XRP, or BNB from Binance and Bybit USDT perpetuals over the last 1–60 minutes, including counts, USD volume, bias, largest order, cascade flag, and individual events.","exampleAgentPrompt":"Can you pull the BTC liquidation data from Binance and Bybit perps for the last 15 minutes and tell me if there's a short squeeze or cascade happening?","exampleUseCases":[{"title":"Detecting a live short squeeze","prompt":"Is there a short squeeze happening on ETH right now? Check the last 10 minutes of liquidations on Binance and Bybit perps and tell me if short liquidations are dominating."},{"title":"Monitoring for liquidation cascade","prompt":"Check BTC perpetual liquidations over the last 30 minutes and let me know if the cascade flag is triggered or if there's an unusually large single order."},{"title":"Gauging forced selling pressure before a trade","prompt":"I'm thinking of longing SOL — can you check if there's been heavy long liquidation volume in the last 5 minutes that might signal continued downside pressure?"}],"resultDescription":"Returns aggregated liquidation data including total long and short counts and USD volume, overall bias (long-heavy or short-heavy), the largest single liquidation order, a cascade flag indicating abnormal liquidation clustering, and a list of individual liquidation events — all sourced from Binance and Bybit USDT perpetual markets for the chosen coin over the specified lookback window. Totals are a floor (may undercount due to data latency).","failureModes":["Invalid coin parameter — only BTC, ETH, SOL, XRP, BNB accepted","Minutes out of range — must be 1–60","No liquidation events in the window — returns empty event list with zero counts","Exchange data feed delay — totals may undercount during high-volatility periods","Payment failure — x402 micropayment not satisfied, returns 402 status"],"whenToPreferThis":"Use this endpoint when you need real-time liquidation flow data from major centralized exchanges (Binance and Bybit) for the five largest perp markets. Prefer this over historical endpoints when monitoring live market stress, short squeezes, or cascade events as they happen. Best suited for intraday trading signals and reactive automation rather than backtesting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T06:35:51.904Z","isFirstParty":false,"canonicalSlug":"swaphunt-derivatives-liquidations-37c23642"}