{"uid":"cap_czXV94ypK7acPuYDBO7IT","slug":"acoda-liquidation-intelligence-brief-962900be","name":"ACODA Liquidation Intelligence Brief","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/agent/brief","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,"market":"BTC-USDT-PERP","summary":"BTC-USDT-PERP mark 63514. Funding positive (longs pay). Last hour: 14 liquidations totaling $4.9M.","nearest_zone":{"side":"long","price_low":61800,"price_high":62400}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bAtk3uSlaI-jkBj_DF3xM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a real-time summary of liquidation events and position-level risk zones for a specified crypto perpetuals market","exampleAgentPrompt":"Give me ACODA's liquidation brief for BTC-USDT-PERP — I want to see the current mark price, funding direction, how many liquidations happened in the last hour and how big they were, and where the nearest liquidation zone sits.","exampleUseCases":[{"title":"Pre-trade liquidation risk check","prompt":"Before I open a long on BTC perps, can you pull the ACODA brief for BTC-USDT-PERP and tell me if there are heavy liquidation clusters below the current mark price that could push it down?"},{"title":"ETH funding and liquidation monitoring","prompt":"Check the ACODA liquidation brief for ETH-USDT-PERP and tell me whether longs or shorts are paying funding right now, and how much liquidation volume hit in the last hour."},{"title":"SOL liquidation zone alert","prompt":"What does ACODA say about the nearest liquidation zone for SOL-USDT-PERP right now — which side is it on and what price range are we talking about?"}],"resultDescription":"A JSON object containing: the queried market symbol, a human-readable summary string (mark price, funding direction, last-hour liquidation count and USD volume), and a nearest_zone object specifying side (long or short), price_low, and price_high of the closest concentrated liquidation cluster.","failureModes":["Invalid or unsupported market symbol — only BTC-USDT-PERP, ETH-USDT-PERP, SOL-USDT-PERP are accepted","Payment not received — x402 payment flow must complete before data is returned","Stale data if Hyperliquid feed is delayed or CEX liquidation sources are temporarily unavailable","Rate limiting or upstream data unavailability during extreme market volatility"],"whenToPreferThis":"Choose this endpoint when an AI trading agent needs a concise, actionable liquidation intelligence brief for major crypto perp markets without building its own data pipeline. It is ideal for pre-trade risk checks, real-time market regime assessment, or triggering alerts based on liquidation clusters. Prefer this over generic market data APIs when you specifically need liquidation zone mapping combined with funding rate context and recent liquidation volume in a single low-cost ($0.01/call) pay-per-call response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:42.348Z","isFirstParty":false}