{"uid":"cap_wEWTc1-7slnGuTW5-LXMz","slug":"hyperliquid-btc-liquidation-levels-api-379fc669","name":"Hyperliquid BTC Liquidation Levels API","description":"Where BTC whale positions get liquidated and how far price must move to trigger it: levels with notional at risk, nearest first. Single-market slice of /liquidations, for agents that only track BTC","url":"https://whaletape.xyz/liquidations/BTC","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":null,"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_wONpRB3gGXCpAAruQQV4_","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 BTC whale liquidation price levels with notional at risk, sorted nearest to furthest, from Hyperliquid perpetuals data","exampleAgentPrompt":"Pull the current BTC liquidation levels from Hyperliquid whale data — I want to see which price levels have the most notional at risk and how close they are to spot.","exampleUseCases":[{"title":"Pre-trade liquidation cluster check","prompt":"Before I enter a BTC long, show me the nearest whale liquidation levels below current price on Hyperliquid — I want to know if there's a cascade zone I could get caught in."},{"title":"Squeeze zone identification for BTC","prompt":"Where are the BTC liquidation walls on Hyperliquid right now? I want to find the price level where a short squeeze is most likely to trigger based on notional at risk."},{"title":"Automated BTC risk monitoring alert","prompt":"Check the Hyperliquid BTC liquidation levels every 5 minutes and alert me when a cluster with more than $50M notional appears within 2% of current price."}],"resultDescription":"An ordered list of BTC liquidation price levels from Hyperliquid, each with the notional value at risk and the distance the price must move to trigger it, sorted nearest-first so agents can immediately identify the most proximate liquidation risk zones.","failureModes":["No active whale liquidation levels near current price — returns empty set","Hyperliquid data feed delay causes stale liquidation levels","Rate limit exceeded — 402 payment required if credits exhausted","Market temporarily unavailable or symbol not found","Network timeout if Hyperliquid upstream is slow"],"whenToPreferThis":"Use this endpoint when you specifically need BTC liquidation level data without fetching all 320+ markets. It is more efficient than the full /liquidations endpoint when your agent is only tracking BTC. Prefer this over generic order book or funding rate endpoints when your goal is to find cascading liquidation risk zones from whale positions specifically on Hyperliquid perpetuals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:43.170Z","isFirstParty":false}