ADadanos
Reddit Stocks

Stock sentiment

Changed on

Returns the Reddit report for one stock ticker.

Includes:

  • buzz_score: normalized Reddit activity score for the selected period
  • 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, positive_count, negative_count, neutral_count: directional sentiment signals
  • mentions, unique_posts, subreddit_count, total_upvotes: attributed volume and engagement signals, including inherited thread-context mentions
  • daily_trend: daily Reddit activity and sentiment values
  • top_mentions: top explicit Reddit mentions from the selected period, ranked by upvotes
  • top_subreddits: top subreddit contributors by attributed mention count

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}

Request

  • Base URL
    https://api.adanos.com
  • Auth
    API key in header X-API-Key

Path parameters

tickerstring required

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

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.

Response

Successful Response

tickerstring required

Stock ticker symbol

company_namestring nullable

Company name (null if unknown)

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:00Z"
    }
  ]
}

Changes