---
title: "Trending stocks"
method: GET
path: "/x/stocks/v1/trending"
tags: ["X/Twitter Stocks"]
---

# Trending stocks

`GET /x/stocks/v1/trending`

## Request

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

Returns the stocks with the strongest X/Twitter discussion 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, likes and author 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`, `unique_tweets`, `total_upvotes`: volume and engagement 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`

## 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.
- `limit` integer: Maximum stocks to return
- `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.

## Response `200`

Successful Response

- XTrendingStock[]
  - `ticker` string, required: Stock ticker symbol
  - `company_name` string, nullable: Company name
  - `buzz_score` number, nullable, required: Buzz score from tweet activity. Components: mentions (20), sentiment (20), quality (10), author diversity (14) and trend (-10 to +20). Asymptotic scaling caps at 100.
  - `trend` 'rising' | 'falling' | 'stable', required: Activity momentum over the current 3 UTC days vs previous 3 UTC days, not price movement.
  - `mentions` integer, required: Number of tweets mentioning the ticker
  - `sentiment_score` number, nullable: Average sentiment score from tweet analysis (-1 to +1)
  - `bullish_pct` integer, nullable: Percentage of bullish tweet mentions
  - `bearish_pct` integer, nullable: Percentage of bearish tweet mentions
  - `total_upvotes` integer, nullable: Total likes across all tweet mentions
  - `unique_tweets` integer, nullable: Number of unique tweets mentioning this ticker (distinct tweet_id)
  - `trend_history` number[]: Daily buzz scores (oldest→newest). Length follows the resolved period, with a minimum of 7 values. For live windows, the final value is the current live buzz_score; closed historical windows end at `to`.

## 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/x/stocks/v1/trending/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)