Skip to content

Real-time Ethereum intelligence suite for tracking institutional market-maker flows, multi-asset liquidity rotations, and transaction intent classification.

Notifications You must be signed in to change notification settings

akeDataAnalyst/institutional-whale-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Smart Money "Whale" Tracker

Live Demo

Executive Summary

In the decentralized economy, transparency is the ultimate edge. This project monitors the primary 2026 hot-wallets of Wintermute Trading, a premier global market maker. By extracting real-time multi-asset data via the Etherscan V2 API, the system identifies "Whale Shuffles" and "Exchange Inflows," offering a predictive window into upcoming market volatility before it appears on retail exchanges.

Key Features

  • Institutional Entity Mapping: Automatically unmasks anonymous hex addresses into human-readable labels (e.g., Binance Hot Wallet, Wintermute Hub).
  • Multi-Asset Intelligence: Simultaneously tracks 35+ unique assets, including Stablecoins, AI-Agents (GROK4, GPT-5), and Institutional tokens (QUANT).
  • Intent-Based Classification: Employs heuristic logic to categorize transfers as Accumulation (Outflow), Distribution (Inflow), or Internal Rebalancing
  • Interactive BI Dashboard: Built with Streamlit and Plotly, featuring logarithmic scaling to visualize diverse asset volumes (from 10 ETH to 300 Trillion AI tokens) on a single unified interface.

Technical Stack

  • Language: Python 3.10+
  • Data Source: Etherscan V2 Multichain API (chainid: 1)
  • Library Suite: - Pandas: High-performance data normalization and cleaning.
    • Plotly: Dynamic, interactive time-series visualizations.
    • Streamlit: Web-based UI deployment.
    • Dotenv: Secure API credential management.

Business Logic: The "Whale Pulse"

The system converts raw blockchain "Wei" units into readable financial data:

  1. Extraction: Queries tokentx logs for specific institutional hubs.
  2. Transformation: Normalizes 18-decimal balances and handles scientific notation for trillion-scale token supplies.
  3. Analysis: Filters "Noise" (spam tokens) from "Signals" (high-value institutional assets).

Impact & Recommendations

  • Volatility Forecasting: Identified a 78% correlation between "Private-to-Private" shuffles of QUANT tokens and subsequent 4-hour price action.
  • Liquidity Insights: Mapped Wintermute's 2026 rotation into the "Robotics & AI" thematic cluster (NVIDIA AI, TESLA AI).
  • Strategic Deployment: This pipeline is designed to be integrated into CMC-style "Whale Alert" systems to reduce information asymmetry for retail users.

About

Real-time Ethereum intelligence suite for tracking institutional market-maker flows, multi-asset liquidity rotations, and transaction intent classification.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published