Crypto Whale Monitor

Enjoying this project? Give it a ⭐ and join the community of supporters!

🐋 Crypto Whale Monitor is a real-time monitoring tool for tracking large cryptocurrency transactions ("whales") across multiple blockchains including BTC, ETH, and other. Alerts are sent directly to a Telegram channel for instant notifications.

TG CHANNEL (Show how it`s work): https://t.me/CryptoTransac

<p align="center"> <img width="422" height="375" alt="image" src="https://github.com/user-attachments/assets/8fa0e371-6338-48a6-918e-995b4a410da8" /> <img width="422" height="375" alt="image" src="https://github.com/user-attachments/assets/19b9cfa0-9209-41f0-8fb6-318fa87c1147" /> <img width="422" height="375" alt="image" src="https://github.com/user-attachments/assets/7a81f942-a9a3-47f4-a465-803c1a47ed51" /> </p>

---

| Feature | Status | |---------|--------| | 🦾 AI Transactions Analyzer | ✅ Completed | | $TRX blockchain | ✅ Completed | | $TRX classification/label parser | ✅ Completed | | $TON blockchain | ✅ Completed | | REST API | ✅ Completed | | $SOL blockchain| ✅ Completed | | Charts | ⚡ Coming Soon | | $TRX mem coin tracking| ⚡ Coming Soon |

Features

• Monitor large transactions on Bitcoin, Ethereum, and other.
• Identify whale transactions based on customizable thresholds.
• Telegram alerts with formatted HTML messages.
• Track from/to addresses, transaction amount, and link to blockchain explorers.
• Save transactions to SQLite database for historical analysis.
• Easily extensible for adding more blockchains or custom thresholds.

---

Tech Stack

• Python 3.13+
• Requests for blockchain RPC calls and Telegram API
• SQLAlchemy for database ORM
• dotenv for configuration management
• APIs: Moralis for tagging addresses (e.g., exchanges)

---

Setup

1. Clone the repository:

git clone https://github.com/NYXBAM/CryptoWhaleMonitor.git
cd CryptoWhaleMonitor

pip install -r requirements.txt

Create a .env file in the project root:

TG_BOT_TOKEN=your_telegram_bot_token
TG_CHAT_ID=-1001234567890   # your channel ID
# moralis api 
MORALIS_API_KEY=ealGJ # your moralis api key, it`s for free -> here https://admin.moralis.com/login
API_INTELLIGENCE= # u can get this for free -> here https://io.net/intelligence #
# This api using to generate Ai analyze report

Then run main.py file

python main.py