{"uid":"cap_5OAkA6d233whVteKA0jGG","slug":"vextorium-hyperliquid-liquidation-map-778c19ec","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/v1/hyperliquid-liquidation-map?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":{"brackets":{"type":"integer","description":"5-60"},"currency":{"type":"string"}}},"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":{"note":{"type":["string","null"]},"price":{"type":["number","null"]},"source":{"type":["string","null"]},"brackets":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"since":{"type":["null","number"]},"until":{"type":["null","number"]},"longs_usd":{"type":["null","number"]},"positions":{"type":["null","number"]},"shorts_usd":{"type":["null","number"]},"distance_pct":{"type":["null","number"]}}}},"currency":{"type":["string","null"]},"long_notional_at_risk_usd":{"type":["number","null"]},"nearest_long_liquidations":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"wallet":{"type":["null","string"]},"liquidation":{"type":["null","number"]},"distance_pct":{"type":["null","number"]},"notional_usd":{"type":["null","number"]}}}},"nearest_short_liquidations":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"wallet":{"type":["null","string"]},"liquidation":{"type":["null","number"]},"distance_pct":{"type":["null","number"]},"notional_usd":{"type":["null","number"]}}}},"positions_with_liquidation":{"type":["number","null"]},"short_notional_at_risk_usd":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"note":"Partial: only large accounts are visible; not the full market map.","price":84644.1,"source":"Hyperliquid (state of the 150 active accounts with the most capital)","brackets":[{"since":71947.485,"until":76179.69,"longs_usd":31496,"positions":1,"shorts_usd":0,"distance_pct":-12.5},{"since":84644.1,"until":88876.305,"longs_usd":0,"positions":1,"shorts_usd":39265958,"distance_pct":2.5}],"currency":"BTC","long_notional_at_risk_usd":139683299,"nearest_long_liquidations":[{"wallet":"0x9a1500b41519868039b1f95c447ba50b76d837e6","liquidation":73774.9858313574,"distance_pct":-12.84,"notional_usd":31496},{"wallet":"0xcfe2729438475c5eb9e8e6da6b314a0b9e2d8fb3","liquidation":41630.9464742785,"distance_pct":-50.82,"notional_usd":42322050}],"nearest_short_liquidations":[{"wallet":"0xec0b9ebf2a304c99cafe85c548c14dd7783cb078","liquidation":87288.8216754827,"distance_pct":3.12,"notional_usd":39265958},{"wallet":"0x218a65e21eddeece7a9df38c6bbdd89f692b7da2","liquidation":95125.3334571767,"distance_pct":12.38,"notional_usd":51338089}],"positions_with_liquidation":34,"short_notional_at_risk_usd":763297363}},"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_Ekz01Zahe8qn3xf0xyPwz","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 price-bracket liquidation map for a Hyperliquid perpetuals asset, showing where clustered long and short positions would be forcibly closed, along with the nearest individual liquidation levels and total notional at risk.","exampleAgentPrompt":"Pull the Hyperliquid liquidation map for BTC using 20 price brackets — I want to see where the long and short clusters are, which wallets are nearest to liquidation, and how much notional is at risk on each side.","exampleUseCases":[{"title":"Pre-trade liquidation risk assessment","prompt":"Before I open a big long on BTC perps, show me the Hyperliquid liquidation map for BTC with 10 brackets — I want to know how much short notional is sitting just above current price and where the nearest forced liquidations are."},{"title":"DeFi market structure monitoring","prompt":"Give me the ETH liquidation map on Hyperliquid with 15 brackets so I can see if there's a cascade risk building up on the long side right now."},{"title":"Whale liquidation proximity alert","prompt":"Check the Hyperliquid liquidation map for SOL with 20 brackets and tell me which individual wallets are closest to being liquidated and how much notional each one is carrying."}],"resultDescription":"Returns the current asset price, a list of price brackets each containing the count of positions, long USD notional, short USD notional, and distance from current price, plus arrays of the nearest individual long and short liquidations (wallet address, liquidation price, distance %, and notional USD), total long and short notional at risk across all brackets, total number of positions with a liquidation level, and a source note clarifying coverage is limited to the top 150 accounts by capital.","failureModes":["Unsupported currency symbol returns empty or error response","brackets value outside 5-60 range may be rejected or clamped","Data is partial — only the 150 largest accounts are visible, not the full market","Stale data if Hyperliquid state snapshot is delayed","Network timeout on POST if Hyperliquid upstream is slow"],"whenToPreferThis":"Use this endpoint when you need structured, bracket-based liquidation risk data specifically from Hyperliquid perpetuals markets, including both aggregate cluster data and individual wallet-level liquidation proximity. Prefer it over generic CEX order-book tools when working with on-chain Hyperliquid positions, or when you need to identify which specific large wallets are near forced liquidation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:43:32.350Z","isFirstParty":false,"canonicalSlug":"vextorium-hyperliquid-liquidation-map-79b9dd06"}