Skip to content

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

License

Notifications You must be signed in to change notification settings

NYXBAM/CryptoWhaleMonitor

Repository files navigation

Crypto Whale Monitor

GitHub stars 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

image image image


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

About

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

Topics

Resources

License

Stars

Watchers

Forks