Vybe Watch

Vybe Watch is a plug-and-play Telegram bot that turns any Solana wallet or token into a real-time Alpha stream. It pushes instant alerts on big inflows/outflows, price‐spikes, and whale buys, while a single tap shows full analytics via Vybe API. Users can add wallets, set custom USD or % thresholds, track token moves, and pull one-click PnL or risk reports through clean UX. Invite the bot to a community channel and it auto-generates a short token card with a Vybe API link—driving traffic straight to the platform.

Features

• Real-time Alerts: Get instant notifications about significant wallet and token movements
• Custom Thresholds: Set custom USD or percentage thresholds for alerts
• Wallet Tracking: Add any Solana wallet address to track balances and transactions
• Token Monitoring: Track token price movements and whale activity
• Group Integration: Add the bot to community channels for auto-generated token cards
• Vybe API Integration: One-click access to detailed analytics

Installation

Prerequisites

• Node.js 14 or higher
• MongoDB (optional, for persistence)
• Telegram Bot Token (from BotFather)
• Vybe API Key

Setup

1. Clone the repository:

git clone https://github.com/incryptomax/vybewatch.git
cd vybewatch

2. Install dependencies:

npm install

3. Create a .env file by copying the example:

cp .env.example .env

4. Edit the .env file with your credentials:

TELEGRAM_BOT_TOKEN=your_telegram_bot_token
VYBE_API_KEY=your_vybe_api_key
MONGODB_URI=your_mongodb_connection_string

5. Start the bot:

npm start

For development with auto-reload:

npm run dev

Usage

Basic Commands

• /start - Initialize the bot and see available options
• /help - Show all available commands
• /track <address> - Track a wallet or token
• /balance - Check your tracked wallet balances
• /transactions - View recent transactions
• /alerts - Configure alert thresholds
• /check - Verify Vybe API connection

Advanced Usage

Setting Alert Thresholds

You can set custom thresholds for different types of alerts:

/alerts wallet 5000 10

This sets wallet inflow/outflow alerts to trigger at either $5000 or 10% change.

Group Chat Features

Add the bot to a group chat to enable community features:

1. Add @VybeWatchBot to your group
2. Use /track to add wallets or tokens for the group
3. Configure notifications with /alerts
4. The bot will automatically generate token cards with Vybe API links

Project Structure

/
├── src/                    # Source code
│   ├── bot.js              # Main bot initialization
│   ├── commands/           # Command handlers
│   ├── api/                # API integration
│   ├── services/           # Business logic
│   ├── storage/            # Data persistence
│   └── utils/              # Utility functions
├── config/                 # Configuration
├── .env                    # Environment variables
└── .env.example            # Example env file

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT