Hyperliquid Whale Tracker

Monitor top Hyperliquid perpetual traders' live positions, unrealized PnL, leverage, and distance-to-liquidation. Track copy-trade targets, spot crowded longs/shorts, and get pinged when whales blow up. No API key required.

---

What It Does

Hyperliquid is the largest on-chain perp DEX of 2025-26 with full position transparency — every trader's wallet, open positions, and fills are public. This Actor turns that firehose into a clean dataset:

• Real-time open positions per tracked trader (coin, size, direction, leverage)
• Entry price, mark price, unrealized PnL, return-on-equity
• Distance-to-liquidation in % — early-warning signal for cascading liquidations
• Recent fills (last N hours) with closed PnL + traded coins
• Trader-level summaries: account value, total notional, cross-leverage

---

Why This Matters

Most top crypto traders broadcast their wallet on Twitter. Following their positions used to require manual checks on hyperdash.info. This Actor automates it for your bot/dashboard:

• Copy-trade signals — see what 0xWhaleX is long/short before they tweet
• Liquidation cascades — when major whales are 1% from liq, the chain reaction starts there
• Crowded trade detection — if 8/10 tracked whales are short BTC, that's contrarian gold

---

Input

Field	Type	Default	Description
traders	string[]	seed list	Wallet addresses to track. Empty = bundled seed of known public whales
minPositionUsd	integer	10000	Skip positions below this notional
includeRecentFills	boolean	true	Also fetch each trader's recent fills
fillsLookbackHours	integer	24	Fills time window
sortBy	string	size_desc	size_desc, pnl_desc, pnl_asc, leverage_desc, distance_to_liq_asc
alertPnlUsd	integer	0	Alert when any tracked position has |PnL| above this
telegramBotToken	string (secret)	—	Telegram bot token for alerts
telegramChatId	string	—	Chat ID to receive alerts

Example: Track 5 whales, alert on $500K+ positions

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

Example: Liquidation early warning

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

---

Output

Two record types per trader:

Position rows (_type: "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 summary (_type: "trader_summary"):

{
  "_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"]
}

---

Pricing

Pay-Per-Event (PPE):

• $0.003 per trader scanned (one charge regardless of position count)

Examples:

• Track 20 whales hourly: $0.06/run = $1.44/day = $44/month
• Track 100 whales: $0.30/run

---

Use Cases

Copy-trade scanner — Pull top whales' positions every 5 min:

curl -X POST "https://api.apify.com/v2/acts/gochujang~hyperliquid-whale-tracker/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"traders": ["0x...", "0x..."], "minPositionUsd": 500000, "sortBy": "pnl_desc"}'

Liquidation early-warning — Pipe distance_to_liq_pct < 2 rows to a Telegram bot for cascade alerts.

---

Data Source

Live data via Hyperliquid's official public REST API: https://api.hyperliquid.xyz/info. Free, no auth, no rate limits at single-actor scale.

---

Related Actors

• Smart Money Wallet Tracker — Spot-market whale activity on Ethereum, Base, Arbitrum, BSC, Solana.
• CEX Funding Rate Aggregator — Funding rates + OI + long/short ratio across CEX perps.
• Token Unlock Calendar — Upcoming VC unlocks with selling-pressure score.

---

Feedback

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