--- title: "Stock sentiment" method: GET path: "/reddit/stocks/v1/stock/{ticker}" tags: ["Reddit Stocks"] --- # Stock sentiment `GET /reddit/stocks/v1/stock/{ticker}` ## Request - Base URL: `https://api.adanos.com` - URL: `https://api.adanos.com/reddit/stocks/v1/stock/{ticker}` - Auth: API key in header `X-API-Key` 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. ## Path parameters - `ticker` string, required: Stock ticker symbol (e.g., TSLA, aapl, BRK.A, $GME) ## Query parameters - `from` string, date, nullable: Start date in YYYY-MM-DD. Inclusive UTC date. - `to` string, date, nullable: End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date. ## Response `200` Successful Response - StockSentiment: Detailed sentiment analysis for a specific stock ticker. - `ticker` string, required: Stock ticker symbol - `company_name` string, nullable: Company name (null if unknown) - `found` boolean, 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_score` number, nullable: Buzz Score (0-100). Asymptotic scaling above 50. - `mentions` integer, nullable: Total attributed mentions in the selected period, including inherited thread-context mentions - `sentiment_score` number, nullable: Average sentiment score (-1 bearish to +1 bullish) - `positive_count` integer, nullable: Deprecated. Prefer bullish_pct with mentions for public analysis; retained for v1 compatibility. - `negative_count` integer, nullable: Deprecated. Prefer bearish_pct with mentions for public analysis; retained for v1 compatibility. - `neutral_count` integer, nullable: Deprecated. Prefer bullish_pct, bearish_pct and mentions for public analysis; retained for v1 compatibility. - `total_upvotes` integer, nullable: Total upvotes across attributed mentions - `unique_posts` integer, nullable: Number of unique posts - `subreddit_count` integer, 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_pct` integer, nullable: Percentage of bullish mentions - `bearish_pct` integer, nullable: Percentage of bearish mentions - `period_days` integer, nullable: Analysis period in days - `top_subreddits` SubredditCount[], nullable: Top subreddits by attributed mention count - `subreddit` string, required: Subreddit name - `mentions` integer, required: Attributed mentions in this subreddit - `sentiment_score` number, nullable: Average sentiment score for this subreddit in the selected period - `buzz_score` number, nullable: Contributor-level buzz score for this subreddit in the selected period - `count` integer, required: Deprecated alias for mentions. Use mentions instead. - `daily_trend` DailyTrendItem[], nullable: Daily attributed mention breakdown for the selected period, with sentiment and buzz_score - `date` string, date, required: Date in YYYY-MM-DD format - `mentions` integer, required: Attributed mention count for this date, including inherited thread-context mentions - `sentiment_score` number, nullable: Average sentiment score for this date - `buzz_score` number, nullable: Buzz score for this date (0-100); null until the day is aggregated, while the activity fields are already filled - `bullish_pct` integer, nullable: Bullish mention percentage for this date, calculated from positive sentiment-classified mentions - `bearish_pct` integer, nullable: Bearish mention percentage for this date, calculated from negative sentiment-classified mentions - `top_mentions` TopMention[], nullable: Top explicit mentions from the selected period, ranked by upvotes - `text_snippet` string, required: Clean Reddit paragraph around the detected ticker mention (up to 500 chars) - `sentiment_score` number, required: Sentiment score (-1 to +1) - `sentiment_label` string, required: Sentiment label (positive/negative/neutral) - `upvotes` integer, required: Number of upvotes - `subreddit` string, required: Source subreddit - `created_utc` string, date-time, required: UTC timestamp of creation (ISO 8601) ## Other responses - `401`: Authentication failed - `403`: Historical data limit exceeded - `404`: Unsupported ticker - `422`: Invalid period or query parameters - `429`: Rate limit exceeded - `503`: Database temporarily unavailable - `504`: Analytics request deadline exceeded ## Changes - **2026-09-30** `a74a23b969c4`: 1 info - deleted the `query` request parameter `days` with deprecation [Operation history](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/changes/reddit/stocks/v1/stock/:ticker/get.md) --- [API](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)