Sign in

v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB
Reddit Stocks

Stock Sentiment

Returns detailed sentiment analysis for a specific stock ticker.

Includes:

  • Buzz score (0-100)
  • Trend direction 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 breakdown (positive/negative/neutral)
  • Daily trend data
  • top_mentions: top explicit Reddit mentions from the selected period, ranked by upvotes
  • top_subreddits: top subreddit contributors by attributed mention count

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

Returns 200 with found: false when the ticker is supported but this service has no qualifying data in the requested window. Returns 404 only when the ticker is unsupported.

get/reddit/stocks/v1/stock/{ticker}

Path parameters

tickerstring required

Stock ticker symbol (e.g., TSLA, aapl, BRK.A, $GME)

Stock ticker symbol (e.g., TSLA, aapl, BRK.A, $GME)

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

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.

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.

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

Response

Successful Response

tickerstring required

Stock ticker symbol

company_namestring nullable

Company name from ticker_reference (null if not found)

foundboolean required

Legacy v1 data-availability flag. true means this service has qualifying data for this asset/window. false means the asset is supported, but this service has no qualifying data for the requested window. Planned for removal in v2.

buzz_scorenumber nullable

Buzz Score (0-100). Asymptotic scaling above 50.

mentionsinteger nullable

Total attributed mentions in the selected period, including inherited thread-context mentions

sentiment_scorenumber nullable

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

positive_countinteger nullable

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

negative_countinteger nullable

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

neutral_countinteger nullable

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

total_upvotesinteger nullable

Total upvotes across attributed mentions

unique_postsinteger nullable

Number of unique posts

subreddit_countinteger nullable

Number of subreddits with mentions

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

bullish_pctinteger nullable

Percentage of bullish mentions

bearish_pctinteger nullable

Percentage of bearish mentions

period_daysinteger nullable

Analysis period in days

Example response

{
  "ticker": "TSLA",
  "company_name": "Tesla, Inc.",
  "found": true,
  "buzz_score": 87.5,
  "mentions": 342,
  "sentiment_score": 0.23,
  "total_upvotes": 15234,
  "unique_posts": 45,
  "subreddit_count": 8,
  "trend": "rising",
  "bullish_pct": 45,
  "bearish_pct": 18,
  "period_days": 7,
  "top_subreddits": [
    {
      "subreddit": "wallstreetbets",
      "mentions": 89,
      "count": 89
    },
    {
      "subreddit": "stocks",
      "mentions": 67,
      "count": 67
    }
  ],
  "daily_trend": [
    {
      "date": "2025-12-28",
      "mentions": 52,
      "sentiment_score": 0.31,
      "buzz_score": 42.8,
      "bullish_pct": 58,
      "bearish_pct": 19
    },
    {
      "date": "2025-12-27",
      "mentions": 48,
      "sentiment_score": 0.18,
      "buzz_score": 38.5,
      "bullish_pct": 46,
      "bearish_pct": 21
    }
  ],
  "top_mentions": [
    {
      "text_snippet": "TSLA looking strong after...",
      "sentiment_score": 0.85,
      "sentiment_label": "positive",
      "upvotes": 1234,
      "subreddit": "wallstreetbets",
      "created_utc": "2025-12-28T10:30:00"
    }
  ]
}