VybeScope Telegram Bot

Visit here: t.me/vybescope_bot

Note: The Bot Code is deployed on a Very Fast VPS (Virtual Private Server)

VybeScope is a feature-rich Python Telegram bot for Solana users, offering real-time wallet tracking, token stats, and whale alerts. Users can connect and monitor multiple wallets, view live balances and 24h changes, and receive instant notifications for large transactions (whale alerts) with customizable thresholds. The bot provides detailed token statistics, top holders, and market data for any Solana token, plus a personal dashboard to manage tracked wallets and alert settings. All data is stored in-memory or lightweight JSON, ensuring privacy and fast setup.

The intuitive button-based interface makes it easy to add/remove wallets, set whale alert thresholds, and explore token analytics and even Deep Research on Tokens & Protocols using an LLM.

VybeScope is ideal for traders, investors, and enthusiasts who want quick and actionable insights on the Solana blockchain directly in Telegram.

User Interface

Token Information	Wallet Tracking	Whale Alerts

Key Features

• 🔗 Connect and track multiple Solana wallets
• 🐋 Customizable whale alerts for large transactions
• 📊 Token stats, price, and top holders lookup
• 💼 Personal dashboard for wallet and alert management
• 🔔 Real-time notifications for whale alerts and Tracked Wallet Transactions
• 🤖 Research Agent Telegram Mini App (For advanced AI analytics and research.)

Notification System

I have also tested and validated the scheduled notification system for both whale alerts and wallet tracking.

The bot is built with a fully asynchronous architecture, utilizing non-blocking API calls to ensure responsive performance even when handling multiple concurrent user requests or processing blockchain data in real-time.

Feature	Description	Demo
Wallet Transfer Alerts	Receive instant notifications whenever your tracked wallets send or receive funds. The system monitors transactions in real-time and delivers detailed alerts showing transaction amount, token type, and wallet addresses involved. Customize tracking for multiple wallets simultaneously.
Whale Transaction Alerts	Stay ahead of the market with customizable whale alerts. Set your own thresholds for transaction sizes to monitor large trades that could impact token prices. Each alert provides detailed information including transaction value, percentage of total supply moved, and links to explore the transaction further.

Both notification types operate on configurable intervals (default: 1 minute), which you can adjust in the environment settings for your specific monitoring needs.

Quick Start & Local Setup

1. Clone the repo and install requirements:

   git clone https://github.com/eskayML/vybeScope
   cd vybescope
   

2. Install dependencies (use a virtual environment preferably):

   pip install -r requirements.txt
   

3. Create a .env file in the project root with the following required variables:

   BOT_TOKEN=your_telegram_bot_token_here
   VYBE_API_KEY=your_vybe_api_key_here
   

   Some optional env parameters you could also include are

   WHALE_ALERT_INTERVAL_SECONDS = 60 
   # not adding this env variable leaves the default value in the code at 60 (1 minute)
   
   WALLET_TRACKING_INTERVAL_SECONDS = 60
   # likewise not adding this env variable leaves the default value as 60 (1 minute)
   

4. Start the bot:

   python bot.py
   

Novel Feature - LLM Research Agent 🤖

This is an Embedded Telegram Mini Application that has full fledged conversation ability , and can communicate about most information relating to solana and the vybe ecosystem.

Bonus - ⚡ Quick Commands & Features

I added available quick commands to augment the already rich User Interface for quick and easy access to different features

You can use these commands for quick access to features:

• /start – Show main menu & restart the bot
• /dashboard – View your personal dashboard (tracked wallets & whale alert settings)
• /wallet <address> – Add a new wallet to track or view an existing tracked wallet
• /token <address> – Get statistics and information for a specific Solana token
• /whalealerts – Manage whale alert notifications, add/remove tokens, set thresholds, and toggle alerts
• /agent – Open the Research Agent mini app for advanced AI analytics

💡 Other Tips:

• Use the interactive buttons in chat for most actions
• Directly send a wallet or token address to the bot for quick info
• The bot guides you with prompts for most operations

Notable Details

This bot is designed to be lightweight and portable:

• Uses JSON storage in user_dashboard.json for user data, wallets, and transactions (can easily be migrated to MongoDB / Supabase)
• Communicates with the Vybe API for blockchain data
• Simple to deploy and run

Hackathon Submission

This project is my submission for the Vybe Telegram Bot Challenge. The goal is to create an intuitive and feature-rich Telegram bot that integrates with cryptocurrency wallets/tokens and provides a seamless user experience.

License

MIT License