{"uid":"cap_3JrAyOwf6tCIo0SlFiaUt","slug":"acoda-recent-liquidations-4250041d","name":"ACODA Recent Liquidations","description":"Measured liquidation intelligence combining observed CEX liquidation events with position-level data from Hyperliquid, the largest transparent perp venue. A pay-per-call JSON API for AI trading agents.","url":"https://acoda.xyz/v1/liquidations/recent","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":{"limit":{"type":"string","description":"Max events (default 100)"},"market":{"enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"],"type":"string","description":"Perp market (canonical BASE-QUOTE-PERP)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"paid":true,"market":"BTC-USDT-PERP","liquidations":[{"side":"SELL","price":63297.9,"exchange":"okx","notional_usd":33547.89,"event_time_ms":1786546838548,"quantity_base":0.53,"liquidated_position":"long"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UAsIo2xpHxK63CxzggVi-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent perpetual futures liquidation events from CEX exchanges and Hyperliquid, filtered by market, with price, notional size, side, and position direction.","exampleAgentPrompt":"Pull the last 50 BTC-USDT-PERP liquidation events from ACODA — I want to see which exchanges they hit, whether longs or shorts got wiped, and the notional sizes.","exampleUseCases":[{"title":"Real-time liquidation cascade detection","prompt":"Are there any large BTC liquidations happening right now? Grab the latest 100 BTC-USDT-PERP liquidation events and tell me if there's a cascade forming — lots of longs or shorts getting wiped in a short window."},{"title":"ETH perp trading signal generation","prompt":"Fetch the most recent ETH-USDT-PERP liquidations for me. I want to use the notional sizes and sides to decide whether to fade the move or go with it in my algo."},{"title":"SOL market stress monitoring","prompt":"Check ACODA for the last 100 SOL-USDT-PERP liquidation events — I want to know if there's unusual liquidation pressure building on either side before I add to my position."}],"resultDescription":"A JSON array of recent liquidation events, each containing: exchange name, market symbol, event timestamp in milliseconds, liquidated side (buy/sell), position direction (long/short), price at liquidation, quantity in base asset, and notional USD value. Results are scoped to the requested market and limited to the specified count.","failureModes":["Invalid or unsupported market symbol returns an error — only BTC-USDT-PERP, ETH-USDT-PERP, SOL-USDT-PERP are accepted","Missing payment header returns HTTP 402 Payment Required — caller must attach x402 USDC payment of $0.02","Limit parameter ignored or defaulted to 100 if not provided or out of range","Upstream CEX or Hyperliquid feed outage may return stale or empty liquidation arrays","Rate limiting or payment failure may result in 402 or 429 responses"],"whenToPreferThis":"Choose this endpoint when you need structured, per-event liquidation data with exchange attribution and position direction (long vs short) for BTC, ETH, or SOL perpetual futures. It is the right choice for trading agents that need real-time forced-liquidation signals, cascade detection, or market stress indicators. Prefer it over generic market data APIs when you specifically need liquidation events with notional sizing and Hyperliquid position-level context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:49.484Z","isFirstParty":false}