{"uid":"cap_6ub8nE55iMS_fZuvVLkqX","slug":"lone-star-oracle-liquidations-a471d242","name":"Lone Star Oracle Liquidations","description":"Full liquidation report — all assets, long/short breakdown, hot zones","url":"https://liq.lonestaroracle.xyz/liquidations","method":"GET","headers":{},"bodySchema":{"name":"LoneStarOracle — Liquidations","tags":["liquidations","perps","futures","cascade","crypto","trading","risk"],"type":"object","version":"1.0.0","category":"crypto","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":{}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"assets":[{"asset":"BTC","signal":"LONG_CASCADE","biggest":{"usd":4200000,"side":"long"},"long_usd":30000000}],"signal":"LONG_CASCADE","total_long_usd":45000000,"total_short_usd":8000000}}}},"description":"Perp liquidation data for BTC/ETH/SOL/AVAX/LINK/ARB. Signal-first: LONG_CASCADE/SHORT_CASCADE/BALANCED/EXTREME. Long vs short volume, biggest single events, hottest price zones. 5-min cache."},"responseSchema":{"type":"object","format":"json","example":{"assets":[{"asset":"BTC","signal":"LONG_CASCADE","biggest":{"usd":4200000,"side":"long"},"long_usd":30000000}],"signal":"LONG_CASCADE","total_long_usd":45000000,"total_short_usd":8000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HB6TpQ8Iy9b7OzOOAPOpi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns perpetual futures liquidation data across OKX for major assets (BTC/ETH/SOL/AVAX/LINK/ARB) with cascade signals, long/short volumes, biggest events, and hottest price zones","exampleAgentPrompt":"What's the current liquidation signal across OKX perps — is there a long cascade or short cascade happening right now for BTC, ETH, and SOL, and how much long versus short volume has been liquidated?","exampleUseCases":null,"resultDescription":"A JSON object with a top-level signal (e.g. LONG_CASCADE, SHORT_CASCADE, BALANCED, EXTREME), total long and short liquidation volumes in USD, and a per-asset array containing each asset's signal, biggest liquidation event (size in USD and side), and long liquidation volume.","failureModes":["Payment not provided or invalid x402 payment header — returns 402 Payment Required","OKX data feed unavailable — may return 503 or stale data","Unsupported asset requested — endpoint only covers BTC/ETH/SOL/AVAX/LINK/ARB","Network timeout if OKX API is slow — request may hang or timeout","Invalid request format — returns 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need a pre-aggregated, signal-first view of perpetual futures liquidations on OKX across the six major assets (BTC/ETH/SOL/AVAX/LINK/ARB). It is especially useful when you want a quick cascade signal (LONG_CASCADE/SHORT_CASCADE/BALANCED/EXTREME) rather than raw tick data, or when you need to pair liquidation signals with funding rates or open interest from the Lone Star Oracle suite.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:37:40.506Z","isFirstParty":false}