Reading the Whales: Tracking Large Positions on Hyperliquid With On-Chain Data
Hyperliquid's on-chain order book makes every whale position queryable — leverage, entry, liquidation price and all. A research-note on how to read that data, and where transparency quietly misleads.

On most exchanges, a whale is a rumor. You infer their presence from a violent wick, an aggregated long/short ratio, or a screenshot someone posts on X. On Hyperliquid, the whale is a queryable object. Because the exchange runs as a fully on-chain order book, every open position, entry price, liquidation level, and fill belongs to public state — readable from a single API endpoint, address by address. That changes the exercise from guessing sentiment to reading a ledger.
This note explains what "whale tracking" actually means on an on-chain venue, which data surfaces expose it, and — just as importantly — where the signal quietly breaks down. Position transparency is real, but it is not the same thing as knowing what a whale is doing, and treating the two as identical is how copy-traders get hurt.
• Every position is public. Hyperliquid's on-chain CLOB exposes any address's positions, leverage, entry, and liquidation price through the clearinghouseState info endpoint — no login, no paid tier.
• Whales are found, not given. Seed a watchlist from the public leaderboard and large fills, then poll a handful of addresses rather than scraping the whole chain.
• Transparency has blind spots. You see the Hyperliquid leg, not off-exchange hedges. A "$5M long" may be one side of a market-neutral book.
• Positioning is an input, not a signal. Liquidation clusters and crowded directional bets are risk maps to watch, not trades to copy blindly.
Why is whale tracking different on an on-chain exchange?
Two things make Hyperliquid unusual. First, it is not an EVM contract you parse with a block explorer the way you would track ERC-20 transfers on Etherscan. HyperCore runs its own on-chain central limit order book, secured by the HyperBFT consensus (a HotStuff-family proof-of-stake protocol) with one-block finality. The order book, matching, and margin engine are all protocol-level state.
Second, that state is exposed directly. On a centralized venue, individual account positions are a black box; you only ever see aggregate metrics the exchange chooses to publish. On Hyperliquid, the same data an ASXN- or CoinGlass-style dashboard shows is available to anyone who queries the public info API. If you understand how Hyperliquid works as an exchange, the tracking model follows naturally: the venue is the database.
The practical consequence is that "whale watching" here is a data-engineering problem, not an intelligence-gathering one. You are not trying to unmask a hidden actor. You are choosing which addresses to poll, how to interpret their margin state, and how much weight to give a position you can see but cannot fully contextualize.
Which data surfaces actually expose whale positioning?
Whale tracking on Hyperliquid rests on a small number of public endpoints. Each answers a different question, and the useful workflows combine them rather than relying on any single one.
Data surface | What it tells you | How you access it |
|---|---|---|
clearinghouseState | An address's live positions: size, entry price, leverage, unrealized PnL, and estimated liquidation price | POST to the info API with a user address |
userFills | An address's recent executions — direction, price, size, closed PnL — i.e. how a position was built or unwound | POST to the info API with a user address |
Leaderboard | The largest and most profitable accounts by PnL and volume — your candidate whale list | Public stats endpoint (large file; query, don't scrape live) |
metaAndAssetCtxs | Market-wide context: open interest, funding, mark price per asset — the backdrop crowding sits against | POST to the info API |
L2 book | Live order-book depth — where large resting size sits and how thin a market is | POST to the info API or the websocket feed |
The anchor is clearinghouseState. A request returns a marginSummary (account value, total notional position, margin used, withdrawable) and an assetPositions array. Each entry in that array is a single open position, and it carries the fields that matter: the signed size, the entry price, the leverage type and multiple, the unrealized PnL, and — the field most tracking tools center on — the estimated liquidation price.
That last field is why on-chain tracking feels almost invasive. On Hyperliquid you can, in principle, read the price at which any given large account is scheduled to be force-closed. To read those numbers correctly you first need how leverage and liquidation actually work and the long/short PnL mechanics behind a perpetual position; the raw fields are meaningless without that grounding.

How do you actually find and read a whale?
You do not scan the entire chain. The efficient pattern is seed, then poll: build a small watchlist of interesting addresses, then query only those on a schedule.
The public leaderboard is the natural seed. It ranks accounts by realized performance and volume, which surfaces both the largest capital and the most consistent operators. Large individual fills are a second seed — an address that repeatedly prints seven-figure market orders is, by definition, moving size. Third-party explorers such as hypurrscan.io can help you inspect a specific address's history when you already have it.
Once an address is on your list, reading it is a matter of turning fields into a picture:
Direction and conviction — the sign of the position size and its notional relative to account value. A position at high notional-to-equity is a high-conviction (or high-risk) bet.
Leverage and headroom — the leverage multiple and the gap between mark price and the liquidation price. A thin gap means the account is fragile to a move against it.
How it was built — userFills shows whether the position was scaled in patiently or slammed on in one clip, and whether the address is adding to a loser or trimming a winner.
Against what backdrop — the same coin's aggregate open interest and funding from metaAndAssetCtxs, so you know whether one whale is alone or part of a crowd.
Note the discipline here: each of those bullets is an observation. The interpretation — "this whale is trapped," "this is smart money accumulating" — is a separate, far less certain step, and it is where most of the risk lives.
What can whale positioning tell you — and what can't it?
Used carefully, on-chain positioning is a genuine input to market structure. Aggregated across the largest accounts, it hints at where crowding and leverage are building. If a single asset shows heavy one-sided open interest concentrated in a handful of highly levered addresses whose liquidation prices sit close together, that is a legible fragility: a move into that band may trigger clustered liquidations, and thin book depth can amplify the resulting wick. That is a risk you can watch for, not an outcome you can schedule.
Position data also sharpens your reading of the rest of the exchange. Whale flow interacts with funding — heavy leveraged longs tend to push funding positive, and Hyperliquid settles funding hourly rather than on the eight-hour cycle common elsewhere, so those pressures reprice quickly. Pairing a whale watchlist with funding-rate dynamics and the market-wide numbers on the dashboard gives you a fuller structural view than either does alone. It also explains part of why the HLP vault behaves the way it does: as the standing counterparty to much of the taker flow, it is on the other side of exactly these crowded bets.
What positioning cannot tell you is intent. You see one leg of a book that may span several venues. This is the single most important limitation, and it deserves its own section.
Where does the signal break down?
• You see one leg, not the book. A visible Hyperliquid long can be the hedge against an off-exchange short. Transparency on one venue is not transparency on a trader's net risk.
• Vaults and market makers look like whales. Delta-neutral funding farmers and liquidity providers carry large notional with little directional meaning. Size is not the same as a bet.
• Copy-trading is reflexive. When a whale's position becomes a public signal, crowding around it changes the very outcome you were trying to predict.
Start with the hedging problem. Hyperliquid exposes the position it hosts, not the trader's total exposure. A market-neutral desk running spot on one venue and a short perp on Hyperliquid will appear, on-chain, as a large directional short. Copy that "short" and you have taken a naked bet the whale never made. The seed-level assumption that a big visible position equals a big directional view is exactly the trap the transparency invites.
Then there is the composition problem. A meaningful share of large accounts are market makers and funding farmers whose size reflects strategy plumbing, not conviction. Distinguishing a directional whale from a neutral one is genuinely hard from position data alone — behavior over time (do they add margin defensively? do they hold through drawdowns?) is a better filter than any single snapshot, and even that is inference.
Finally, reflexivity. The more a whale's book is watched and copied, the less it predicts. Public liquidation levels can become targets; crowded copy-trades can turn a whale's exit into a cascade that hurts the followers most. This is the core reason to treat whale data through a risk-management lens rather than a signal-chasing one. And because Hyperliquid's per-account transparency has no equivalent on centralized venues — a structural contrast covered in Hyperliquid versus Binance futures — the temptation to over-trust what you can see is unusually strong.
One more correction to a common myth: liquidations on Hyperliquid trigger off the exchange's robust mark price, which blends an oracle (built from external venue prices) with the book — not off a single CEX median you can trivially front-run. Anticipating another account's forced exit for a guaranteed few percent is not a strategy the data supports; treat liquidation clusters as ambient risk, not as a payout.

How should you actually monitor whales?
A workable monitoring loop is deliberately modest:
Seed a watchlist from the leaderboard and from large recurring fills — a few dozen addresses, not the whole chain.
Poll each address's clearinghouseState on a sensible interval (minutes, not milliseconds) and store snapshots so you can diff them.
Diff for change: new positions, size added or cut, leverage raised, liquidation price drifting toward mark. The delta is the event, not the static position.
Contextualize each change against that asset's open interest and funding, so a single whale move is read against the crowd.
Respect the limits — the info API is public and generous, but not infinite; poll a focused list rather than hammering it.
If you would rather read the output than build the pipeline, that is exactly what HyperAcademy's live whale tracker does: it watches the leaderboard's top accounts, surfaces their open positions with direction, leverage, entry, and liquidation levels, and refreshes on a roughly half-hourly cadence. Pair it with the funding view to see the crowding-and-cost side of the same story. The tool is a lens on the on-chain state described above — the interpretation, and the risk, remain yours.
Sources
Hyperliquid Docs — Info endpoint — confirms clearinghouseState, userFills, and market-context request types and their response fields.
Hyperliquid Docs — API overview and rate limits — public info API, request format, and rate-limit model.
Hyperliquid Docs — HyperCore, order book, and consensus — on-chain CLOB, HyperBFT one-block finality, mark-price and liquidation design.
Hyperliquid Leaderboard — public ranking of top accounts by PnL and volume used to seed a whale watchlist.
Hyperliquid Info API endpoint — live endpoint queried to verify clearinghouseState and userFills response shapes (July 2026).
Further Reading
Hyperliquid in 6 Minutes: The Trader's Cheat Sheet from CEX to On-Chain Perps
If you can read a Binance order book, you can already trade on Hyperliquid — but the account underneath looks nothing like one. Here is what changes, and what to check first.
HyperEVM Onboarding: Wallet, Gas, and Core-to-EVM Transfers
HyperEVM is not a separate chain you bridge to, it is the EVM half of Hyperliquid's single state. How to add the network, get HYPE for gas, and move assets between HyperCore and HyperEVM safely, including the one address that destroys your tokens.
Perpetual Futures: Long, Short, and Realized vs Unrealized PnL
Long or short, realized or unrealized PnL, mark price and funding, explained for your first Hyperliquid perpetual trade.