v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

News Stocks

Market Sentiment

Returns the service-level News market sentiment snapshot across all tracked stocks when you want a single News-wide market state instead of per-ticker rankings. It includes service-wide buzz, sentiment split, activity trend, breadth metrics and the top drivers by current buzz_score.

buzz_score here means relative News market heat, not pure bullishness. It measures how hot overall stock news flow is versus News' own trailing 90-day baseline:

around 50 = normal news activity
higher = broader coverage than usual
lower = quieter than usual

trend is activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions/articles and source breadth; not price movement. For from/to, anchors at to (or now when to is today).

Use sentiment_score, bullish_pct and bearish_pct for direction.

get/news/stocks/v1/market-sentiment

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

daysinteger

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

Response

Successful Response

buzz_scorenumber nullable required

Service-wide News heat score relative to the service's trailing 90-day baseline. Around 50 = normal coverage heat, higher values = hotter-than-usual coverage.

trend'rising' | 'falling' | 'stable' nullable

Activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions/articles and source breadth; not price movement. For from/to, anchors at to (or now when to is today).

mentionsinteger required

News mentions across the selected period

unique_articlesinteger required

Exact distinct article count across the selected UTC period

source_countinteger required

Exact distinct news-source breadth across the selected UTC period

active_tickersinteger required

Number of tickers with news activity in the selected period

sentiment_scorenumber nullable

Service-wide average news sentiment score

positive_countinteger required

Deprecated. Prefer bullish_pct with mentions for public analysis; retained for v1 compatibility.

negative_countinteger required

Deprecated. Prefer bearish_pct with mentions for public analysis; retained for v1 compatibility.

neutral_countinteger required

Deprecated. Prefer bullish_pct, bearish_pct and mentions for public analysis; retained for v1 compatibility.

bullish_pctinteger required

Bullish news mention percentage

bearish_pctinteger required

Bearish news mention percentage

trend_historynumber[]

Daily service-wide buzz scores (oldest→newest) using the same relative baseline calibration. Length = max(requested_days, 7) for successful requests; windows before platform availability return HTTP 422.

Example response

{
  "buzz_score": 53.8,
  "trend": "stable",
  "mentions": 1298,
  "unique_articles": 911,
  "source_count": 44,
  "active_tickers": 233,
  "sentiment_score": 0.064,
  "positive_count": 512,
  "negative_count": 308,
  "neutral_count": 478,
  "bullish_pct": 39,
  "bearish_pct": 24,
  "trend_history": [
    49.1,
    50.4,
    48.7,
    52.2,
    55.1,
    54.3,
    53.8
  ],
  "drivers": [
    {
      "ticker": "AAPL",
      "mentions": 87,
      "buzz_score": 69.7,
      "sentiment_score": 0.22
    },
    {
      "ticker": "NVDA",
      "mentions": 76,
      "buzz_score": 67.3,
      "sentiment_score": 0.31
    }
  ]
}