---
title: "Trending stocks"
method: GET
path: "/news/stocks/v1/trending"
tags: ["News Stocks"]
---

# Trending stocks

`GET /news/stocks/v1/trending`

Returns the stocks with the strongest news coverage activity in the selected period, ranked by `buzz_score`.

**Includes:**
- `buzz_score`: normalized 0-100 activity score used for ranking
- `trend`: 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)
- `sentiment_score`, `bullish_pct`, `bearish_pct`: directional sentiment signals
- `mentions`, `source_count`: coverage volume and source breadth signals
- `trend_history`: independent UTC-day buzz scores, oldest to newest; minimum 7 values; the live final value describes today so far and can differ from the selected-period `buzz_score`; missing days are `0.0`

Use `source` only when you want the ranking filtered to one publisher or source family.

## 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.
- `days` integer — Deprecated v1 compatibility shorthand. Prefer `from` and `to` for reproducible UTC date windows.
- `limit` integer — Maximum number of results
- `offset` integer — Number of items to skip for pagination
- `type` 'stock' | 'etf' | 'all', nullable — Filter by asset type. Omit or use 'all' for all assets.
- `source` string, nullable — Optional source filter (strict canonical source id or known alias)

## Response `200`

Successful Response

- NewsTrendingStock[]
  - `ticker` string, required — Stock ticker symbol
  - `company_name` string, nullable — Company name from ticker_reference (null if not found)
  - `buzz_score` number, required — Buzz Score (0-100). Asymptotic scaling above 50.
  - `trend` 'rising' | 'falling' | 'stable', required — 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 — Total number of mentions
  - `source_count` integer, required — Number of distinct news sources with mentions
  - `sentiment_score` number, required — Average sentiment score (-1 bearish to +1 bullish)
  - `bullish_pct` integer, required — Percentage of bullish mentions
  - `bearish_pct` integer, required — Percentage of bearish mentions
  - `trend_history` number[] — Daily buzz scores (oldest→newest). Length follows the resolved period, with a minimum of 7 values. Values 0-100.

## Other responses

- `401` — Authentication failed
- `403` — Historical data limit exceeded
- `404` — No trending stocks found
- `422` — Invalid period or query parameters
- `429` — Rate limit exceeded
- `503` — Database temporarily unavailable
- `504` — Analytics request deadline exceeded

---

[API](https://skmtc.net/adanos/apis/adanos-market-sentiment-api.md) · [All operations](https://skmtc.net/adanos/apis/adanos-market-sentiment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adanos/adanos-market-sentiment-api/revisions/351caf64ba81/schema)