A revolutionary Telegram bot that tracks smart wallets and provides intelligent alerts before they trade on Base network.
- AI-powered scoring system that analyzes transaction patterns
- 0-100 score based on volume, frequency, and success rate
- Automatic insights for each tracked wallet
- Real-time analytics for each wallet
- Volume tracking and transaction history
- Activity patterns and trading behavior analysis
- Multiple notification styles: Psychic, Professional, Minimal
- Adjustable alert thresholds
- Personalized dashboard with portfolio overview
- One-click wallet tracking - just paste the address!
- Interactive buttons instead of typing commands
- Smart validation and error handling
- Visual dashboard with portfolio metrics
- Start the bot with
/start - Click "Track New Wallet"
- Paste any wallet address - no commands needed!
- Get instant insights and smart scoring
- Receive real-time alerts when wallets receive ETH
- 🔍 Track New Wallet - Paste any address to start tracking
- 📋 My Tracked Wallets - View all tracked wallets with scores
- ⚙️ Settings - Customize alerts and preferences
- 📊 Dashboard - Portfolio overview and analytics
- Automatic wallet analysis when you add a new address
- Instant scoring (0-100) based on transaction patterns
- Volume insights and activity metrics
- Success rate analysis for each wallet
The bot analyzes each wallet and provides a 0-100 score based on:
- Transaction Volume - Higher volume = higher score
- Activity Frequency - More active wallets score better
- Success Rate - Successful transactions boost score
- Recent Activity - Recent transactions weighted more heavily
- 70-100: 🚀 High-value wallets with strong patterns
- 40-69: 📈 Promising wallets with moderate activity
- 0-39:
⚠️ Low activity wallets (monitor for changes)
Get a complete overview of your tracking portfolio:
- Total Tracked Wallets - How many you're monitoring
- Average Score - Overall quality of your selections
- Total Volume - Combined ETH volume across all wallets
- Active Wallets - Number of high-scoring wallets
- 🔮 Psychic: "Psychic Ping" with mysterious vibes
- 💼 Professional: Clean, business-like alerts
- 🔔 Minimal: Simple, direct notifications
- Customizable ETH amounts for triggering alerts
- Default: 0.2 ETH (easily adjustable)
-
Clone the repository
git clone https://github.com/FIFTHMAGE/TRADESEER.git cd TradeSeer -
Install dependencies
pip install -r requirements.txt
-
Set up environment variables Create a
.envfile in the project root:TELEGRAM_BOT_TOKEN=your_telegram_bot_token ETHERSCAN_API_KEY=your_etherscan_api_key -
Run the bot
python bot.py
TELEGRAM_BOT_TOKEN: Your Telegram bot token from @BotFatherETHERSCAN_API_KEY: Your Etherscan API key for Base network
The bot continuously monitors tracked wallet addresses by:
- Analyzing transaction patterns for each wallet
- Calculating smart scores based on volume and activity
- Detecting incoming ETH transfers (>0.2 ETH by default)
- Sending personalized alerts with customizable styles
- Providing real-time insights and portfolio analytics
- Sensitive credentials are stored in
.envfile (not committed to git) - API keys and tokens are validated on startup
- Error handling for network issues and API failures
- Secure HTTP API calls for notifications
- Python 3.7+
- python-telegram-bot[job-queue]
- requests
- python-dotenv
- 🎯 Smart Scoring - No other bot analyzes wallet patterns like this
- 📊 Real Analytics - Actual transaction insights, not just alerts
- 🎨 Customizable - Multiple notification styles and preferences
- ⚡ One-Click Tracking - Just paste addresses, no commands needed
- 📱 Beautiful UI - Interactive buttons and visual feedback
- 🔮 Predictive Alerts - AI-powered pattern recognition
MIT License