Skip to content
StatAlphaDocumentation

News Reaction Intelligence

Status: Experimental. Confidence: Low. This module is research-grade and not a final production signal.

News Reaction Intelligence compares classified news sentiment with subsequent market price reactions. The analysis is experimental and is not a trading signal.

Use event_source=sentiment for supported equity and ETF news and event_source=sentiment_crypto for supported crypto news. The default is sentiment; choose the crypto source explicitly for crypto symbols. Coverage can differ by symbol and period.

Sentiment answers what the headline implies before looking at price action:

  • negative
  • neutral
  • positive
  • impact_score from 0.0 to 1.0

Market reaction answers what price actually did after the classified news timestamp. StatAlpha calculates post-news returns over:

  • 5 minutes
  • 15 minutes
  • 30 minutes
  • 60 minutes
  • end of day, when same-day bars exist

For intraday windows, StatAlpha uses the first available bar at or after the news timestamp as the baseline and the first available bar at or shortly after each target window. Missing bars produce null reaction values instead of failing the response.

The reaction returns and alignment labels describe observed price behavior; they do not establish that the news caused the movement.

The reaction layer compares the classified sentiment with the 60-minute market reaction:

  • aligned_positive: positive sentiment followed by an upward move
  • bearish_divergence: positive sentiment followed by a downward move
  • aligned_negative: negative sentiment followed by a downward move
  • bullish_absorption: negative sentiment followed by an upward move
  • neutral_or_unclear: neutral sentiment, flat price reaction, or missing bars
Endpoint Description
GET /stats/news/reactions Event-level classified news and post-news reaction windows
GET /stats/news/reactions/summary Aggregated reaction metrics for the selected symbol and period

Common parameters:

  • symbol
  • event_source
  • time_window
  • start_date / end_date
  • direction
  • min_impact_score
  • limit

Examples:

/stats/news/reactions?symbol=AAPL&event_source=sentiment&time_window=6M
/stats/news/reactions?symbol=BTCUSD&event_source=sentiment_crypto&time_window=6M
{
"symbol": "AAPL",
"event_source": "sentiment",
"time_window": "12M",
"reaction_windows": ["5m", "15m", "30m", "60m", "eod"],
"events": [
{
"event_source": "sentiment",
"asset_class": "equity",
"event_timestamp": "2025-09-12T14:30:00+00:00",
"title": "AAPL shares rise after product launch",
"headline": "AAPL shares rise after product launch",
"direction": "positive",
"impact_score": 0.72,
"reactions": {
"5m": {"return_pct": 0.18, "direction": "up", "absolute_move_pct": 0.18},
"60m": {"return_pct": 0.64, "direction": "up", "absolute_move_pct": 0.64}
},
"reaction_alignment": "aligned_positive",
"sentiment_reaction_alignment_score": 0.66,
"impact_realization_score": 0.6,
"absorption_score": null
}
]
}
{
"symbol": "AAPL",
"event_source": "sentiment",
"summary": {
"total_news_events": 42,
"average_impact_score": 0.58,
"dominant_sentiment": "positive",
"average_return_5m": 0.04,
"average_return_15m": 0.08,
"average_return_30m": 0.11,
"average_return_60m": 0.15,
"aligned_count": 21,
"divergence_count": 9,
"bullish_absorption_count": 4,
"bearish_divergence_count": 5,
"average_alignment_score": 0.61,
"average_impact_realization_score": 0.74
}
}