--- title: "Stock sentiment" method: GET path: "/x/stocks/v1/stock/{ticker}" tags: ["X/Twitter Stocks"] --- # Stock sentiment `GET /x/stocks/v1/stock/{ticker}` ## Request - Base URL: `https://api.adanos.com` - URL: `https://api.adanos.com/x/stocks/v1/stock/{ticker}` - Auth: API key in header `X-API-Key` Returns the X/Twitter report for one stock ticker. **Includes:** - `buzz_score`: normalized X/Twitter activity score for the selected period - `trend`: activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, likes and author breadth; not price movement. For `from`/`to`, anchors at `to` (or now when `to` is today) - `sentiment_score`, `bullish_pct`, `bearish_pct`: directional sentiment signals - `mentions`, `unique_tweets`, `total_upvotes`: volume and engagement signals - `daily_trend`: daily X/Twitter activity and sentiment values - `top_tweets`: representative high-engagement tweets from the selected period 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) ## 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 - XStockDetailResponse: Detailed X/Twitter data for a single stock, in the same format as the Reddit API. - `ticker` string, required: Stock ticker symbol - `company_name` string, nullable: Company name - `found` boolean: 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) from tweet activity, including author diversity (null if not found) - `mentions` integer, nullable: Total tweet mentions within the selected period - `sentiment_score` number, nullable: Average sentiment score from tweet analysis (-1 to +1) - `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 likes across all tweet mentions - `unique_tweets` integer, nullable: Number of unique tweets (distinct tweet_id) - `trend` 'rising' | 'falling' | 'stable', nullable: Activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, likes and author breadth; not price movement. For `from`/`to`, anchors at `to` (or now when `to` is today). - `bullish_pct` integer, nullable: Percentage of bullish tweet mentions - `bearish_pct` integer, nullable: Percentage of bearish tweet mentions - `period_days` integer, nullable: Analysis period in days - `daily_trend` XDailyTrendItem[], nullable: Daily mention breakdown for the selected period - `date` string, required: Date in YYYY-MM-DD format - `mentions` integer, required: Number of tweet mentions on this date - `sentiment_score` number, nullable: Average sentiment score for the day - `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 tweet percentage for this date, calculated from positive sentiment-classified tweets - `bearish_pct` integer, nullable: Bearish tweet percentage for this date, calculated from negative sentiment-classified tweets - `top_tweets` XTopTweet[], nullable: Top tweets from the selected period, ranked by engagement (likes + retweets) - `text_snippet` string, required: Clean tweet paragraph around the detected ticker mention (truncated to 280 chars for this view) - `sentiment_score` number, nullable: Sentiment score (-1 to +1) - `sentiment_label` string, nullable: Sentiment label (positive/negative/neutral) - `likes` integer, required: Number of likes - `retweets` integer, required: Number of retweets - `views` integer, nullable: Number of views - `author` string, nullable: Author username - `created_at` string, nullable: Tweet creation time (ISO 8601) - `top_authors` XTopAuthor[], nullable: Top X authors in the selected period with mentions, sentiment_score, buzz_score and deprecated count alias - `author` string, required: Public X/Twitter username - `mentions` integer, required: Tweet mentions by this author in the selected period - `sentiment_score` number, nullable: Average sentiment score for this author's mentions in the selected period - `buzz_score` number, nullable: Contributor-level buzz score for this author in the selected period - `count` integer, required: Deprecated alias for mentions. Use mentions instead. ## 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/x/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)