DEXTracker: Token Pair Monitoring & Whale Wallet Analysis

DEXTracker is a sophisticated monitoring system that provides real-time analytics for specific token pairs on decentralized exchanges. When provided with a token pair from DEX Screener, it retrieves comprehensive metrics including pair address, liquidity depth, total supply, and other critical data points.

The system then identifies and tracks top trader ("whale") wallets for the specified pair, monitoring their transactions to provide valuable market intelligence.

Prerequisites

• Python (3.10.0 or higher)
• API Keys for the following services:
  • ScraperAPI
  • BitQuery
  • Cielo
  • Etherscan
• MongoDB database
• Telegram Bot Token

Installation

1. Clone the Repository

   git clone https://github.com/yourusername/dextracker.git
   cd dextracker

2. Configure Environment Variables

   Create a .env file in the root directory with your API credentials:

   SCRAPERAPI_API_KEY="your_scraper_api_key"
   BITQUERY_API_KEY="your_bitquery_api_key"
   CIELO_API_KEY="your_cielo_api_key"
   ETHERSCAN_API_KEY="your_etherscan_api_key"
   MONGODB_URL="your_mongodb_connection_string"
   TELEGRAM_BOT_TOKEN="your_telegram_bot_token"

3. Setup and Run

   # Create virtual environment
   python -m venv venv
   
   # Activate virtual environment
   # On Windows:
   venv\Scripts\activate
   # On macOS/Linux:
   source venv/bin/activate
   
   # Install dependencies
   pip install -r requirements.txt
   
   # Start the application
   python start.py

Features

• Real-time Token Pair Monitoring: Track price movements, liquidity changes, and trading volume.
• Whale Wallet Identification: Detect and monitor the most active and largest traders.
• Transaction Analysis: Examine transaction patterns to identify market trends.
• Alert System: Receive notifications via Telegram for significant events.

Architecture

Component	Technology	Purpose
Backend	Python 3.10+	Core application logic
Notification	Telegram Bot	Real-time alerts and commands
Database	MongoDB	Data persistence and analytics
APIs	ScraperAPI, BitQuery, Cielo, Etherscan	Data acquisition and enrichment

Contact

For questions, suggestions, or collaboration opportunities, please reach out:

• Telegram: Join Telegram
• Discord: Join Discord