v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Reddit Stocks

Market Sentiment

Returns the service-level Reddit market sentiment snapshot across all tracked stocks when you want a single Reddit-wide market state instead of per-ticker rankings. It includes service-wide buzz, sentiment split, activity trend, breadth metrics and the top drivers by current buzz_score.

buzz_score here means relative Reddit market heat, not pure bullishness. It measures how hot overall Reddit stock activity is versus Reddit's own trailing 90-day baseline:

around 50 = normal Reddit market activity
higher = more active than usual
lower = quieter than usual

trend is 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).

Use sentiment_score, bullish_pct and bearish_pct for direction.

mentions includes inherited thread-context mentions. Use raw /mentions without include_inherited for explicit-only rows.

get/reddit/stocks/v1/market-sentiment

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.

Response

Successful Response

buzz_scorenumber nullable required

Service-wide Reddit heat score relative to the service's trailing 90-day baseline. Around 50 = normal activity, higher values = hotter-than-usual service activity.

trend'rising' | 'falling' | 'stable' nullable

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 Reddit mentions across the selected period, including inherited thread-context mentions

unique_postsinteger required

Exact distinct Reddit post count across the selected UTC period

subreddit_countinteger required

Distinct subreddits contributing in the selected period

total_upvotesinteger required

Total upvotes across attributed mentions in the selected period

active_tickersinteger required

Number of tickers with qualifying attributed Reddit activity in the selected period

sentiment_scorenumber nullable

Service-wide average sentiment score across all qualifying mentions in the selected period

positive_countinteger required

Deprecated. Prefer bullish_pct with mentions for public analysis; retained for v1 compatibility.

negative_countinteger required

Deprecated. Prefer bearish_pct with mentions for public analysis; retained for v1 compatibility.

neutral_countinteger required

Deprecated. Prefer bullish_pct, bearish_pct and mentions for public analysis; retained for v1 compatibility.

bullish_pctinteger required

Bullish mention percentage

bearish_pctinteger required

Bearish mention percentage

trend_historynumber[]

Daily service-wide buzz scores (oldest→newest) using the same relative baseline calibration. Length = max(requested_days, 7) for successful requests; windows before platform availability return HTTP 422.

Example response

{
  "buzz_score": 57.4,
  "trend": "stable",
  "mentions": 3992,
  "unique_posts": 418,
  "subreddit_count": 21,
  "total_upvotes": 15234,
  "active_tickers": 1000,
  "sentiment_score": 0.045,
  "positive_count": 1440,
  "negative_count": 998,
  "neutral_count": 1554,
  "bullish_pct": 36,
  "bearish_pct": 25,
  "trend_history": [
    49.8,
    52.1,
    50.7,
    55.6,
    58.3,
    60.2,
    57.4
  ],
  "drivers": [
    {
      "ticker": "SPY",
      "mentions": 129,
      "buzz_score": 74.1,
      "sentiment_score": 0.009
    },
    {
      "ticker": "GOOGL",
      "mentions": 106,
      "buzz_score": 71.8,
      "sentiment_score": 0.029
    }
  ]
}