VX-Insight: Cryptocurrency Monitoring System

A comprehensive cryptocurrency monitoring system that tracks whale transactions and analyzes crypto news using AI-powered insights.

🚀 Features

• Whale Transaction Monitoring: Real-time tracking of Solana whale transactions from Telegram channels
• News Analysis: Automated scraping and AI-powered analysis of crypto news from multiple sources
• Telegram Integration: Automated notifications via Telegram bot
• Database Storage: SQLite database for storing whale transactions and news articles
• AI Processing: Poe API integration for intelligent content analysis

📋 Requirements

• Node.js (>=20)
• Python3 (<=3.12)
• Telegram Bot Token (for notifications)
• Poe API Credentials (for AI analysis)

🛠️ Installation

1. Clone the repository

   git clone <repository-url>
   cd vx-insight

2. Install Node.js dependencies

   npm install

3. Install Python dependencies

   python3 -m pip install poe-api-wrapper python-dotenv

4. Set up environment variables

   cp .env.example .env
   # Edit .env with your actual credentials

⚙️ Configuration

Environment Variables

Create a .env file in the root directory with the following variables:

# Telegram Bot Configuration
TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
TELEGRAM_CHAT_ID=your_telegram_chat_id_here

# Poe API Configuration
POE_P_B=your_poe_p_b_token_here
POE_P_LAT=your_poe_p_lat_token_here
POE_P_CHAT_CODE=your_poe_chat_code_here
POE_P_BOT=GPT-4o

# Database Configuration
DATABASE_PATH=./store.db

Poe API Setup

1. Create a .env file in the poe-query/ directory:

   P_B=your_poe_p_b_token_here
   P_LAT=your_poe_p_lat_token_here
   P_CHAT_CODE=your_poe_chat_code_here
   P_BOT=GPT-4o

2. Get Poe API credentials from Poe API Wrapper

🚀 Usage

Manual Execution

1. Run News Monitor

   node news-monitor.js

2. Run Whale Monitor

   node whale-monitor.js

Automated Execution

Use the provided scripts for automated monitoring:

1. News Monitoring

   ./scripts/run-news-monitor.sh

2. Whale Monitoring

   ./scripts/run-whale-monitor.sh

📊 Data Sources

News Sources

• CryptoNews: https://crypto.news/news/
• CoinTelegraph Markets: https://cointelegraph.com/markets
• CoinTelegraph Technology: https://cointelegraph.com/tags/technology
• CoinTelegraph Business: https://cointelegraph.com/tags/business
• CoinTelegraph Regulation: https://cointelegraph.com/tags/regulation
• CoinTelegraph NFTs: https://cointelegraph.com/tags/nft
• CoinTelegraph Investments: https://cointelegraph.com/tags/investments

Whale Transaction Sources

• Solana Whale Alert: https://t.me/s/SolanaWhaleAlert

🗄️ Database Schema

News Table

• id: Primary key
• title: Article title
• url: Article URL (unique)
• content: Article content
• datetime: Publication timestamp
• author: Article author
• editor: Article editor
• report: AI-generated analysis report

Whale Feed Table

• id: Primary key
• contract: Token contract address
• action: Buy/Sell action
• name: Token name
• symbol: Token symbol
• url: Transaction URL (unique)
• usd: USD value
• price: Token price
• volume: Trading volume
• liquidity: Liquidity amount
• marketcap: Market capitalization
• datetime: Transaction timestamp

🔧 Cron Job Setup

Direct Script Execution

# Run every 10 minutes
*/10 * * * * open -a Terminal "/path/to/vx-insight/scripts/run-news-monitor.sh"
*/10 * * * * open -a Terminal "/path/to/vx-insight/scripts/run-whale-monitor.sh"

Using Osascript

*/10 * * * * /path/to/vx-insight/scripts/run-news-monitor.sh
*/10 * * * * /path/to/vx-insight/scripts/run-whale-monitor.sh

📁 Project Structure

vx-insight/
├── news-monitor.js          # News monitoring script
├── whale-monitor.js         # Whale transaction monitoring script
├── telegram.js              # Telegram bot integration
├── db.js                    # Database operations
├── scrap.js                 # News scraping utilities
├── scrap-tg.js              # Telegram channel scraping
├── poe.js                   # Poe API integration
├── util.js                  # Utility functions
├── poe-query/               # Python Poe API module
│   ├── config.py            # Poe API configuration
│   ├── poe.py               # Poe API client
│   └── requirements.txt     # Python dependencies
├── scripts/                 # Execution scripts
│   ├── run-news-monitor.sh  # News monitoring script
│   └── run-whale-monitor.sh # Whale monitoring script
├── logs/                    # Log files directory
└── store.db                 # SQLite database

🔒 Security

• All sensitive credentials are stored in environment variables
• .env files are excluded from version control
• No hardcoded API keys or tokens in the codebase

🐛 Troubleshooting

1. Missing environment variables: Ensure all required variables are set in .env
2. Database connection issues: Check if store.db exists and is writable
3. Poe API errors: Verify your Poe API credentials are correct
4. Telegram bot issues: Confirm your bot token and chat ID are valid

📝 Logs

• News monitoring logs: logs/Report-YYYY-MM-DD-HH-MM-SS.log
• Whale monitoring logs: logs/Report-WM-YYYY-MM-DD-HH-MM-SS.log
• General debug logs: logs/debug.log

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is licensed under the MIT License.