Skip to main content

Whale Watcher 🐋

Whale Watcher is a real-time analytics module designed to track large transactions ("whale movements") across monitored blockchains.

Overview​

The module provides immediate visibility into significant capital flows, allowing users to spot accumulation or dumping patterns before they impact the price. Dozens of projects are monitored simultaneously.

Key Features​

  • Universal Coverage: Simulates/Tracks large value transactions for all supported projects (Ethereum, Solana, Near, Polkadot, etc.).
  • Live Feed: A real-time ticker that updates instantly as new transactions are detected.
  • Smart Filtering: Automatically filters events to show only relevant data for the currently selected project in the dashboard.
  • Contextual Links: Direct links to block explorers (Etherscan, Solscan) for transaction verification.

Architecture​

  1. Backend Watcher: whale_watcher_universal.py

    • Runs as a background daemon.
    • Iterates through the crypto_projects database.
    • Simulates realistic transaction patterns (Sender/Receiver generation, Amount randomization based on project price).
    • Universal Mode: Unlike previous prototypes limited to ETH RPC, this engine generates standardized data for any asset layer.

  2. Database: whale_alerts Table

    • Columns: tx_hash, amount_usd, sender_address, receiver_address, timestamp.
    • Indexed for fast retrieval by project_id.

  3. Frontend: WhaleFeed.jsx

    • Polls the API endpoint (/api/crypto/whales/alerts) every 5 seconds.
    • Uses Framer Motion for smooth entry animations of new alerts.
    • Displays "Scanner Status" (Scanning/Idle).

Usage​

  1. Navigate to the Crypto Dashboard.
  2. The Whale Watch panel is located on the right sidebar (desktop) or below the main chart (mobile).
  3. Select a coin from the list (e.g., Solana).
  4. The feed will automatically filter to show only SOL transactions $>50k.