Trending stocks

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.

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.

limitinteger

Maximum number of results

offsetinteger

Number of items to skip for pagination

type'stock' | 'etf' | 'all' nullable

Filter by asset type. Omit or use 'all' for all assets.

sourcestring nullable

Optional source filter (strict canonical source id or known alias)

Response

Successful Response

tickerstring required

Stock ticker symbol

company_namestring nullable

Company name from ticker_reference (null if not found)

buzz_scorenumber 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).

mentionsinteger required

Total number of mentions

source_countinteger required

Number of distinct news sources with mentions

sentiment_scorenumber required

Average sentiment score (-1 bearish to +1 bullish)

bullish_pctinteger required

Percentage of bullish mentions

bearish_pctinteger required

Percentage of bearish mentions

trend_historynumber[]

Daily buzz scores (oldest→newest). Length follows the resolved period, with a minimum of 7 values. Values 0-100.

Example response

[
  {
    "ticker": "TSLA",
    "company_name": "Tesla, Inc.",
    "buzz_score": 87.5,
    "trend": "rising",
    "mentions": 342,
    "source_count": 8,
    "sentiment_score": 0.23,
    "bullish_pct": 45,
    "bearish_pct": 18,
    "trend_history": [
      45.2,
      52.1,
      48.7,
      67.3,
      72.1,
      78.4,
      87.5
    ]
  }
]

v1

Trending stocks

Query parameters

Response

Example response