v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

X/Twitter Stocks

Trending sectors

Returns the sectors with the strongest aggregated X/Twitter stock discussion 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 or Grok rank movement. For from/to, anchors at to (or now when to is today)
mentions, unique_tickers, total_upvotes: volume and engagement signals
sentiment_score, bullish_pct, bearish_pct: directional sentiment signals
top_tickers: up to 5 tickers driving the sector result
trend_history: independent daily sector buzz scores, oldest to newest; length is max(requested days, 7); the live final value describes today so far and can differ from period buzz_score

get/x/stocks/v1/trending/sectors

Query parameters

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

Example:10

Maximum number of results

offsetinteger

Number of items to skip for pagination

Response

Successful Response

buzz_scorenumber nullable required

Aggregated Buzz Score (0-100) from X mentions

trend'rising' | 'falling' | 'stable' required

Activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, likes and author breadth; not price movement or Grok rank movement. For from/to, anchors at to (or now when to is today).

mentionsinteger required

Total tweet mentions

unique_tickersinteger required

Number of unique tickers mentioned

unique_authorsinteger required

Exact distinct author breadth across the selected UTC period

sentiment_scorenumber nullable

Weighted average sentiment (-1 bearish to +1 bullish)

bullish_pctinteger nullable

Percentage of bullish mentions

bearish_pctinteger nullable

Percentage of bearish mentions

total_upvotesinteger nullable

Total likes across all mentions

trend_historynumber[] required

Daily dimension buzz scores (oldest to newest). Length follows the resolved period, with a minimum of 7 values. Every slot describes only its UTC calendar day. The live final value describes today so far and can differ from period buzz_score. Closed historical windows end at to. Historical author breadth is rebuilt from daily author_distribution where available and may conservatively approximate exact cross-ticker author de-duplication.

top_tickersstring[] required

Top 5 tickers by mention count in this dimension

sectorstring required

Industry sector name

Example response

[
  {
    "buzz_score": 78.4,
    "trend": "rising",
    "mentions": 4523,
    "unique_tickers": 34,
    "unique_authors": 156,
    "sentiment_score": 0.28,
    "bullish_pct": 54,
    "bearish_pct": 22,
    "total_upvotes": 128450,
    "trend_history": [
      45.2,
      48.1,
      52.3,
      55,
      58.2,
      61.5,
      78.4
    ],
    "top_tickers": [
      "NVDA",
      "AAPL",
      "MSFT",
      "AMD",
      "GOOGL"
    ],
    "sector": "Technology"
  }
]