How to track a Hyperliquid wallet: positions and alerts

You can track any Hyperliquid wallet with nothing but its address, because Hyperliquid's positions are part of the public chain state and its API returns them for every account. On Blockmetric that means pasting the address into the search box, reading the wallet page and, if you want to be told when something changes, adding the address to Guard or a wallet alert.

This guide goes through the steps in order, explains what each view shows on which plan, and lists what a wallet tracker cannot tell you.

Why a Hyperliquid wallet can be tracked at all

On a centralised exchange, an account's positions are private. On Hyperliquid, every order, trade and liquidation happens onchain,¹ and the perps clearinghouse keeps each address's balance and positions as part of HyperCore's execution state.² The public info API answers a request called clearinghouseState for any address: open positions with size, entry price, leverage, margin used, unrealised profit and loss and the position's own liquidation price, plus the account's margin summary.³

No login, API key or permission from the owner is needed, and nothing is signed. Tracking is reading, never trading. Two consequences are worth keeping in mind:

• An address is not a person. A trader can spread activity across several addresses, and sub-accounts have addresses of their own that are queried separately.⁴ A wallet page shows one address.
• Public does not mean complete. Reading an address is cheap, but reading every address all the time is not possible within the API's rate limits, so every tracker chooses which wallets to poll and how often.

Step 1: find the address

Most people start from one of three places:

• The search box. Paste a 0x address into the search at the top of any page. It offers the wallet page and a live liquidation check in Guard for that address.
• The whale tracker. The whale tracker lists large positions and movements of the wallets we track; every row links to the wallet behind it.
• The leaderboard. The trader leaderboard ranks Hyperliquid accounts by profit and return from the official leaderboard, with win rate and holding time from closes we observed ourselves and drawdown from Hyperliquid's portfolio history, and links each trader's wallet.

Vaults have a list of their own under Traders, and the smart money list in the whale tracker narrows the leaderboard to wallets that pass our filters (no vaults, market makers or hedged books).

Step 2: read the wallet page

The wallet page reads the address live from Hyperliquid when you open it: perpetual positions (including builder-deployed HIP-3 markets) and spot balances, and on paid plans also open orders, fills and portfolio history. If the live read is not possible at that moment, the page shows the last stored state with its time, so you always know how old the numbers are.

What each plan shows:

The two numbers to read first on every position are its liquidation price and its distance to liquidation: how far the mark price has to move before the position is force-closed. Both move when margin is added or removed and, in cross margin, when other positions of the account gain or lose.

Step 3: get told when something changes

A wallet page answers "what does this wallet hold now". Two alert types answer "tell me when it changes". Both use the same channels: e-mail, Telegram, Telegram groups and channels, and alert webhooks, depending on the plan.

Liquidation Guard watches the positions of an address and alerts you when one comes within your chosen distance of its liquidation price, optionally only for one coin. You set the distance anywhere between half a percent and twenty-five percent. Guard is read-only: it never connects to the wallet or places orders. It is meant first of all for your own wallets, but it works the same for any address. Open it at Guard.

Wallet activity alerts fire when the address opens, increases, reduces, closes or loses a position to liquidation. On Telegram, each position gets one message that is updated in place as the position changes, with a new message for guard threshold crossings and liquidations; e-mail only carries those two. They are set up under Alerts.

Guard and wallet alerts share one allowance of watched addresses, and an address counts once even if both watch it: one address on Free, ten on Pro and fifty on Desk.

Step 4: put the wallet in context

One wallet's position means more next to the market around it:

• Liquidation levels of the coin. The coin's heatmap shows where tracked positions in that market would be liquidated. A whale's liquidation price sitting inside a large cluster is a different situation from one far away from everything else.
• Other large positions. The positions and movements tabs of the whale tracker show whether the wallet is alone on its side or one of many.
• Its record. On the leaderboard, a wallet's win rate and holding time come from closes we saw ourselves and its drawdown from Hyperliquid's portfolio history, so they describe how it has traded, not how it will.

For a dated look at what our position tracking showed across the largest wallets, with leverage and distance to liquidation, see Hyperliquid whales: what our position tracking shows.

What wallet tracking cannot tell you

• Intent. A large short can be a hedge of a spot holding elsewhere, part of a funding trade or an outright position. The chain shows the position, not the reason.
• Identity. Names on the leaderboard are chosen by the account owner. An address with no name is just an address.
• Every venue. A wallet's activity on centralised exchanges or other chains is not part of its Hyperliquid account.
• The full history. Moves, fills and calendars reach back as far as the wallet has been in our records and as far as your plan allows; a wallet we started reading recently has a short history with us.
• Timing to the second. Tracked wallets are re-read on a schedule: addresses watched by Guard about every 45 seconds, addresses with a wallet alert and the largest wallets about every two and a half minutes. Alerts follow those reads, so they arrive up to minutes, not milliseconds, after a change.

Nothing on a wallet page is a recommendation to copy it. It shows what an address holds and did, measured as precisely as the public data allows.

Common questions

Do I need the owner's keys or permission? No. Positions, orders and fills of every Hyperliquid address are public, and Guard only reads them.³⁴

Can I track an account on a centralised exchange the same way? No. Centralised exchanges do not publish positions per account, which is why this works on Hyperliquid and not there.

Does tracking a wallet cost anything? The wallet page, Guard for one address and wallet alerts are part of the Free plan; deeper history, more addresses and exports come with Pro and Desk.