---
title: "Market sentiment"
method: GET
path: "/news/stocks/v1/market-sentiment"
tags: ["News Stocks"]
---

# Market sentiment

`GET /news/stocks/v1/market-sentiment`

## Request

- Base URL: `https://api.adanos.com`
- URL: `https://api.adanos.com/news/stocks/v1/market-sentiment`
- Auth: API key in header `X-API-Key`

Returns one reading for all stock news coverage: overall buzz, sentiment split, activity trend, breadth and the `drivers` behind it, ranked by `buzz_score`.

Here `buzz_score` compares overall stock news flow with its 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.

## Query parameters

- `from` string, date, nullable: Start date in YYYY-MM-DD. Inclusive UTC date.
- `to` string, date, nullable: End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

## Response `200`

Successful Response

- NewsMarketSentimentResponse: Service-level News market sentiment across all tracked stocks.
  - `buzz_score` number, 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).
  - `mentions` integer, required: News mentions across the selected period
  - `unique_articles` integer, required: Exact distinct article count across the selected UTC period
  - `source_count` integer, required: Exact distinct news-source breadth across the selected UTC period
  - `active_tickers` integer, required: Number of tickers with news activity in the selected period
  - `sentiment_score` number, nullable: Service-wide average news sentiment score
  - `positive_count` integer, required: Deprecated. Prefer bullish_pct with mentions for public analysis; retained for v1 compatibility.
  - `negative_count` integer, required: Deprecated. Prefer bearish_pct with mentions for public analysis; retained for v1 compatibility.
  - `neutral_count` integer, required: Deprecated. Prefer bullish_pct, bearish_pct and mentions for public analysis; retained for v1 compatibility.
  - `bullish_pct` integer, required: Bullish news mention percentage
  - `bearish_pct` integer, required: Bearish news mention percentage
  - `trend_history` number[]: 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.
  - `drivers` NewsMarketSentimentDriver[]: Top 5 stocks of the selected period by buzz_score. mentions and sentiment_score cover every day of the period.
    - `ticker` string, required: Stock ticker symbol
    - `mentions` integer, required: News mentions in the selected period
    - `buzz_score` number, nullable, required: Asset buzz score in the selected period
    - `sentiment_score` number, nullable: Average news sentiment score for this asset

## Other responses

- `401`: Authentication failed
- `403`: Historical data limit exceeded
- `422`: Invalid period or query parameters
- `429`: Rate limit exceeded
- `503`: Database temporarily unavailable
- `504`: Analytics request deadline exceeded

## Changes

- **2026-09-30** `a74a23b969c4`: 1 info
  - deleted the `query` request parameter `days` with deprecation

[Operation history](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/changes/news/stocks/v1/market-sentiment/get.md)

---

[API](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)