Hyperliquid Whale Tracker — Top Perp Traders Live Positions

Hyperliquid Whale Tracker — Live Perp Positions, PnL & Liquidation Monitor

The leading Hyperliquid whale tracker for monitoring top perpetual trading whales — live open positions, unrealized PnL, leverage, and distance-to-liquidation across every tracked wallet. Build large position monitors, find copy-trade targets, and receive liquidation cascade warnings via Telegram. No API key required.

---

What does Hyperliquid Whale Tracker do?

Hyperliquid Whale Tracker monitors any set of Hyperliquid wallet addresses and returns their complete perpetual trading positions in real time. For each tracked trader it delivers open positions per coin (direction, size, leverage, entry price, mark price), unrealized PnL and return-on-equity, liquidation price and distance-to-liquidation percentage, and a trader-level summary covering account value, total notional exposure, and recent fill history. The Actor ships with a curated seed list of publicly-known whale wallets, so you get actionable data in 30 seconds with no configuration. Because Hyperliquid publishes all position data on-chain, every field in this dataset is verifiably accurate — no opaque CEX APIs, no estimated figures.

---

Why use Hyperliquid Whale Tracker?

Crypto traders, algo funds, and risk desks use on-chain perp data to front-run narrative shifts and avoid getting caught in cascades. Here is what this large position monitor unlocks:

• Copy-trade signal generation — See exactly what the top-performing wallets are long or short before they post on Twitter. Query every 5 minutes and feed the output into your execution layer.
• Liquidation cascade early warning — When whales are 1–3% from their liquidation price, forced unwinds are imminent. Pipe distance_to_liq_pct < 3 rows into a Telegram alert to get notified before the market moves.
• Crowded trade detection — If 8 out of 10 tracked perpetual trading whales are net short BTC, that is a contrarian signal worth acting on. The trader summary makes this count trivial to compute.
• Portfolio risk monitoring — Risk teams use this Actor to track whether known whale wallets are building dangerous concentrations in any single asset.
• Narrative tracking — Which coins are whales rotating into this week? recent_traded_coins in the summary answers that automatically.

---

How to use Hyperliquid Whale Tracker

1. Click Try for free on the Apify Store listing.
2. Optionally add wallet addresses to the traders array. Leave it empty to use the built-in seed list of known Hyperliquid whale wallets.
3. Set minPositionUsd to filter out small positions (default: $10,000).
4. Enable Telegram alerts by adding telegramBotToken and telegramChatId.
5. Click Start — results arrive in under 60 seconds.
6. For continuous monitoring, click Schedule and set the cadence (every 5–15 minutes recommended).

---

Input

Field	Type	Default	Description
traders	string[]	seed list	Wallet addresses to monitor. Empty = bundled seed list of public whales
minPositionUsd	integer	10000	Skip positions below this notional value
includeRecentFills	boolean	true	Also fetch each trader's recent fill history
fillsLookbackHours	integer	24	How many hours back to pull fills
sortBy	string	size_desc	size_desc, pnl_desc, pnl_asc, leverage_desc, distance_to_liq_asc
alertPnlUsd	integer	0	Telegram alert when any position's absolute PnL exceeds this USD amount. 0 = disabled
telegramBotToken	string (secret)	—	Telegram bot token for alerts
telegramChatId	string	—	Chat ID to receive alerts

Example — Track specific whales, alert on large PnL:

{
  "traders": ["0xabc...", "0xdef..."],
  "minPositionUsd": 500000,
  "sortBy": "size_desc",
  "alertPnlUsd": 1000000,
  "telegramBotToken": "<token>",
  "telegramChatId": "<chat>"
}

Example — Liquidation early-warning scan:

{"minPositionUsd": 100000, "sortBy": "distance_to_liq_asc"}

---

Output

Two record types per trader are written to the dataset.

Position rows (_type: "position") — one per open position:

