{"uid":"cap_LFJwpz_r4TjCbM4KFJjck","slug":"crypto-liquidations-feed-389bb1e0","name":"Crypto Liquidations Feed","description":"OKX perpetual-swap liquidations for one underlying (e.g. BTC-USD): the most recent 100 filled forced liquidations, split into long and short liquidated USD value, with the largest events. Covers OKX only, and the window is the latest 100 events, not a fixed 24h total. Other exchanges' liquidation streams are not reported.","url":"https://api.chainmarket-api.workers.dev/api/crypto/crypto-liquidations-feed?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":{"uly":{"type":"string","description":"OKX underlying, e.g. BTC-USD, ETH-USD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"instId":"BTC-USD-SWAP","source":"https://www.okx.com/api/v5/public/liquidation-orders","largest":[{"side":"long","size":907.4,"time":"2026-10-22T16:47:27.205Z","instId":"BTC-USD-SWAP","priceUsd":81110.5,"usdValue":90740},{"side":"long","size":284.3,"time":"2026-10-22T13:40:58.423Z","instId":"BTC-USD-SWAP","priceUsd":81449.8,"usdValue":28430}],"checkedAt":"2026-10-23T09:35:57.139Z","eventCount":9,"underlying":"BTC-USD","longSharePct":100,"newestEventTime":"2026-10-22T16:50:11.171Z","oldestEventTime":"2026-10-22T13:40:58.423Z","longLiquidatedUsd":173070,"shortLiquidatedUsd":0,"totalLiquidatedUsd":173070}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uqQJSPonmB4xS3nD2mrm5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent perpetual swap liquidation events for a given crypto underlying (e.g. BTC-USD) from OKX, including total USD value liquidated, largest individual liquidations, and long/short breakdown.","exampleAgentPrompt":"Pull the latest liquidation data for BTC-USD perpetual swaps — I want to see total USD liquidated, whether longs or shorts are getting crushed, and the biggest individual liquidation events.","exampleUseCases":[{"title":"Detect long squeeze on Bitcoin","prompt":"Are there signs of a long squeeze on BTC right now? Show me the recent liquidation data for BTC-USD perps, especially how much has been liquidated on the long side."},{"title":"ETH liquidation monitoring for trading bot","prompt":"Check the latest ETH-USD perpetual swap liquidations — give me total USD liquidated, the long vs short breakdown, and any large individual liquidation events in the recent feed."},{"title":"Market stress analysis before a trade","prompt":"Before I open a position, can you pull the BTC-USD liquidation feed and tell me if there's been unusual liquidation activity or any giant single liquidations in the last few hours?"}],"resultDescription":"Returns a JSON object for the requested underlying (e.g. BTC-USD-SWAP) including: total USD liquidated, long and short liquidated amounts, long share percentage, event count, timestamps of newest and oldest events, a list of the largest individual liquidation events (side, size, price in USD, USD value, timestamp), the data source URL, and when the data was checked.","failureModes":["Invalid or unsupported 'uly' underlying symbol returns an error or empty result","OKX upstream API unavailability causes data fetch failure","No liquidation events in the recent window returns zero counts and empty largest array","Missing payment header results in HTTP 402 with no charge","Malformed query parameter may result in a 400 error"],"whenToPreferThis":"Choose this endpoint when you need near-real-time perpetual swap liquidation data sourced directly from OKX's public API, without needing an account or API key. It is ideal for agents monitoring crypto market stress, detecting squeezes, or analyzing forced selling pressure on specific assets. Prefer this over general market data endpoints when the specific need is liquidation events rather than price or volume data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:46:27.406Z","isFirstParty":false,"canonicalSlug":"crypto-liquidations-feed-389bb1e0"}