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

# Compare stocks

`GET /news/stocks/v1/compare`

## Request

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

Compare up to 10 companies side by side using news coverage.

Use it for watchlists: one compact row per ticker.
Results are sorted by `buzz_score` descending and include `trend`, `trend_history`, `source_count`, `sentiment_score`, `bullish_pct` and `bearish_pct`.
`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).
Each requested ticker gets one row. Tickers without activity in the period, including unsupported ones, return zeroed metrics. Unsupported tickers have no company name; use `/search` to check support.

## 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.
- `tickers` string, required: Comma-separated News tickers. News company key: 1-32 ASCII letters/digits with an optional documented venue suffix, case-insensitive. Examples: BRK, EADSY, ABX.DE. Share classes (BRK.A, BRK.B, BRK-B), hyphens, ampersands, cashtags and unknown suffixes return 422. A documented suffix resolves only if assigned to that issuer; other well-formed keys return 404 on individual endpoints. One issuer is one time series; ETFs stay separate issuers. Venue suffixes: .AE, .AS, .AT, .AX, .BA, .BD, .BK, .BO, .BR, .CA, .CL, .CN, .CO, .DE, .DU, .F, .HA, .HE, .HK, .HM, .IC, .IR, .IS, .JK, .JO, .KL, .KQ, .KS, .KW, .L, .LS, .MC, .MI, .MU, .MX, .NE, .NS, .NZ, .OL, .PA, .PR, .PS, .QA, .RO, .SA, .SAU, .SG, .SI, .SN, .SS, .ST, .SW, .SZ, .T, .TA, .TO, .TW, .TWO, .V, .VI, .VN, .WA. Unknown keys, ambiguous keys and known companies without activity return zero-activity entries; Compare does not distinguish these states.

## Response `200`

Successful Response

- NewsCompareResponse: Comparison of multiple stocks in news.
  - `period_days` integer, required: Analysis period in days
  - `stocks` NewsCompareStockItem[], required: Stocks sorted by buzz_score descending
    - `ticker` string, required: Stock ticker symbol
    - `company_name` string, nullable: Company or fund name from resolved instrument metadata or the Legacy reference
    - `buzz_score` number, nullable, required: Buzz Score (0-100). Asymptotic scaling above 50.
    - `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). Null when no qualifying news data exists.
    - `mentions` integer, required: Total mentions in period
    - `source_count` integer, required: Number of distinct news sources with mentions in period
    - `sentiment_score` number, nullable: Average sentiment (-1 to +1, null if no mentions)
    - `bullish_pct` integer, nullable: Percentage of bullish mentions
    - `bearish_pct` integer, nullable: Percentage of bearish mentions
    - `trend_history` number[]: Daily buzz scores (oldest→newest). Length follows the resolved period, with a minimum of 7 values when data exists. Empty when no qualifying data exists.

## Other responses

- `400`: Invalid compare item list
- `401`: Authentication failed
- `403`: Historical data limit exceeded
- `422`: Invalid period or query parameters
- `429`: Rate limit exceeded
- `503`: News identity lookup or database service unavailable; no Legacy fallback is used
- `504`: Analytics request deadline exceeded

## Changes

- **2026-09-30** `a74a23b969c4`: 1 info
  - deleted the `query` request parameter `days` with deprecation
- **2026-09-16** `a8567b417bda`: 1 info
  - for the `query` request parameter `tickers`, the maxLength was increased from `200` to `512`

[Operation history](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/changes/news/stocks/v1/compare/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)