{"uid":"cap_hKaz-W7rfF08lWgBCbJTF","slug":"hyperliquid-whale-positions-api-975bce7b","name":"Hyperliquid Whale Positions API","description":"The largest individual whale positions open right now: who, which side, how much notional and current PnL. The names behind the aggregate","url":"https://whaletape.xyz/whales/positions","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"positions":[{"dex":"native","roe":-0.9668634787,"coin":"ETH","name":null,"side":"short","size":-42974.8855,"address":"0x5b5d51203a0f9079f8aeb098a6523a13f298c060","entry_px":2033.48,"leverage":5,"notional":104287584.391705,"margin_used":20857516.878341,"max_leverage":15,"leverage_type":"cross","liquidation_px":3835.4670080535,"unrealized_pnl":-16898636.442468,"funding_all_time":-14675996.585308,"funding_since_open":-471866.583737}],"updated_at":"2026-08-23T01:39:43.769674+00:00"}},"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_oNWyVJVNqSxh66kJHE4Da","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the largest individual whale open positions on Hyperliquid right now, including trader identity, direction, notional size, and current PnL.","exampleAgentPrompt":"Pull up the biggest whale positions open on Hyperliquid right now — I want to see who's holding them, whether they're long or short, the notional size, and how much PnL they're sitting on.","exampleUseCases":[{"title":"Whale position dashboard for traders","prompt":"Show me the top whale positions open on Hyperliquid right now — who the traders are, which side they're on, how big the position is in notional terms, and their current PnL."},{"title":"Smart money bias before a trade","prompt":"Before I open my BTC position, can you check what the biggest whales on Hyperliquid are doing — are the large players net long or short, and how much are they up or down on those trades?"},{"title":"Identify influential on-chain players","prompt":"I want to find out which named or known traders currently have the largest open positions on Hyperliquid — give me their identities, what markets they're in, and their unrealized PnL."}],"resultDescription":"A ranked list of the largest individual open positions on Hyperliquid, each entry including the trader's wallet address or known name/label, the asset/market, position side (long or short), notional value, and current unrealized PnL.","failureModes":["Rate limiting or payment failure if x402 payment header is missing or invalid","Empty result set if no significant whale positions are detected at query time","Stale data if Hyperliquid data feed is temporarily delayed","HTTP 402 if USDC payment is not properly attached to the request","Service unavailability (5xx) during maintenance or upstream DEX issues"],"whenToPreferThis":"Choose this endpoint when you need a real-time ranked view of the largest individual whale positions on Hyperliquid specifically — not aggregate flow data, not leaderboard win-rate stats, but the actual named positions with notional and PnL. It is the right choice for smart money directional bias checks, for identifying dominant market participants before entering a trade, or for building whale-tracking dashboards grounded in live DEX data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:51:53.746Z","isFirstParty":false}