Hyperliquid Whale Wallet Tracker

Find the most profitable traders on the Hyperliquid perpetuals exchange — the "whales" — and follow their live positions and recent trades. This actor ranks every trader on the platform by profit and account size, then (optionally) pulls each wallet's open positions and trade history. A ready-made smart-money / copy-trading signal.

Why use this actor

• No account, no API key, no login — just press Run.
• Find the biggest winners — rank every trader by profit (PnL), return (ROI), or account value, over a day, week, month, or all time.
• See what whales are holding right now — open positions with size, entry price, leverage, and live unrealized profit for any wallet.
• Recent trade history — the latest fills for a wallet (what they bought/sold, price, size, and realized profit).
• Smart-money signals — spot which wallets are winning and mirror their moves.
• Clean, stable JSON ready for spreadsheets, dashboards, databases, or alerting. Export to JSON, CSV, or Excel, and run it on a schedule.

How it works

1. Pick a mode: leaderboard (rank the top traders) or address (look up specific wallets).
2. For the leaderboard, choose the time window (day / week / month / all time), what to rank by (profit / return / account value), a minimum account size, and how many to return.
3. For specific wallets, paste their addresses.
4. Press Run. Results stream into the dataset and can be exported to JSON, CSV, or Excel.

No scrapers, servers, or blocks to manage — the actor handles retries for you.

Modes

Mode	What it returns	Key input
leaderboard (default)	The top-ranked traders for a chosen window and metric.	window, sortBy, minAccountValue, maxItems
address	Live positions + recent trades for specific wallet addresses.	addresses

Turn on Enrich with live positions in leaderboard mode to attach each ranked whale's current open positions.

Input

Leaderboard mode (default):

{
  "mode": "leaderboard",
  "window": "allTime",
  "sortBy": "pnl",
  "minAccountValue": 1000000,
  "maxItems": 100,
  "enrichPositions": false
}

Address mode:

{
  "mode": "address",
  "addresses": ["0x8def9f50456c6c4e37fa5d3d57f108ed23992dae"]
}

Field	Type	Description
mode	string	leaderboard or address.
window	string	Leaderboard: time window to rank on — day, week, month, or allTime.
sortBy	string	Leaderboard: rank by pnl (profit), roi (return %), or accountValue.
minAccountValue	integer	Leaderboard: drop wallets below this account size in USD (default keeps real whales).
maxItems	integer	Leaderboard: how many top traders to return (0 = all that pass the filter).
enrichPositions	boolean	Leaderboard: attach each whale's live open positions (slower).
addresses	array of strings	Address mode: wallet addresses to look up.
proxyConfiguration	object	Optional. Not required — the data is public.

Output

Every record carries a small header (_input, _scrapedAt, _source, recordType) plus the wallet data with the platform's original field names preserved. Convenience numeric fields (e.g. accountValueNum, windowPnl) are added for easy sorting.

WHALE_LEADERBOARD — mode leaderboard, all-time profit

{
  "_input": "leaderboard window=allTime sortBy=pnl minAV=1e+07 top=3",
  "_source": "S1-leaderboard",
  "_scrapedAt": "2026-07-09T11:07:07Z",
  "recordType": "WHALE_LEADERBOARD",
  "rank": 1,
  "window": "allTime",
  "accountValueNum": 225006134.760987,
  "windowPnl": 445047889.570987,
  "windowRoi": 26412.572786162,
  "windowVlm": 15999.34,
  "ethAddress": "0x4ec8fe22a531a96c8a846aaf5cbef73202649a80",
  "accountValue": "225006134.7609870136",
  "windowPerformances": [
    ["day", { "pnl": "0.0", "roi": "0.0", "vlm": "0.0" }],
    ["week", { "pnl": "0.0", "roi": "0.0", "vlm": "0.0" }],
    ["month", { "pnl": "0.0", "roi": "0.0", "vlm": "0.0" }],
    ["allTime", { "pnl": "445047889.5709869862", "roi": "26412.572786162", "vlm": "15999.34" }]
  ],
  "prize": 0,
  "displayName": null
}

WHALE_ADDRESS — mode address (a wallet with $11.3M and 9 open positions)

{
  "_input": "0x8def9f50456c6c4e37fa5d3d57f108ed23992dae",
  "_source": "S1-address",
  "_scrapedAt": "2026-07-09T15:57:00Z",
  "recordType": "WHALE_ADDRESS",
  "address": "0x8def9f50456c6c4e37fa5d3d57f108ed23992dae",
  "accountValueNum": 11343690.714951,
  "numPositions": 9,
  "numFills": 2000,
  "clearinghouseState": {
    "marginSummary": {
      "accountValue": "11343690.7149509992",
      "totalNtlPos": "72748391.6416019946",
      "totalRawUsd": "-61404700.926651001",
      "totalMarginUsed": "11383784.3314909991"
    },
    "withdrawable": "0.0",
    "assetPositions": [
      {
        "type": "oneWay",
        "position": {
          "coin": "SOL",
          "szi": "169806.92",
          "leverage": { "type": "cross", "value": 17 },
          "entryPx": "74.6913",
          "positionValue": "13177356.6058399994",
          "unrealizedPnl": "494245.12716",
          "returnOnEquity": "0.6624689199",
          "marginUsed": "775138.623872",
          "maxLeverage": 20
        }
      }
      // ... 8 more positions (AAVE, WLD, NEAR, HYPE, XPL, ASTER, ZEC, XMR)
    ],
    "time": 1783612389491
  },
  "userFills": [
    {
      "coin": "ZEC",
      "px": "446.5",
      "sz": "0.06",
      "side": "A",
      "time": 1782995681964,
      "startPosition": "49563.81",
      "dir": "Close Long",
      "closedPnl": "5.053344",
      "hash": "0x596d27cbbe3b301c5ae6043f0bba8d020d3200b1593e4eeefd35d31e7d3f0a06",
      "oid": 485730606780,
      "crossed": false,
      "fee": "0.003214",
      "feeToken": "USDC"
    }
    // ... up to ~2000 recent fills
  ]
}

Key output fields

Field	Type	Description
recordType	string	WHALE_LEADERBOARD or WHALE_ADDRESS.
rank	integer	Leaderboard position (1 = best) for the chosen window and metric.
window	string	The time window this ranking is for.
ethAddress / address	string	The wallet address.
accountValueNum / accountValue	number / string	Current account value in USD.
windowPnl	number	Profit over the chosen window (USD).
windowRoi	number	Return over the chosen window.
windowVlm	number	Trading volume over the chosen window.
windowPerformances	array	Profit / return / volume for every window (day, week, month, all time).
clearinghouseState.marginSummary	object	Account value, total position value, and margin used.
clearinghouseState.assetPositions	array	Open positions: coin, size (szi), entryPx, leverage, unrealizedPnl, returnOnEquity.
userFills	array	Recent trades: coin, price (px), size (sz), direction (dir), realized profit (closedPnl), time.
numPositions / numFills	integer	Count of open positions and returned trades.

On any failure the actor emits a {_input, _source, _scrapedAt, _error, _errorDetail} record instead of silently skipping.

Notes & limits

• A trader's leaderboard account value is a snapshot and may differ from the live figure — top-ranked wallets often hold staked or spot balances rather than open positions, so an enriched or address-mode lookup can show few or no open perpetual positions. Use address mode for the current live state.
• userFills returns the most recent trades only (up to ~2000), not full lifetime history.
• All data is public — no account or key needed. A proxy is optional.
• Run on a daily schedule to track how the whale rankings change over time.