v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB
Reddit Stocks

Compare stocks

Compare up to 10 stock or ETF tickers side by side over the same UTC calendar-day period.

Results are sorted by buzz_score descending and return the same core analytics used by /trending: buzz_score, trend, trend_history, mentions, unique_posts, subreddit_count, sentiment_score, bullish_pct, bearish_pct and total_upvotes. 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).

If a requested ticker is supported but has no qualifying data in the period, it is still returned with zeroed metrics.

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

get/reddit/stocks/v1/compare

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.

tickersstring required

Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)

Example:TSLA,NVDA,AMD

Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)

Response

Successful Response

period_daysinteger required

Analysis period in days

Example response

{
  "period_days": 7,
  "stocks": [
    {
      "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
      ]
    },
    {
      "ticker": "NVDA",
      "company_name": "NVIDIA Corporation",
      "buzz_score": 72.3,
      "trend": "stable",
      "mentions": 189,
      "unique_posts": 31,
      "subreddit_count": 6,
      "sentiment_score": 0.45,
      "bullish_pct": 52,
      "bearish_pct": 17,
      "total_upvotes": 8921,
      "trend_history": [
        38.1,
        40.7,
        44.9,
        51.5,
        57.4,
        63,
        72.3
      ]
    }
  ]
}