{"uid":"cap_ZB0hRPYqfQQQhQkf9fn33","slug":"agentfeed-liquidation-heatmap-by-price-level-29c257a7","name":"AgentFeed Liquidation Heatmap by Price Level","description":"Liquidation heatmap by PRICE LEVEL: where leverage actually got flushed in the last N hours — USD, prints and long/short split per price zone, with the hottest zone flagged. Use when you need to answer: At which price levels did leverage actually get flushed? Built from real liquidation prints, not entry-price estimates.","url":"https://x402.ochinimus.app/api/liq-heatmap?utm_source=zero.xyz","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":{"hours":{"type":"number","description":"lookback 1-168, default 24"},"symbol":{"type":"string","description":"USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"},"buckets":{"type":"number","description":"price buckets 5-50, default 20"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"note":{"type":"string"},"hours":{"type":"number"},"levels":{"type":"array"},"symbol":{"type":"string"},"price_range":{"type":"array"},"hottest_zone":{"type":"object"}}},"paid":{"type":"boolean"},"tool":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"note":"historical flush zones from our tape — where leverage DIED, not an entry-price liq-level estimate","hours":24,"levels":[{"prints":14,"longs_usd":25212,"price_low":115.24,"usd_total":25212,"price_high":115.6175,"shorts_usd":0},{"prints":32,"longs_usd":214279,"price_low":115.6175,"usd_total":214279,"price_high":115.995,"shorts_usd":0},{"prints":68,"longs_usd":342110,"price_low":115.995,"usd_total":346785,"price_high":116.3725,"shorts_usd":4675}],"symbol":"SOLUSDT","price_range":[115.24,122.79],"hottest_zone":{"prints":143,"longs_usd":1239307,"price_low":118.6375,"usd_total":2268785,"price_high":119.015,"shorts_usd":1029478}},"paid":true,"tool":"get_liq_heatmap"}},"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_pWN-KIGqPfGvFglYT-J63","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a price-bucketed liquidation heatmap for a USDT perpetual, showing USD volume flushed and long/short split per zone over the last N hours, with the hottest zone flagged — built from real liquidation prints, not estimates.","exampleAgentPrompt":"Show me the liquidation heatmap for SOLUSDT over the last 48 hours using 25 price buckets — I want to see where leverage actually got flushed by price zone, with longs and shorts split out and the hottest zone highlighted.","exampleUseCases":[{"title":"Identify key liquidation support levels","prompt":"Pull the liquidation heatmap for BTCUSDT over the last 24 hours — I want to see which price zones had the most USD wiped out and whether it was mostly longs or shorts getting flushed, so I can spot where leverage clustered."},{"title":"Pre-trade zone analysis for entry timing","prompt":"Before I enter a ETHUSDT long, show me the liquidation heatmap for the last 72 hours with 30 buckets — I need to know which price levels have been the biggest flush zones and what the hottest zone was."},{"title":"Weekly liquidation concentration review","prompt":"Give me the SOLUSDT liquidation heatmap for the full past week (168 hours) broken into 20 price buckets — I want to see the total USD liquidated per zone and flag the zone where leverage died hardest."}],"resultDescription":"A JSON object containing an array of price-level buckets, each with price_low, price_high, usd_total, longs_usd, shorts_usd, and prints count. Also includes the symbol, lookback hours, overall price_range, and a hottest_zone object identifying the bucket with the highest liquidation volume. Data is built from real liquidation tape prints, not entry-price estimates.","failureModes":["Missing required 'symbol' query parameter returns an error","Symbol not found or not a valid Bybit USDT perp returns no data or error","Hours outside 1–168 range may be rejected or clamped","Buckets outside 5–50 range may be rejected or clamped","Payment failure (x402 protocol) results in unpaid response with no data","Low liquidity perps may return sparse or empty bucket arrays"],"whenToPreferThis":"Choose this endpoint when you need to understand WHERE by price level leverage was actually flushed — not estimated liquidation clusters based on open interest, but real historical liquidation prints aggregated into price buckets. It is ideal for identifying high-liquidation price zones, understanding long vs short pressure by price level, and pinpointing the single hottest flush zone. Prefer this over time-bucketed liquidation endpoints when the question is about price geography rather than time sequence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:51:45.990Z","isFirstParty":false,"canonicalSlug":"agentfeed-liquidation-heatmap-by-price-level-29c257a7"}