{"uid":"cap_IFFSPgE2eooOT4xXMxEWH","slug":"vextorium-hyperliquid-liquidation-map-79b9dd06","name":"Vextorium Hyperliquid Liquidation Map","description":"Liquidation map of the largest Hyperliquid accounts for a coin: at which prices their longs (below) and shorts (above) would be liquidated, bucketed with the notional at risk, and the closest levels to the current price.","url":"https://api.vextorium.com/hyperliquid-mapa-liquidaciones-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":[],"properties":{"moneda":{"type":"string"},"tramos":{"type":"integer","description":"5-60"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"nota":{"type":["string","null"]},"fuente":{"type":["string","null"]},"moneda":{"type":["string","null"]},"precio":{"type":["number","null"]},"tramos":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"desde":{"type":["null","number"]},"hasta":{"type":["null","number"]},"cortos_usd":{"type":["null","number"]},"largos_usd":{"type":["null","number"]},"posiciones":{"type":["null","number"]},"distancia_pct":{"type":["null","number"]}}}},"posiciones_con_liquidacion":{"type":["number","null"]},"nocional_cortos_en_riesgo_usd":{"type":["number","null"]},"nocional_largos_en_riesgo_usd":{"type":["number","null"]},"liquidaciones_cortos_mas_cercanas":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"cartera":{"type":["null","string"]},"liquidacion":{"type":["null","number"]},"nocional_usd":{"type":["null","number"]},"distancia_pct":{"type":["null","number"]}}}},"liquidaciones_largos_mas_cercanas":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"cartera":{"type":["null","string"]},"liquidacion":{"type":["null","number"]},"nocional_usd":{"type":["null","number"]},"distancia_pct":{"type":["null","number"]}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_22JO0ZexmLDjwO1DYUHw7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a bucketed liquidation map for a given coin on Hyperliquid, showing at which prices large accounts' longs and shorts would be liquidated and the notional at risk per price band.","exampleAgentPrompt":"Show me the Hyperliquid liquidation map for BTC with 20 price buckets — I want to see where the biggest long and short liquidation clusters are and which levels are closest to the current price.","exampleUseCases":[{"title":"Spot liquidation clusters before trading","prompt":"Before I enter a long on ETH, show me the Hyperliquid liquidation map for ETH using 10 buckets so I can see where the nearest short liquidations are above the current price."},{"title":"Monitor whale liquidation risk on SOL","prompt":"What does the Hyperliquid liquidation map look like for SOL right now? Use 30 buckets and tell me the total notional at risk for both longs and shorts and which wallets are closest to being liquidated."},{"title":"Gauge market risk before a volatile event","prompt":"Pull the Hyperliquid liquidation map for BTC with 15 price buckets — I want to know how much USD in long positions could get wiped out if price drops 5%."}],"resultDescription":"Returns the current price of the coin, an array of price buckets each containing the price range, number of positions, long notional at risk in USD, short notional at risk in USD, and distance from current price as a percentage. Also returns the closest individual long and short liquidation levels with wallet address, liquidation price, notional USD, and distance percentage, plus aggregate totals for long and short notional at risk and total number of positions at risk.","failureModes":["Unknown or unsupported coin ticker returns empty or null result","tramos value outside 5-60 range may cause validation error","Hyperliquid data source unavailable causes null or error response","No large positions found for a coin returns empty buckets","Network timeout on Hyperliquid data fetch"],"whenToPreferThis":"Use this endpoint when you need to understand where Hyperliquid perpetual positions are clustered for liquidation risk analysis on a specific coin — especially for identifying price levels where cascading liquidations could accelerate moves. Prefer this over generic order book or funding rate endpoints when the specific goal is liquidation mapping of large accounts on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:50:54.200Z","isFirstParty":false,"canonicalSlug":"vextorium-hyperliquid-liquidation-map-79b9dd06"}