Monitors large position opens, closes, and adjustments on Hyperliquid in real time. Alerts when wallets above a configured notional threshold move, letting you see institutional-scale activity before it affects price.
Last updated: March 2026
Hyperliquid Whale Tracker connects to the Hyperliquid WebSocket feed and filters all position events by notional size. When a wallet opens, closes, or adjusts a perpetual position above your configured threshold, the tracker logs it and sends an alert with full context - asset, direction, size in USD, leverage, and the wallet's recent PnL.
The tracker builds a live picture of which wallets are accumulating large positions and in which direction. Over time it identifies repeat whales - wallets that consistently open large positions that precede significant price moves - and tags them for priority monitoring.
Unlike generic on-chain analytics, Hyperliquid Whale Tracker operates natively on Hyperliquid's L1. Every event is detected the moment it lands on-chain, not after a delay from a third-party indexer. The result is sub-second detection on position events that matter.
This is a monitoring tool, not an execution bot. It tells you what whales are doing so you can decide what to do with that information.
| Platform | Architecture | Download |
|---|---|---|
| Windows | x64 | Download the latest release |
| Event Type | Threshold | Data Captured |
|---|---|---|
| Position open | Configurable (default $50K) | Asset, direction, size, leverage, wallet |
| Position close | Configurable | Exit size, realized PnL, hold duration |
| Position add | Configurable | Add size, new total, avg entry change |
| Position reduce | Configurable | Reduce size, remaining position |
| Liquidation | All liquidations above $10K | Asset, size, liquidation price |
The tracker assigns each monitored wallet a score based on:
- Win rate - percentage of closed positions that were profitable
- Avg PnL per trade - average realized PnL in USD
- Size consistency - whether position sizes are consistent (indicates conviction)
- Lead time - how often position opens precede price moves of 1%+
Wallets with high scores are flagged as Priority Whales and trigger alerts regardless of position size.
- Connect - opens WebSocket connection to Hyperliquid's live feed
- Filter - discards events below the notional threshold
- Enrich - fetches wallet history and current open positions via REST API
- Score - updates wallet score based on new event data
- Alert - sends alert via Telegram with full event context and wallet score
[tracking]
min_notional_usd = 50000
min_liquidation_usd = 10000
priority_wallets = []
[scoring]
min_trades_for_score = 5
win_rate_weight = 0.4
avg_pnl_weight = 0.3
lead_time_weight = 0.3
[alerts]
telegram_bot_token = ""
telegram_chat_id = ""
alert_on_open = true
alert_on_close = true
alert_on_liquidation = true
[api]
ws_endpoint = "wss://api.hyperliquid.xyz/ws"
rest_endpoint = "https://api.hyperliquid.xyz"{
"event": "position_open",
"timestamp": "2026-03-14T09:31:22Z",
"wallet": "0x7a3f9c2e1b8d4f6a0c5e7b2d9f1a3c5e7b9d1f3a",
"asset": "ETH",
"direction": "LONG",
"size_usd": 847000,
"leverage": 5,
"entry_price": 2341.50,
"wallet_score": 78,
"wallet_win_rate": 0.71,
"wallet_avg_pnl": 12400,
"wallet_total_trades": 34,
"alert_reason": "large_open"
}Configuration used:
- Threshold: $50,000 notional
- Assets monitored: BTC, ETH, SOL, HYPE, ARB
Whale open detected, alert fired:
| Transaction | Block | |
|---|---|---|
| Position open | 0x4a7c9e2f1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a | #8,241,177 |
Position closed at profit:
| Result | |
|---|---|
| Asset | ETH LONG |
| Hold duration | 4h 22m |
| Realized PnL | +$31,450 on $847,000 position |
What is Hyperliquid Whale Tracker? It monitors Hyperliquid's live position feed for large trades. When a wallet opens, closes, or adjusts a position above your configured threshold, it logs the event and alerts you via Telegram with full context including the wallet's historical win rate.
How does it detect whales vs normal traders? By notional size threshold. The default is $50,000 USD notional, configurable to any amount. You can also add specific wallet addresses to a priority list to always receive alerts regardless of size.
Does it work for all assets on Hyperliquid? Yes. It monitors all perpetual pairs listed on Hyperliquid. You can filter to specific assets or monitor all simultaneously.
How fast is detection? Sub-second. The tracker uses Hyperliquid's native WebSocket feed which delivers events as they land on-chain, with no third-party indexer delay.
Can I track specific wallets?
Yes. Add wallet addresses to priority_wallets in config and they will always trigger alerts regardless of position size.
What is the wallet scoring system? Each tracked wallet accumulates a score (0-100) based on win rate, average PnL per trade, and how often their position opens precede significant price moves.
Does it detect liquidations? Yes. All liquidations above the configured threshold ($10K default) are tracked and alerted separately.
How much API rate limit does it use? Minimal. The WebSocket feed is a single persistent connection. REST calls are only made to enrich new wallets, not on every event.
Can I run it 24/7? Yes. It is designed for continuous operation with automatic reconnect on WebSocket disconnect. State is persisted to disk.
Does it need a wallet or private key? No. The tracker is read-only and uses Hyperliquid's public API. No wallet or private key required.
- Whale following - see when large traders enter or exit, with their historical win rate context
- Liquidation monitoring - track large liquidations that may create short-term price dislocations
- Market sentiment - aggregate large position opens by direction to gauge institutional sentiment
- Priority wallet alerts - follow specific wallets you have identified as consistently profitable
- Lead time analysis - identify wallets that tend to open positions before significant price moves
hyperliquid-whale-tracker/
+-- hyperliquid-whale-tracker-v.1.4.14.exe
+-- config.toml
+-- data/
| +-- logs/
| +-- state/
| +-- wallets/
+-- python/
| +-- src/
| | +-- feed.py
| | +-- filter.py
| | +-- scorer.py
| | +-- alerter.py
| +-- requirements.txt
+-- README.md
websockets, httpx, toml, python-dotenv, rich
- Python 3.10+
- Telegram bot token for alerts
- No Hyperliquid account required (read-only)
Position for position. Whale by whale.