v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Reddit Stocks

Trending stocks

Returns the Reddit stocks with the strongest 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, upvotes and subreddit 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_posts, subreddit_count, total_upvotes: attributed volume and engagement signals, including inherited thread-context mentions
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

get/reddit/stocks/v1/trending

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

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

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

Example:stock

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

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, upvotes and subreddit breadth; not price movement. For from/to, anchors at to (or now when to is today).

mentionsinteger required

Total attributed mentions, including inherited thread-context mentions

unique_postsinteger required

Number of unique posts

subreddit_countinteger required

Number of subreddits 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

total_upvotesinteger required

Total upvotes across attributed 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,
    "unique_posts": 45,
    "subreddit_count": 8,
    "sentiment_score": 0.23,
    "bullish_pct": 45,
    "bearish_pct": 18,
    "total_upvotes": 15234,
    "trend_history": [
      45.2,
      52.1,
      48.7,
      67.3,
      72.1,
      78.4,
      87.5
    ]
  }
]