{"uid":"cap_Mz-i-cEVhRLxug_7vaYVB","slug":"crypto-liquidations-feed-b8746563","name":"Crypto Liquidations Feed","description":"Recent forced liquidations of a coin's USDT perpetual on OKX: time, side, price, size in coin and USD, with totals of longs vs shorts liquidated and the largest ones.","url":"https://bess-x402.onrender.com/v1/crypto/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","required":[],"properties":{"coin":{"type":"string","description":"Coin ticker, e.g. BTC"},"limit":{"type":"integer","description":"Liquidations to return (1-100)"}}}},"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_y3WDBR3U85KB4bi_aiQjI","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 recent forced liquidations for a coin's USDT perpetual contract on OKX, including time, side, price, size, and summaries of long vs short liquidations.","exampleAgentPrompt":"Show me the last 50 forced liquidations for BTC on OKX's USDT perpetual — I want to see which side (longs or shorts) is getting hit harder and what the biggest ones were.","exampleUseCases":[{"title":"Gauge market sentiment via liquidations","prompt":"Pull the recent liquidation data for ETH on OKX's USDT perp and tell me whether longs or shorts are getting squeezed more right now."},{"title":"Spot large individual liquidations","prompt":"Get me the last 20 BTC perp liquidations on OKX and highlight the biggest ones by USD size — I want to know if any whale positions just got wiped."},{"title":"Monitor SOL liquidation activity","prompt":"Fetch the latest forced liquidations for SOL on OKX's USDT perpetual and give me a summary of total longs versus shorts liquidated."}],"resultDescription":"A list of recent forced liquidation events for the specified coin's USDT perpetual on OKX, each with timestamp, side (long or short), liquidation price, size in coin and USD. Also includes aggregate totals of longs vs shorts liquidated and the largest individual liquidation events.","failureModes":["Invalid or unsupported coin ticker returns an error or empty result","Limit out of range (outside 1-100) may return a validation error","OKX data unavailable or delayed if upstream feed is down","No liquidations in the recent window returns an empty list","Network timeout from the hosted service on Render"],"whenToPreferThis":"Use this endpoint when you need recent forced liquidation data for a specific coin's USDT perpetual contract on OKX, especially when you want both individual liquidation events and aggregate long/short summaries. Prefer it over generic market data endpoints when your goal is to assess liquidation pressure, identify cascades, or gauge leveraged positioning stress in the derivatives market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:37:49.551Z","isFirstParty":false,"canonicalSlug":"crypto-liquidations-feed-b8746563"}