Atomic Signal Modules

Overview

Atomic signal modules are the data ingestion and analysis layer of AIVEX. Each module:

Pulls data from external sources on a configurable schedule
Applies domain-specific analysis to produce a directional signal
Scores the signal with a confidence value
Writes the output to the shared database for the Signal Engine to consume

News Signal Module

Package: news/ Default interval: 60 seconds

The News module scrapes financial news from configured RSS feeds and APIs, then runs each article through an NLP pipeline to extract:

Sentiment: Positive / negative / neutral at the article level
Named entities: Company names, tickers, sectors
Event type: Earnings, M&A, regulatory, macro, etc.
Urgency: A 0–1 score indicating time-sensitivity

Configuration

Variable	Default	Description
`NEWS_INTERVAL`	`60`	Cycle interval in seconds
`NEWS_MIN_CONFIDENCE`	`0.3`	Minimum confidence to write to DB
`NEWS_LOOKBACK_HOURS`	`24`	How far back to consider articles as recent

Chart Signal Module

Package: chart/ Default interval: 300 seconds

The Chart module downloads OHLCV data and computes technical indicators. It analyzes:

Trend (moving averages, ADX)
Momentum (RSI, MACD, Stochastic)
Volume (OBV, VWAP divergence)
Volatility (Bollinger Bands, ATR)
Pattern recognition (support/resistance, breakouts)

Configuration

Variable	Default	Description
`CHART_INTERVAL`	`300`	Cycle interval in seconds
`CHART_LOOKBACK_DAYS`	`90`	Historical bars for indicator calculation
`CHART_TIMEFRAMES`	`1d,4h`	Comma-separated timeframes to analyze

Metrics Signal Module

Package: metrics/ Default interval: 3600 seconds

The Metrics module processes fundamental data:

Valuation ratios (P/E, P/B, EV/EBITDA)
Earnings data (EPS, revenue, guidance)
Analyst estimates and revisions
Sector-relative rankings

Because fundamental data changes slowly, this module runs on a longer cycle than News or Chart.

Configuration

Variable	Default	Description
`METRICS_INTERVAL`	`3600`	Cycle interval in seconds
`METRICS_MIN_CONFIDENCE`	`0.4`	Higher bar for fundamental signals

Signal Output Schema

All atomic modules write to the database with the following schema:

{
  "symbol": "AAPL",
  "module": "news",
  "direction": "bullish",
  "confidence": 0.72,
  "ts": "2024-02-01T14:30:00Z",
  "context": {
    "event_type": "earnings",
    "sentiment_score": 0.65,
    "article_count": 12
  }
}