{"uid":"cap_OXB83OxkgrN7oRT7xQOg3","slug":"kronos-liquidation-cluster-map-api-5ad404ec","name":"Kronos Liquidation Cluster Map API","description":"Paid market-intelligence API over x402","url":"https://kronossignals.com/api/v1/liquidations/%7Basset%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"as_of":"2026-07-02T10:00:00.000Z","asset":"BTC-USD","available":true,"disclaimer":"Cluster map is estimated from OI and leverage-band modeling — NOT a live order book. Not financial advice.","mark_price":107500,"cluster_map":{"disclaimer":"ESTIMATED clusters from OI + leverage-band modeling. NOT confirmed orders.","model_note":"OI distributed: 5x=35%, 10x=30%, 25x=25%, 50x=10%. Long/short split adjusted by funding rate.","squeeze_bias":"long_squeeze_risk","long_clusters":[{"leverage":50,"liq_price":106425,"distance_pct":-0.98,"estimated_oi_fraction":0.051},{"leverage":25,"liq_price":103375,"distance_pct":-3.84,"estimated_oi_fraction":0.1275}],"short_clusters":[{"leverage":50,"liq_price":108575,"distance_pct":1,"estimated_oi_fraction":0.049},{"leverage":25,"liq_price":111625,"distance_pct":3.84,"estimated_oi_fraction":0.1225}],"total_long_oi_estimate":44571,"total_short_oi_estimate":39749.15,"nearest_long_liq_cluster":{"liq_price":106425,"distance_pct":-0.98},"nearest_short_liq_cluster":{"liq_price":108575,"distance_pct":1}},"funding_rate":0.0001,"open_interest":84320.15,"recent_prints":{"note":"side:buy = short position liquidated (forced buy to close); side:sell = long position liquidated (forced sell to close).","count":5,"prints":[{"side":"buy","size":10.1,"time":"2026-07-02T09:45:00.000Z","price":107600.5,"pos_side":"short"}],"source":"okx-public","available":true}}},"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__1wlwGEXX9_t2dZ3HkVmu","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 estimated liquidation cluster map, open interest, funding rate, and recent liquidation prints for a specified crypto asset","exampleAgentPrompt":"Pull the current liquidation cluster map for BTC-USD — I want to see where the nearest long and short liquidation clusters are, the squeeze bias, open interest, and any recent liquidation prints.","exampleUseCases":[{"title":"Pre-trade liquidation risk check","prompt":"Before I enter a long position on BTC, can you check where the nearest long liquidation clusters are and whether there's a long squeeze risk right now?"},{"title":"Derivatives desk market briefing","prompt":"Give me a full liquidation cluster snapshot for BTC-USD — I need the OI breakdown by leverage band, the funding rate, squeeze bias, and the most recent liquidation prints for my morning briefing."},{"title":"Automated squeeze alert monitoring","prompt":"Monitor BTC-USD liquidation data and alert me if the squeeze bias flips to long_squeeze_risk and there's a large liquidation cluster within 1% of the current mark price."}],"resultDescription":"Returns a JSON object with: current mark price, funding rate, total open interest, a cluster_map with estimated long and short liquidation price levels grouped by leverage band (5x/10x/25x/50x) with distance percentages and OI fractions, a squeeze_bias indicator, nearest long and short liquidation cluster summaries, and recent liquidation prints (side, size, price, time) sourced from OKX public data. Includes disclaimers that cluster estimates are modeled from OI and leverage-band distributions, not a live order book.","failureModes":["Unsupported asset symbol returns an error or available:false response","Stale data if the underlying OKX feed or OI source is delayed","Model estimates may diverge significantly from actual liquidation orders since they are derived from OI distribution assumptions, not real order book data","Payment failure via x402 if USDC balance is insufficient or the x402 facilitator is unreachable","Rate limiting if many requests are made in quick succession without sufficient payment flow"],"whenToPreferThis":"Choose this endpoint when you need a structured, model-estimated view of where leveraged positions are likely to liquidate across multiple leverage bands for a specific crypto asset, along with real funding rate, OI, and recent liquidation print data. It is particularly useful for pre-trade risk analysis, squeeze detection, and derivatives market briefings. Prefer this over generic price feeds when the specific question involves leveraged position risk, cascade liquidation zones, or open interest distribution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:42.067Z","isFirstParty":false}