{"uid":"cap_UIKPbm4VWWBEahm0pvioX","slug":"acoda-liquidation-heatmap-9cb3a588","name":"ACODA Liquidation Heatmap","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/heatmap","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":{"market":{"enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"],"type":"string","description":"Perp market (canonical BASE-QUOTE-PERP)"},"time_buckets":{"type":"string","description":"Time buckets (default 24)"},"window_hours":{"type":"string","description":"Lookback window in hours (default 24)"},"price_buckets":{"type":"string","description":"Price buckets (default 40)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"grid":[{"t_ms":1786500000000,"cells":[{"intensity":0.8,"price_low":62000,"price_high":62500}]}],"paid":true,"market":"BTC-USDT-PERP","mark_price":63490.11,"model_version":"liq-heatmap-v2.1"}},"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":"unknown","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_apZhEBgJ8AnnVBFBy7_O-","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 a time-price liquidation intensity heatmap for BTC, ETH, or SOL perpetual markets, combining CEX liquidation events with Hyperliquid position data","exampleAgentPrompt":"Pull the ACODA liquidation heatmap for BTC-USDT-PERP over the last 12 hours with 40 price buckets and 24 time buckets — I want to see where liquidation clusters are building up near the current mark price.","exampleUseCases":[{"title":"Pre-trade liquidation zone check","prompt":"Before I open a long on BTC perps, show me the ACODA liquidation heatmap for BTC-USDT-PERP over the last 24 hours so I can see if there are dense liquidation clusters below the current price that might cause a cascade."},{"title":"ETH volatility cluster monitoring","prompt":"I'm watching ETH for a breakout trade — can you pull the ACODA liquidation heatmap for ETH-USDT-PERP using a 6-hour lookback window with 20 time buckets, so I can spot where forced liquidations have been concentrating?"},{"title":"SOL liquidation pressure snapshot","prompt":"Give me a quick read on SOL-USDT-PERP liquidation intensity right now — use a 48-hour window and 40 price buckets so I can see if there's a wall of liquidations sitting above or below current price."}],"resultDescription":"A JSON object containing a 2D grid of time-price cells, each with an intensity score (0-1) and price range bounds (price_low, price_high). Also includes the queried market symbol, current mark price, and the model version used (e.g. liq-heatmap-v2.1). The grid enables agents to identify price levels and time periods with the highest liquidation density.","failureModes":["Unsupported market symbol returns validation error — only BTC-USDT-PERP, ETH-USDT-PERP, SOL-USDT-PERP are accepted","Payment not completed (402) — x402 micropayment of $0.05 USDC must succeed before data is returned","Invalid time_buckets or price_buckets parameter type causes schema rejection","Extremely short window_hours may return sparse grid with low-intensity cells","Hyperliquid data feed outage may result in stale or partial heatmap data"],"whenToPreferThis":"Choose ACODA's liquidation heatmap when an agent needs structured, bucketed liquidation intensity data for BTC, ETH, or SOL perps — especially when combining CEX-observed liquidation events with transparent on-chain position data from Hyperliquid. Prefer this over generic order book endpoints when the goal is identifying price-level liquidation cascade risk or building a quantitative view of forced selling pressure over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:35:45.104Z","isFirstParty":false}