{"uid":"cap_2oYI2Mw5maMG2wBwJ4IMG","slug":"hyperliquid-liquidation-levels-api-3cd7d23a","name":"Hyperliquid Liquidation Levels API","description":"Where whale positions get liquidated and how far price must move to trigger it: levels per market with notional at risk, nearest first","url":"https://whaletape.xyz/liquidations","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"note":"liquidation levels of tracked whale positions, not executed liquidations; educational data","markets":[{"levels":[{"side":"short","notional":7818691,"positions":1,"distance_pct":114.96,"liquidation_px":97.16}],"symbol":"HYPE","mark_px":45.2,"nearest":{"side":"short","notional":7818691,"distance_pct":114.96,"liquidation_px":97.16},"notional_at_risk":150607773}],"updated_at":"2026-08-25T00:30:00Z"}},"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_BXRvXxkFeOjJLnH4_FU6I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-market liquidation price levels on Hyperliquid with notional at risk, sorted nearest to current price first","exampleAgentPrompt":"Pull the current liquidation levels across Hyperliquid markets and show me which ones have the largest notional at risk closest to the current price — I want to see where cascades are most likely to trigger.","exampleUseCases":[{"title":"Cascade risk scan before trading","prompt":"Before I open a long on ETH perps, show me the Hyperliquid liquidation levels near current price and how much notional is sitting there — I want to know if a drop could trigger a cascade."},{"title":"Identifying squeeze setup targets","prompt":"Which Hyperliquid markets have the biggest whale short liquidation clusters just above current price? I'm looking for potential short-squeeze setups."},{"title":"Real-time liquidation wall monitoring","prompt":"Give me a live snapshot of liquidation levels across all Hyperliquid perp markets, sorted by how close they are to being triggered, so I can see where the biggest price magnets are right now."}],"resultDescription":"A list of liquidation levels per Hyperliquid perpetual market, each entry showing the liquidation price, the notional amount at risk at that level, the direction (long or short), and the distance from current mark price — ordered from nearest to farthest so the most imminent liquidation risk appears first.","failureModes":["Hyperliquid data feed unavailable — returns error or stale data","Market not found if a specific symbol is queried that doesn't exist","Rate limiting or 402 payment required if x402 payment header is missing or insufficient","Empty result set during low-volatility periods with no notable liquidation clusters","Response latency spikes during high-volatility market conditions"],"whenToPreferThis":"Use this endpoint when you need structured, ranked liquidation level data for Hyperliquid perpetuals — specifically when you want notional-at-risk quantified per price level and sorted by proximity to mark price. Prefer this over generic order book endpoints when the goal is liquidation cascade analysis, squeeze detection, or risk mapping around whale positions on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:11.050Z","isFirstParty":false}