Real-time Stock Signal System

A comprehensive real-time stock monitoring and alert system that scans U.S. markets and sends filtered alerts to three specialized Telegram channels.

🎯 Overview

This system monitors U.S. stock markets during trading hours and sends intelligent alerts to three specialized Telegram channels:

• 🔥 Channel 1 - Liquidity Radar: Halal stocks with volume spikes and price movements
• 🔬 Channel 2 - Microscope Picks: Technical rebound setups with RSI analysis
• 💎 Channel 3 - Smart Investing: Long-term dividend-paying stocks

✨ Features

Core Functionality

• Real-time Data Fetching: TwelveData and EOD Historical Data APIs
• Intelligent Filtering: Three distinct channel-specific filtering rules
• Automated Scheduling: Runs during U.S. pre-market hours (11:00 AM - 11:00 PM KSA)
• Duplicate Prevention: SQLite database with 30-minute cooldown system
• Rate Limiting: Configurable alerts per hour/day per channel
• Heartbeat Monitoring: 30-minute system health checks

Technical Analysis

• Volume Spike Detection: Monitors sudden volume increases
• RSI Calculations: 5-minute and 1-hour candle analysis
• Price Movement Tracking: Real-time price change monitoring
• Financial Health Screening: Cash vs debt ratio analysis
• Dividend Stock Identification: For long-term investment signals

Channel-Specific Rules

Channel 1 - Liquidity Radar

• Halal stocks only (with manual exceptions: MLGO, JFBR)
• Volume spike ≥2x normal + ≥1.5% price movement
• Stocks ≤ $10
• Liquidity boost alerts (+25%)
• Exit alerts (-15%, -25%)
• Max 10 alerts/hour

Channel 2 - Microscope Picks

• All Channel 1 filters + RSI ≤ 30 (5-min candles)
• Technical rebound setup indicators
• Positive cash flow requirement (Cash > Debt)
• Positive profit margin requirement
• Max 5 alerts/hour

Channel 3 - Smart Investing

• Dividend-paying stocks (≥1% yield)
• Stocks ≤ $20
• 1-hour candle analysis for long-term entries
• Minimum analyst rating ≥ 3.0/5
• Max 3 alerts/hour

🚀 Installation & Setup

Prerequisites

• Python 3.8+
• Linux VPS or local environment
• API keys for TwelveData and EOD Historical Data
• Telegram Bot Token and Channel IDs

Environment Variables

Create a .env file with the following variables:

# API Keys
TWELVEDATA_API_KEY=your_twelvedata_api_key
EOD_API_KEY=your_eod_api_key

# Telegram Configuration
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_CHANNEL_1_ID=your_channel_1_id
TELEGRAM_CHANNEL_2_ID=your_channel_2_id
TELEGRAM_CHANNEL_3_ID=your_channel_3_id