Skip to content
CashboardCashboardOpen app

Guide

How to track Hyperliquid positions with a watch-only address

Add the Perps positions widget and paste the account's 0x address. Cashboard reads open perps, spot balances and staked HYPE from Hyperliquid's public data every 10 seconds and shows unrealized PnL and distance to liquidation for each position. It cannot place or close an order.

Step by step

  1. 1

    Start from Perps Desk

    Perps Desk is the template to pick under New from template. It puts an empty My Hyperliquid positions widget next to Funding rates, the Perps risk terminal and a Bitcoin chart, so the context is there before you paste anything. Hyperliquid Desk works too: it starts with the same empty widget beside Hyperliquid pulse, HIP-3 markets and funding against Binance and Bybit.

  2. 2

    Paste the address

    Select the widget and paste into the box that reads 0x public address to watch. Hyperliquid identifies accounts by 0x addresses, so a Solana address will not work here.

  3. 3

    Read the account tiles

    Four tiles sit at the top. Account value adds perps equity, spot and staked HYPE, and its Spot and Staked lines only appear when the account holds any. A unified or portfolio-margin account keeps its perps collateral inside its spot balance, so for those the total is spot plus staked HYPE and perps equity is labelled as sitting inside spot. Staked includes HYPE that is still unstaking. Perps equity carries the withdrawable amount and leverage, and the last two tiles show unrealized PnL and margin used.

  4. 4

    Read each position

    Every open position shows unrealized PnL and, when Hyperliquid reports a liquidation price, how far the mark price sits from it. On a volatile day that distance is the number to watch.

  5. 5

    Add it to net worth

    A Net worth widget on the same board counts the account by default: perps equity, spot balances and staked HYPE. Switch it from All to Ex Hyperliquid to leave the account out.

Tips

  • An empty widget on an account you know is active usually means you pasted an API or agent wallet. Those wallets sign for the main account and hold nothing themselves. Paste the main address instead.
  • The widget reads the main perp dex and every HIP-3 builder dex with a live market, so a stock or commodity perp such as xyz:NVDA gets its own row with a tag naming the dex. If a dex does not answer, an amber strip names it instead of leaving it out silently.
  • Spot balances are priced at their Hyperliquid USDC mid. On a thin spot market that mid can sit far from a fair price, so do not expect to sell a large spot balance at that figure.
  • Keep Funding rates next to your positions. Hyperliquid settles funding every hour, so a crowded position costs or earns something every hour it stays open.
  • Any public account works, including a trader you follow. Hyperliquid account data is public by design.

Widgets used

Terms in this guide

Frequently asked questions

Can Cashboard trade on my Hyperliquid account?

No. Perps positions only reads the public account data behind a 0x address. With no key and no signature, it has nothing to open or close a position with.

Does the watch-only view show spot balances and staking too?

Yes. Next to perps equity you get spot balances, staked HYPE including anything unstaking, and the withdrawable amount for that address.

Last reviewed . Market data in Cashboard comes from the providers named on each widget and may be delayed. Nothing here is financial advice.