{"uid":"cap_ijLP3H-WS4UcucrJp9RBp","slug":"hyperliquid-wallet-portfolio-snapshot-api-b8b4acd7","name":"Hyperliquid Wallet Portfolio Snapshot API","description":"Everything one Hyperliquid wallet holds right now, across every dex: open positions, side, notional, leverage and long/short exposure. Point it at any address","url":"https://whaletape.xyz/whale/:address","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","properties":{}}},"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_BY6-JSh849geNAaR33jmM","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 all open DEX positions for a given Hyperliquid wallet address, including side, notional value, leverage, and long/short exposure across every market","exampleAgentPrompt":"Pull up all the open Hyperliquid positions for wallet 0x1234abcd...5678 — I want to see every market they're trading, which side they're on, their leverage, and total notional exposure.","exampleUseCases":[{"title":"Track a known whale's current book","prompt":"What positions does wallet 0xAbCd1234...EfGh currently have open on Hyperliquid? I want to see every market, whether they're long or short, the leverage they're using, and total notional for each."},{"title":"Mirror a profitable trader's portfolio","prompt":"I want to copy-trade a smart money wallet — can you look up all the open DEX positions for address 0x9999aaaa...bbbb on Hyperliquid so I can see exactly what they're holding right now and replicate their exposure?"},{"title":"Due diligence on a suspected insider wallet","prompt":"There's a wallet I've been watching — 0xDeadBeef...1337 — can you pull all their current Hyperliquid positions, including leverage and notional, so I can see if their positioning lines up with some suspicious on-chain activity I spotted?"}],"resultDescription":"A structured list of all open positions held by the queried wallet across every Hyperliquid DEX market, including the market name, position side (long/short), notional value in USD, leverage multiplier, and gross long/short exposure figures.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Wallet with no open positions returns an empty positions array","Address not found on Hyperliquid returns a 404 or empty response","Network or upstream Hyperliquid API unavailability causes a timeout or 503","Payment failure (x402) blocks the request if 0.1 USDC is not provided"],"whenToPreferThis":"Use this endpoint when you need a complete snapshot of a single wallet's current open positions across all Hyperliquid markets in one call. Prefer this over flow or leaderboard endpoints when the question is 'what does this specific address hold right now' rather than 'what is the market doing' or 'where is smart money flowing'.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:04.421Z","isFirstParty":false}