An open-source, real-time Solana wallet tracker with Telegram notifications for portfolio and transaction monitoring on the Solana blockchain.
This application monitors Solana wallet activities in real-time, analyzes transactions, and sends detailed notifications through Telegram. It's designed for traders, investors, and developers who need immediate insights into wallet transactions on the Solana blockchain.
- Real-time Transaction Monitoring: Track wallet activities as they happen on the Solana blockchain
- Multi-wallet Support: Track multiple wallets simultaneously through an intuitive Telegram interface
- Detailed Transaction Analysis: Identify buy/sell operations, token transfers, and amounts
- Instant Telegram Notifications: Receive formatted alerts with comprehensive transaction details
- Transaction History: Store and query historical transaction data with MongoDB
- Token Information: Get detailed token data including symbols, names, and amounts
- PNL Tracking: Calculate and display profit and loss for each transaction
The system is built on three core components:
- Helius RPC: Provides reliable Solana blockchain data access with WebSocket connections
- MongoDB: Stores transaction history for analysis and reference
- Telegram Bot API: Delivers real-time notifications and interactive user interface
# Clone the repository
git clone https://github.com/imcrazysteven/Solana-Wallet-Tracking-Telegram-Bot.git
# Navigate to the project directory
cd Solana-Wallet-Tracking-Telegram-Bot
# Install depen dencies
npm install
Create a .env file in the root directory with the following variables:
# Solana RPC Configuration
RPC_URL=https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
WSS_URL=wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
# [Optional] Default Wallet Configuration
WALLET_ADDRESS=YOUR_DEFAULT_WALLET_ADDRESS
# MongoDB Configuration
MONGODB_URI=mongodb://localhost:27017/solana_wallet_tracking
# Telegram Configuration
TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN- Open Telegram and search for the @BotFather
- Send
/newbotcommand - Name your bot (e.g., "SolanaWalletTracker")
- Choose a username (e.g., "SolanaWalletTrackerBot")
- Save your bot token
Once you clone the repository, install dependencies, and configures .env, you can simply start the application with the following command:
# Start the application
npm start
The bot supports the following commands:
/start - Initialize the bot and see the welcome message
/help - Display available commands and usage instructions
/list - View all wallets you're currently tracking
/stop [address] - Stop tracking a specific wallet
/stopall - Stop tracking all
To track a new wallet, simply send a valid Solana wallet address to the bot.
🔔 New Transaction Detected!
👛 Wallet: AbC1...XyZ9
💰 Sol Amount: 🟢 BUY 1.234 SOL
💸 PNL for this Token: 0.123 SOL
🚀 Token: BONK(Bonk)
🔗 View Transaction
⏰ 2025-04-01 12:34:56The system:
- Establishes WebSocket connections to Solana via Helius
- Listens for transaction logs in real-time
- Parses transaction data to extract relevant information
- Analyzes token transfers and SOL movements
- Formats and sends notifications via Telegram
- Stores transaction data in MongoDB for historical reference
- The bot uses WebSocket connections for efficient real-time monitoring
- Transaction data is cached to minimize RPC calls
- MongoDB indexes optimize query performance
- Telegram message formatting is optimized for readability
- Does this bot require my private keys?
No, the bot only needs public wallet addresses to monitor transactions.
- Can I track multiple wallets simultaneously?
Yes, you can track as many wallets as you need through the Telegram interface.
- Will I get notifications for all transaction types?
The bot focuses on token transfers, swaps, and SOL movements, filtering out less relevant transactions.
- Is historical data available?
Yes, transaction data is stored in MongoDB for historical analysis.
This project is licensed under the MIT License.
- Email: [email protected]
- GitHub: Steven (@imcrazysteven)
- Telegram: @imcrazysteven
- Twitter: @imcrazysteven
- Instagram: @imcrazysteven
Solana, Blockchain, Wallet Tracker, Telegram Bot, Real-time Monitoring, Transaction Analysis, Cryptocurrency, Trading Bot, DeFi Tools, Solana Transactions, Blockchain Monitoring, SPL Tokens, Crypto Alerts, Solana Token Tracking, Crypto PNL Monitoring, Solana Network, Blockchain Notifications, Cryptocurrency Trading, DeFi Monitoring, Solana DeFi, Solana Wallet Notifications, Crypto Transaction Alerts, Blockchain Analytics, Solana Whale Tracking, Token Transfer Monitoring, Crypto Portfolio Tracker