{"uid":"cap_UW3JHRGpRjZz5_007Qqz_","slug":"acoda-liquidation-zones-1faa148f","name":"ACODA Liquidation Zones","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/zones","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)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"paid":true,"zones":[{"side":"long","intensity":0.9,"price_low":61800,"price_high":62400}],"market":"BTC-USDT-PERP","confidence":0.62,"model_version":"liq-zones-v1"}},"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_lUUWAiVP83sJpeccIifsP","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 model-scored liquidation price zones for a specified perpetual futures market, combining CEX liquidation events with Hyperliquid on-chain position data","exampleAgentPrompt":"What are the current liquidation zones for BTC-USDT-PERP right now — specifically where are the long positions most at risk of being wiped out, and how intense are those zones?","exampleUseCases":[{"title":"Pre-trade liquidation risk check","prompt":"Before I enter a long position on ETH, can you check the current liquidation zones for ETH-USDT-PERP and tell me if there are any high-intensity short-side clusters near my entry that could cause a cascade?"},{"title":"Automated stop-hunt avoidance","prompt":"I'm building a trading bot for SOL-USDT-PERP — pull the latest liquidation zones so I can avoid placing stop losses inside dense liquidation clusters that market makers might hunt."},{"title":"Market structure briefing for BTC","prompt":"Give me a liquidation zone breakdown for BTC-USDT-PERP right now — I want to know which price ranges have the heaviest long and short exposure so I can understand the likely path of least resistance."}],"resultDescription":"A JSON object containing an array of liquidation zones, each with a side (long or short), a price range (price_low and price_high), and an intensity score (0–1). The response also includes the market symbol, an overall confidence score for the model output, and the model version identifier (e.g. liq-zones-v1).","failureModes":["Unsupported market symbol returns a validation error — only BTC-USDT-PERP, ETH-USDT-PERP, and SOL-USDT-PERP are accepted","Missing or failed x402 payment returns a 402 Payment Required response before data is served","Low confidence score (e.g. 0.3) may indicate insufficient recent liquidation event data for reliable zone mapping","Stale on-chain data from Hyperliquid during network congestion may reduce zone accuracy without explicit error","Empty zones array returned if no significant liquidation clusters are detected in current market conditions"],"whenToPreferThis":"Choose this endpoint when an AI trading agent needs structured, scored liquidation zone data for BTC, ETH, or SOL perpetual markets and wants a pay-per-call model without subscription overhead. It is particularly valuable when combining CEX liquidation event signals with on-chain Hyperliquid position transparency — something raw order book feeds alone do not provide. Prefer this over generic open-interest endpoints when the agent needs intensity-ranked price zones rather than raw position sizes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:31:36.432Z","isFirstParty":false}