{"uid":"cap_R0HhdUgHRfNl_yf9tKER3","slug":"hyperliquid-whale-positioning-api-883b01b4","name":"Hyperliquid Whale Positioning API","description":"How the 150 largest actively trading Hyperliquid accounts are positioned: per coin long and short notional, bias, number of whales on each side, average entry and unrealized PnL; or, for one coin, every whale position with entry, liquidation and leverage.","url":"https://api.vextorium.com/v1/hyperliquid-whales?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":[],"properties":{"limit":{"type":"integer"},"currency":{"type":"string"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"note":{"type":["string","null"]},"coins":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"currency":{"type":["null","string"]},"avg_input":{"type":["null","number"]},"long_whales":{"type":["null","number"]},"short_whales":{"type":["null","number"]},"long_bias_pct":{"type":["null","number"]},"long_notional_usd":{"type":["null","number"]},"short_notional_usd":{"type":["null","number"]},"unrealized_pnl_usd":{"type":["null","number"]}}}},"source":{"type":["string","null"]},"analyzed_positions":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"note":"Only the 150 active accounts with the most capital. Not a recommendation.","coins":[{"currency":"ETH","avg_input":2422.007686,"long_whales":24,"short_whales":22,"long_bias_pct":33.6,"long_notional_usd":473509354,"short_notional_usd":934586458,"unrealized_pnl_usd":-32752466},{"currency":"BTC","avg_input":78488.828893,"long_whales":18,"short_whales":26,"long_bias_pct":19.2,"long_notional_usd":180960071,"short_notional_usd":763297363,"unrealized_pnl_usd":-46719599}],"source":"Hyperliquid (public leaderboard and account state)","analyzed_positions":1310}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WWlFaFaGpFnPKdfJa3yja","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated positioning data for the 150 largest active Hyperliquid accounts, including per-coin long/short notional, whale counts, bias, average entry price, and unrealized PnL; or detailed per-whale breakdown for a single coin.","exampleAgentPrompt":"Show me how the top 150 Hyperliquid whales are positioned right now — I want to see which coins they're long or short on, the notional sizes, how many whales are on each side, and their unrealized PnL.","exampleUseCases":[{"title":"Cross-market whale sentiment dashboard","prompt":"Pull the current Hyperliquid whale positioning across all coins — I want to see the long vs short notional, the number of whales on each side, the bias percentage, and total unrealized PnL for each coin the top 150 accounts are trading."},{"title":"Single-coin whale deep dive before a trade","prompt":"Before I enter a position, show me every individual whale's position on ETH on Hyperliquid — their entry price, liquidation level, and leverage — so I can see where the big money is concentrated."},{"title":"Monitoring whale bias shift on BTC","prompt":"What's the current whale bias on Bitcoin on Hyperliquid? I want to know how many of the top 150 accounts are long vs short, the total notional on each side, and the average entry price so I can gauge sentiment."}],"resultDescription":"Returns a JSON object with a list of coins, each containing: long and short notional in USD, number of whales on each side, long bias percentage, average entry price, and aggregate unrealized PnL. If a specific currency is requested, returns individual whale-level positions including entry price, liquidation price, and leverage. Also includes source attribution and total analyzed position count.","failureModes":["Missing or invalid 'currency' field may return all coins rather than a specific one","Hyperliquid leaderboard data may be momentarily stale if the source hasn't updated","If limit exceeds available whale accounts, fewer results may be returned","Network or upstream Hyperliquid API unavailability may result in an error response","Malformed request body type (not json/form-data/text) returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need real-time positioning intelligence specifically from Hyperliquid's largest active accounts (top 150 by capital), especially for perpetual futures markets. It is the right choice when you want aggregated whale sentiment (long/short bias, notional, PnL) across all coins at once, or granular per-whale breakdown for a specific coin including entry, liquidation, and leverage. Prefer this over generic on-chain analytics when the focus is on Hyperliquid-native perpetuals trading activity and large-account behavior.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:52:52.202Z","isFirstParty":false,"canonicalSlug":"hyperliquid-whale-positioning-api-883b01b4"}