How chopra2007/openclaw--stockticker-signals-discord-bot works
Stock Signals is a self-hosted stock-research and Discord alert system. Its principal workflow is to receive an analyst or scanner signal, send a fast alert, then gather independent research and deliver supporting evidence; saved alert outcomes power performance and ranking commands. The graph also preserves the documented whole-market, options, video, and health capabilities. Relationships rely on README workflow statements and SOURCE INDEX references; unsampled subsystems are represented at their listed directory paths.
Main entry points: main.py Signal Engine · cross_reference.py Cross-Source Research · commands.py Discord Commands · llm_client.py LLM Fallback Client
Components 24
Signal Intake
- Market Scanners
consensus_engine/scanners - YouTube Research
consensus_engine/scanners/youtube.py - Signal Engine
consensus_engine/main.py
Research And Scoring
- Cross-Source Research
consensus_engine/cross_reference.py - Technical Analysis
consensus_engine/analysis/technical.py - Options Intelligence
consensus_engine/scanners/options.py - SEC Filings
consensus_engine/scanners/sec_edgar.py - Precision Scoring
consensus_engine/engine.py - All-Source Summary
consensus_engine/alerts/all_command/aggregator.py - LLM Fallback Client
consensus_engine/llm_client.py
Discord Experience
- Two-Phase Alerts
consensus_engine/alerts/discord.py - Discord Commands
consensus_engine/alerts/commands.py - Market Briefing
consensus_engine/briefing/alfred.py
Outcomes And Health
- SQLite State
consensus_engine/db.py - Alert Measurement
consensus_engine/measurement.py - Source Health
consensus_engine/health.py
Shared Foundation
- Configuration
consensus_engine/config.py - Signal Models
consensus_engine/models.py - HTTP Session
consensus_engine/utils/http.py - Rate Limiting
consensus_engine/utils/rate_limiter.py
Other components
- Analyst Feed
- Discord
- External Market Sources
- Model Providers
Connections 29
- Analyst Feed → Signal Engine: submits calls
README.md - Market Scanners → Signal Engine: provides signals
README.md - YouTube Research → Signal Engine: provides calls
README.md - Signal Engine → Two-Phase Alerts: sends fast alert
README.md - Signal Engine → Cross-Source Research: starts cross-check
README.md - Cross-Source Research → Technical Analysis: gathers analysis
consensus_engine/cross_reference.py - Cross-Source Research → Options Intelligence: gathers options
consensus_engine/cross_reference.py - Cross-Source Research → SEC Filings: gathers filings
consensus_engine/cross_reference.py - Signal Engine → Precision Scoring: scores signals
consensus_engine/main.py - Cross-Source Research → Two-Phase Alerts: supplies follow-up
README.md - All-Source Summary → LLM Fallback Client: synthesizes research
consensus_engine/alerts/all_command/aggregator.py - Discord Commands → All-Source Summary: routes !all
consensus_engine/alerts/commands.py - Discord Commands → Cross-Source Research: routes on-demand scan
consensus_engine/alerts/commands.py - Market Briefing → Two-Phase Alerts: delivers briefing
consensus_engine/briefing/alfred.py - Signal Engine → Alert Measurement: records outcomes
consensus_engine/main.py - Alert Measurement → SQLite State: stores results
consensus_engine/db.py - Discord Commands → SQLite State: reads performance
consensus_engine/alerts/commands.py - Discord Commands → Source Health: reports freshness
consensus_engine/alerts/commands.py - Signal Engine → Configuration: loads settings
consensus_engine/main.py - Signal Engine → Signal Models: uses signal types
consensus_engine/main.py - Cross-Source Research → SQLite State: reads stored data
consensus_engine/cross_reference.py - Technical Analysis → HTTP Session: fetches data
consensus_engine/analysis/technical.py - SEC Filings → HTTP Session: fetches filings
consensus_engine/scanners/sec_edgar.py - SEC Filings → Rate Limiting: limits requests
consensus_engine/scanners/sec_edgar.py - LLM Fallback Client → HTTP Session: posts completions
consensus_engine/llm_client.py - LLM Fallback Client → Rate Limiting: paces providers
consensus_engine/llm_client.py - Two-Phase Alerts → Discord: posts alerts
README.md - Market Scanners → External Market Sources: reads feeds
README.md - LLM Fallback Client → Model Providers: requests completions
consensus_engine/llm_client.py