{
  "_type": "position",
  "trader": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
  "coin": "BTC",
  "direction": "long",
  "position_size": 12.5,
  "position_size_usd": 859500,
  "leverage": 20,
  "leverage_type": "cross",
  "entry_px": 67800,
  "mark_px": 68760,
  "unrealized_pnl_usd": 12000,
  "return_on_equity_pct": 27.94,
  "liquidation_px": 64850,
  "distance_to_liq_pct": 5.69,
  "margin_used_usd": 42975
}

Trader summaries (_type: "trader_summary") — one per wallet:

{
  "_type": "trader_summary",
  "trader": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
  "account_value_usd": 1245000,
  "total_position_notional": 6800000,
  "open_positions_count": 8,
  "long_count": 5,
  "short_count": 3,
  "total_unrealized_pnl_usd": 42500,
  "fills_count_recent": 23,
  "recent_realized_pnl_usd": 8400,
  "recent_volume_usd": 4200000,
  "recent_traded_coins": ["BTC", "ETH", "SOL", "HYPE"]
}

---

Data fields

Field	Description
_type	Record type: position or trader_summary
trader	Wallet address of the perpetual trading whale
coin	Asset being traded (BTC, ETH, SOL, etc.)
direction	long or short
position_size_usd	Notional position value in USD
leverage	Leverage multiplier applied
entry_px	Average entry price
mark_px	Current mark price
unrealized_pnl_usd	Unrealized profit or loss in USD
return_on_equity_pct	PnL as percentage of margin used
liquidation_px	Price at which position is forcibly closed
distance_to_liq_pct	Distance from mark price to liquidation — the primary cascade signal
account_value_usd	Total account equity of the tracked trader
total_position_notional	Sum of all open position sizes
recent_traded_coins	Coins traded in the lookback window

---

Cost estimation

Pricing is Pay-Per-Event at $0.003 per trader scanned.

Use case	Traders	Cost per run	Monthly cost (24 runs/day)
10 whales (default seed)	10	$0.03	$21.60
20 whales	20	$0.06	$43.20
100 whales	100	$0.30	$216

Tracking 10 Hyperliquid whale wallets every hour costs about $0.72/day.

---

FAQ

Does Hyperliquid require authentication to access position data? No. Hyperliquid's REST API at api.hyperliquid.xyz/info is fully public. All position, fill, and account data is on-chain and openly accessible — no API key, no wallet signature, no rate-limit configuration needed.

Can I track wallets I found on Twitter? Yes — paste any Hyperliquid wallet address (0x...) into the traders array. The Actor fetches their positions directly from the public API.

How do I use this for liquidation cascade alerts? Set sortBy to distance_to_liq_asc and add Telegram credentials. Then filter the results downstream for distance_to_liq_pct < 3 — wallets within 3% of liquidation are the highest-risk cascade triggers.

Disclaimer: This Hyperliquid whale tracker provides position data for informational and research purposes only. It does not constitute financial advice. Copy-trading carries significant risk; large position holders may reverse positions rapidly. Past PnL of tracked wallets does not predict future performance. Always manage your own risk independently.

---

Live Sample Run

A real run executed on 2026-06-10:

Field	Value
Items in dataset	2004
Dataset (JSON)	https://api.apify.com/v2/datasets/b64yMifgEwo8Fq0Tr/items?clean=1&format=json
Dataset (CSV)	https://api.apify.com/v2/datasets/b64yMifgEwo8Fq0Tr/items?clean=1&format=csv
Run summary (KVS)	https://api.apify.com/v2/key-value-stores/Dmdz28nnGFaC9phCe/records/SUMMARY
Run details	https://api.apify.com/v2/actor-runs/KTgakr2IOwmvsjxcR

---

Related Actors

• Long/Short + OI Aggregator — Aggregate cross-exchange positioning context alongside whale trades.
• Smart Money Wallet Tracker — Spot-market whale activity across EVM and Solana.
• CEX Funding Rate Aggregator — Funding rates and open interest across CEX perps.

Feedback

If this Actor saves you time, a quick review helps others find it: Leave a review on Apify Store