Whale Watcher
Real-time whale tracking and orderbook imbalance analytics for Pacifica perpetual markets. Monitor large trades, visualize bid/ask pressure, and receive personalized alerts — all in one dashboard.
Features
Real-time Whale Detection
Monitors every trade on Pacifica perpetuals via WebSocket. When a trade exceeds the configured threshold, it is instantly classified, stored, and broadcast to all connected clients.
Orderbook Imbalance Indicator
Aggregates bid and ask volume from the top orderbook levels (Pacifica book stream) and computes a normalized imbalance ratio. Updates every 250ms per Pacifica's stream cadence.
Order Flow Board
Splits detected whale trades into separate buy and sell columns for visual comparison, with total volume and pressure percentage shown at the bottom.
Volume Analytics
Shows 24-hour buy vs sell volume distribution as a bar chart, top 5 largest buys and sells, net flow, and market sentiment indicator.
Telegram Alerts
Each user can set their own minimum trade size for alerts. Quick templates at $10k, $50k, and $100k plus a custom /set_<amount> command.
Dashboard
The dashboard has five tabs. A symbol filter (ALL / BTC / ETH / SOL) applies globally.
Overview Tab
- •Live whale activity feed with real-time updates
- •Orderbook Imbalance indicator with per-symbol breakdown
- •Volume Distribution chart (24h buy vs sell)
Order Book Tab
- •Side-by-side buy and sell whale flow
- •Total volume per side
- •Buy/sell pressure progress bar
Analytics Tab
- •Top 5 largest buy trades and sells
- •Volume by symbol with buy-sell ratio
- •Market sentiment gauge
Smart Trade Tab
- •Signal per symbol: LONG / SHORT / HOLD with confidence %
- •Combines orderbook imbalance + whale flow + activity level
- •One-click link to execute on Pacifica testnet
Portfolio Tab
- •Account equity, balance, margin used, available
- •Open positions with unrealized PnL
- •Quick links to deposit
Smart Trade
The signal engine combines multiple data sources into a single actionable recommendation per symbol.
Signal Factors
Direction Logic
Orderbook Imbalance
Reads the Pacifica book WebSocket stream and calculates the ratio of bid volume to total volume across the top 10 price levels.
Signal States
Formula
Whale Detection
The backend subscribes to the Pacifica trades stream and checks each trade against per-symbol thresholds.
Thresholds
| Symbol | Dashboard Alert | Telegram Default |
|---|---|---|
| BTC | $10,000 | $50,000 |
| ETH | $10,000 | $50,000 |
| SOL | $1,000 | $5,000 |
Trade Direction Mapping
Telegram Bot
Search @watcherWallerWhales_bot on Telegram to subscribe. Each user has an independent threshold stored per chat session.
/startSubscribe to whale alerts (default threshold: $50,000)/thresholdShow threshold menu with quick-select options/set_10000Set threshold to $10,000 (small whales)/set_50000Set threshold to $50,000 (medium whales)/set_100000Set threshold to $100,000 (large whales)/set_<amount>Set any custom threshold, minimum $1,000/statusShow current subscription and threshold/stopUnsubscribe from all alertsAPI Reference
Base URL: https://43.157.201.151.sslip.io
/healthHealth check + WebSocket client count
/api/v1/whales/recentRecent whale alerts (query: symbol, limit)
/api/v1/whales/statsWhale statistics for 24h (query: symbol, hours)
/api/v1/whales/symbolsAll symbols with whale activity
/api/v1/marketsAll available Pacifica markets
/api/v1/markets/imbalanceAggregated orderbook imbalance (query: symbol)
/api/v1/markets/{symbol}/imbalanceImbalance for a single symbol
/api/v1/trading/signalsSmart trade signals for all symbols
/api/v1/trading/signals/{symbol}Signal for a specific symbol
/api/v1/trading/accountPacifica account info (query: account)
/api/v1/trading/positionsOpen positions (query: account)
WebSocket
Connect to wss://43.157.201.151.sslip.io/ws/whales for a persistent real-time stream.
Message Types
initial_data← serverSent on connect. Contains recent whale alerts array and current imbalance snapshot.
{ "type": "initial_data", "data": [...alerts], "imbalances": {...} }whale_alert← serverFired whenever a new whale trade is detected above the configured threshold.
{ "type": "whale_alert", "data": { "symbol": "BTC", "side": "buy", "usd_value": 12500, ... } }imbalance_update← serverThrottled to once per second per symbol. Contains the latest orderbook imbalance data.
{ "type": "imbalance_update", "data": { "symbol": "BTC", "imbalance_pct": 41.5, ... } }ping→ clientSend every 25 seconds to keep the connection alive.
{ "type": "ping" }Architecture
The system connects to two Pacifica WebSocket channels simultaneously: trades for whale detection and book for orderbook imbalance.