{"uid":"cap_-WKdlD7biu6B-96JFC6UC","slug":"whaletape-hyperliquid-whale-position-lookup-7c31887a","name":"WhaleTape Hyperliquid Whale Position Lookup","description":"Live whale positioning, OI/funding signals and AI market briefs from Hyperliquid. Pay per request (x402) or unlock the Pro dashboard for 60 minutes.","url":"https://whaletape.xyz/whale/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"note":"positions open right now, per dex; public on-chain Hyperliquid data","address":"0x0000000000000000000000000000000000000000","exposure":{"long":1500000,"short":0},"positions":[{"coin":"BTC","side":"long","entry_px":100000,"leverage":5,"notional":1500000,"unrealized_pnl":25000}],"open_positions":1,"dexes_consultados":3}},"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_6mDQOzaC_6YSIboVTr3oC","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 live on-chain position data for a specific Hyperliquid wallet address, including long/short exposure, leverage, entry price, notional size, and unrealized PnL.","exampleAgentPrompt":"Pull up the current Hyperliquid positions for whale address 0xAbCd1234... — I want to see their long/short exposure, which coins they're trading, leverage, and unrealized PnL right now.","exampleUseCases":[{"title":"Track a known whale's live exposure","prompt":"Check what positions address 0x7f3a9b2c... currently has open on Hyperliquid — I need their total long/short exposure, which coins, and how much unrealized PnL they're sitting on."},{"title":"Copy-trade signal from smart money wallet","prompt":"Before I enter a BTC position, look up what this Hyperliquid smart money address 0xDEAD5678... is currently holding — their entry price, leverage, and whether they're long or short."},{"title":"Risk check on a suspicious whale address","prompt":"I need to know the full open position breakdown for Hyperliquid address 0xC0FFEE99... — coins, notional size, leverage, and unrealized PnL — to assess whether they're over-leveraged."}],"resultDescription":"Returns a JSON object with the wallet address, aggregated long and short USD exposure, an array of individual open positions (each with coin, side, entry price, leverage, notional size, and unrealized PnL), total open position count, and number of DEXes consulted.","failureModes":["Invalid or malformed wallet address returns empty positions array or error","Address with no open Hyperliquid positions returns zero exposure and empty array","Rate limiting or payment failure (402) if USDC payment not attached","Hyperliquid on-chain data delay may cause slight staleness during high-throughput periods","Non-Hyperliquid addresses (e.g., Ethereum mainnet wallets with no Hyperliquid activity) return no data"],"whenToPreferThis":"Use this endpoint when you need real-time position data for a specific known wallet address on Hyperliquid. Prefer this over broader market signal endpoints when the goal is to track a particular trader or whale rather than scan across markets. It is the right choice for copy-trading logic, wallet monitoring, or due diligence on a specific address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:25.765Z","isFirstParty":false}