{"uid":"cap_o1ujp9iH-oz6N3t5rWYQz","slug":"x402-tools-hyperliquid-liquidation-levels-b47603e3","name":"x402 tools – Hyperliquid Liquidation Levels","description":"Use before opening, sizing or hedging a Hyperliquid perp to see where leveraged positions get liquidated. Liquidation levels for one coin, bucketed by price, from the open positions of the most active accounts (measured, not modelled): volume within 5%/10% of the mark, biggest clusters, largest positions, open-interest coverage.","url":"https://x402-tools-production-2755.up.railway.app/tools/liquidations?utm_source=zero.xyz","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":["coin"],"properties":{"coin":{"type":"string","description":"Hyperliquid perp name, e.g. BTC, ETH, SOL, HYPE, kPEPE (case-insensitive). See /tools/liquidations/coverage"},"range_pct":{"type":"string","description":"Only levels within this % of the mark price, 1-50, default 20"},"bucket_pct":{"type":"string","description":"Price bucket width in %, 0.1-5, default 0.5"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OPjweR7eKnij4o9q_4CPf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns bucketed liquidation price levels for a Hyperliquid perpetual contract, derived from the open positions of the most active accounts, including volume near mark price and the largest clusters.","exampleAgentPrompt":"Before I open a long on BTC perps, can you pull the Hyperliquid liquidation levels for BTC within 15% of the mark price using 0.5% buckets, so I can see where the biggest clusters are?","exampleUseCases":[{"title":"Pre-trade liquidation risk check","prompt":"I'm about to open a leveraged long on ETH on Hyperliquid — can you show me the liquidation levels within 10% of the current mark price in 0.5% buckets so I know where the big liquidation clusters are?"},{"title":"Identifying liquidation walls for position sizing","prompt":"I want to size my SOL perp position on Hyperliquid — pull the liquidation levels within 20% of mark in 1% buckets and tell me where the biggest clusters of longs and shorts are concentrated."},{"title":"Hedging strategy around liquidation zones","prompt":"I have an open HYPE perp position I need to hedge. Can you check the Hyperliquid liquidation levels for HYPE within 5% of the mark price so I can see the nearest danger zones?"}],"resultDescription":"A structured response containing liquidation price levels bucketed by price range for the requested coin. Includes volume of positions within 5% and 10% of the mark price, the largest liquidation clusters by bucket, the biggest individual positions, and open-interest coverage statistics — all derived from measured data on the most active Hyperliquid accounts.","failureModes":["Invalid or unrecognized coin symbol returns an error — use /tools/liquidations/coverage to check supported coins","range_pct outside 1–50 or bucket_pct outside 0.1–5 may return a validation error","Payment failure (HTTP 402) if USDC balance is insufficient or x402 payment header is missing","Sparse data for low-liquidity coins may return few or empty buckets","Rate limiting or upstream Hyperliquid API unavailability may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need real, measured liquidation level data for Hyperliquid perpetuals before opening, sizing, or hedging a position. It is superior to modelled or estimated liquidation data because it is derived from actual open positions of the most active accounts. Prefer it over generic market-data endpoints when your specific need is to identify liquidation clusters, walls, or hotspots on Hyperliquid perps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:40:36.055Z","isFirstParty":false,"canonicalSlug":"x402-tools-hyperliquid-liquidation-levels-b47603e3"}