{"uid":"cap_X8cJ30jQ48ZHKhsohju8Q","slug":"whale-radar-hyperliquid-perps-whale-positioning-ddb2661b","name":"Whale Radar – Hyperliquid Perps Whale Positioning","description":"Whale Radar: live Hyperliquid perps positioning of the largest and highest-PnL public accounts for one coin (or ALL): whale net long/short, smart-money bias, top positions with liquidation prices, a liquidation-cluster map, funding/OI/premium crowding and squeeze risk. Not investment advice.","url":"https://seenly-whale-radar.vercel.app/api/whale-radar?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"top":{"type":"integer","default":8,"maximum":25,"minimum":1,"description":"How many of the largest tracked positions to list."},"coin":{"type":"string","pattern":"^[A-Za-z0-9]{1,20}$","description":"Hyperliquid perp ticker (BTC, ETH, SOL, HYPE, ...) or ALL for the market-wide whale board."},"requestKey":{"type":"string","maxLength":128,"description":"Optional idempotency key, echoed back."}}},"responseSchema":{"type":"json","example":{"coin":"BTC","as_of":"2026-10-06T14:29:15.849Z","market":{"mark_px":86106,"premium_pct":-0.0245,"funding_apr_pct":10.95,"open_interest_usd":3449282338},"whales":{"holders":13,"net_bias":"SHORT","smart_money":{"net_bias":"LONG"},"top_positions":[{"side":"SHORT","entry_px":76000.1,"notional_usd":241279474,"short_address":"0x5b5d…c060","liquidation_px":140084.2240591986}],"net_notional_usd":-362233109,"gross_notional_usd":792763109},"verdict":"BTC: balanced (funding 10.95% APR). 13 tracked whales hold $792.8M, net short $362.2M; smart money long. Squeeze risk: low.","crowding":{"label":"BALANCED","score":8,"squeeze_risk":"low","liquidation_magnet":"none"},"disclaimer":"Not investment advice. ...","liquidation_map":{"above":[{"sides":["SHORT"],"to_px":103327.2,"from_px":102466.14,"positions":1,"distance_pct":19,"notional_usd":25831800}],"below":[{"sides":["LONG"],"to_px":54246.78,"from_px":53385.72,"positions":1,"distance_pct":-37,"notional_usd":86106000}],"notional_within_5pct_below_usd":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gRlkTv9lj9pOoCszaA4YO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live whale positioning data for Hyperliquid perpetuals: net long/short bias, top positions with liquidation prices, liquidation cluster maps, funding/OI crowding, and squeeze risk for one coin or all markets.","exampleAgentPrompt":"Pull up the Whale Radar for BTC on Hyperliquid and show me the top 10 whale positions — I want to know if smart money is net long or short, where the liquidation clusters are, and whether there's squeeze risk right now.","exampleUseCases":[{"title":"Pre-trade whale sentiment check","prompt":"Before I enter a long on ETH perps, check the Whale Radar for ETH — are the biggest Hyperliquid accounts net long or short, and is there any squeeze risk I should know about? Show me the top 8 positions."},{"title":"Market-wide whale crowding overview","prompt":"Give me the full market-wide whale board on Hyperliquid — I want to see which coins have the most crowded whale positions, highest OI, and biggest liquidation cluster risks across ALL coins."},{"title":"Liquidation price hunting for SOL","prompt":"Show me the Whale Radar for SOL on Hyperliquid — I need the top 15 whale positions and their exact liquidation prices so I can see where the big clusters are sitting."}],"resultDescription":"Returns whale positioning data for the specified coin (or all markets): aggregate net long/short exposure of the largest and highest-PnL public accounts, smart-money directional bias, a ranked list of top positions with their sizes and liquidation prices, a liquidation cluster heatmap, funding rate, open interest, crowding metrics, and a squeeze risk assessment. Also echoes back any provided idempotency key.","failureModes":["Invalid coin ticker (pattern mismatch) returns 400 error","Coin not listed on Hyperliquid perps returns empty or error response","Rate limiting or payment failure returns 402/429","Hyperliquid data source downtime returns 503 or stale data","Top parameter exceeding 25 returns validation error"],"whenToPreferThis":"Use this endpoint when you need real-time, whale-specific positioning intelligence for Hyperliquid perpetuals — particularly when assessing smart-money bias, liquidation cascade risk, or crowding/squeeze setups. Prefer this over generic crypto market data APIs when the user specifically wants large-account on-chain positioning, liquidation cluster maps, or Hyperliquid-native perp analytics rather than price, OHLCV, or order book data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:01:45.160Z","isFirstParty":false,"canonicalSlug":"whale-radar-hyperliquid-perps-whale-positioning-ddb2661b"}