{"uid":"cap_VsrQK6NT0GdSOFQeUQmUR","slug":"agentfeed-hyperliquid-whale-perp-positions-2077146b","name":"AgentFeed – Hyperliquid Whale Perp Positions","description":"Hyperliquid whales: the open perp positions of the largest Hyperliquid accounts aggregated per coin: net long or short USD, account counts, size-weighted entries, notional-weighted distance to liquidation, notional within 10% of liquidation and uPnL. Use when you need to answer: How are the biggest Hyperliquid traders positioned, and where are their liquidations? With coin=BTC: whale liquidation…","url":"https://x402.ochinimus.app/api/hl-whales?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"as_of":"2026-10-12T07:02:18.323Z","coins":[{"coin":"ETH","long":{"accounts":14,"avg_entry_px":2137.68,"notional_usd":249652710.4,"unrealized_pnl_usd":41986926.96,"avg_liq_distance_pct":42.87,"within_10pct_of_liq_usd":0},"short":{"accounts":16,"avg_entry_px":2407.92,"notional_usd":787635870.47,"unrealized_pnl_usd":-49641173.18,"avg_liq_distance_pct":74.32,"within_10pct_of_liq_usd":0},"mark_px":2569.9,"net_usd":-537983160.07}],"method":"Open perp positions of the largest Hyperliquid accounts, rea…","sources":["Hyperliquid info API (clearinghouseState, metaAndAssetCtxs)","Hyperliquid leaderboard (stats-data.hyperliquid.xyz)"],"whale_list":{"from":"largest accounts by account value on the Hyperliquid leaderb…","size":250,"of_rows":47389,"refreshed_at":"2026-10-12T07:02:10.359Z"},"accounts_scanned":250,"accounts_with_positions":66},"paid":true,"tool":"get_hl_whales"}},"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_wmbSb1KpijaMJj_OqHY0V","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 aggregated open perpetual futures positions of the top 250 Hyperliquid accounts by account value, including notional size, PnL, liquidation distance, and net exposure per coin.","exampleAgentPrompt":"What are the top Hyperliquid whales currently long and short on — pull their aggregated perp positions, notional sizes, unrealized PnL, and how close any of them are to liquidation right now.","exampleUseCases":[{"title":"Liquidation risk alert for whales","prompt":"Check how close the biggest Hyperliquid traders are to getting liquidated — I want to know which coins have large positions within 10% of their liquidation price and what the total notional is."},{"title":"Contrarian trade signal research","prompt":"Pull the current net long vs short exposure of the top 250 Hyperliquid whales across all coins — I'm looking for coins where whales are heavily one-sided so I can assess contrarian positioning."},{"title":"Whale PnL and sentiment snapshot","prompt":"Give me a snapshot of unrealized PnL for the largest Hyperliquid accounts right now — broken down by coin, long vs short, and how many accounts are on each side."}],"resultDescription":"A JSON object containing per-coin aggregated data for the top 250 Hyperliquid accounts: number of long and short accounts, average entry price, total notional USD, unrealized PnL, average liquidation distance percentage, amount of notional within 10% of liquidation, and the mark price. Also includes metadata about when the whale list was refreshed, total accounts scanned, and accounts with active positions.","failureModes":["Upstream Hyperliquid API unavailable — may return stale or error response","Payment not confirmed — returns 402 if USDC micropayment over x402 fails","Data freshness lag — whale list refreshes periodically so positions may be seconds to minutes old","Empty coin list if no whales hold open perps at query time"],"whenToPreferThis":"Use this endpoint when you need real-time aggregated positioning data specifically from Hyperliquid's top traders by account value, including liquidation proximity metrics. Prefer this over generic market data feeds when the goal is to understand large-player perp exposure, crowding risk, or liquidation cascade potential on Hyperliquid rather than just price or funding data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:37:15.593Z","isFirstParty":false,"canonicalSlug":"agentfeed-hyperliquid-whale-perp-positions-2077146b"}