{"uid":"cap_w79vu5CcOI0ZVs3ce0-o6","slug":"4sec-liquidation-heatmap-api-06af4ce8","name":"4SEC Liquidation Heatmap API","description":"Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.","url":"https://api.foursec.xyz/liquidation/heatmap/%7Bsymbol%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"object","example":{"symbol":{"type":"string"},"cascade_risk":{"type":"string"},"current_price":{"type":"number"},"liquidation_clusters":{"type":"array"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j-gVw2I8QSF6kLC6mjyeS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time liquidation cluster data and cascade risk assessment for a given crypto trading symbol across multiple DEXes.","exampleAgentPrompt":"Show me the liquidation heatmap and cascade risk for BTC — I want to see where the major liquidation clusters are sitting right now.","exampleUseCases":[{"title":"Pre-trade liquidation zone check","prompt":"Before I open a long position on ETH, can you pull up the current liquidation heatmap so I can see where the big liquidation clusters are and whether there's a cascade risk near the current price?"},{"title":"Monitoring SOL for cascade risk","prompt":"Keep an eye on SOL's liquidation heatmap and let me know if the cascade risk level changes — I want to know if we're building up dangerous liquidation clusters."},{"title":"DeFi risk assessment for portfolio hedging","prompt":"I'm trying to hedge my BTC position — can you get me the liquidation cluster data across DEXes so I can see which price levels have the most concentrated liquidation risk?"}],"resultDescription":"Returns a JSON object containing the queried symbol, the current market price, a cascade_risk classification string (e.g. low/medium/high), and an array of liquidation_clusters representing price levels where leveraged positions are concentrated and at risk of being liquidated.","failureModes":["Invalid or unsupported symbol returns an error or empty response","Payment failure via x402/USDC results in 402 Payment Required","Symbol path parameter missing causes a 404 or 400 error","Network latency or DEX data feed delays may result in stale data","Rate limiting if too many requests are sent in quick succession"],"whenToPreferThis":"Choose this endpoint when you need real-time, multi-DEX aggregated liquidation heatmap data for a specific crypto asset, particularly when assessing cascade liquidation risk before entering or exiting a leveraged position. Prefer this over generic price feeds when liquidation cluster density and cascade risk are the primary concern. The pay-per-request x402 model makes it suitable for on-demand queries without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T09:25:21.056Z","isFirstParty":false}