X.com Stock Sentiment API
The X.com Market Sentiment API tracks public stock-market conversations from X.com and turns them into structured market signals. Use it to discover stocks getting unusual attention, validate watchlists against social momentum, compare tickers, inspect sector or country-level discussion, and drill into raw mention rows on eligible plans. Core endpoints: - `/trending` ranks stocks by Adanos buzz…
X.com Stock Sentiment API endpoints
| Method | Endpoint | Description |
|---|---|---|
| X/Twitter Stocks | ||
| GET |
getXTrendingSectors /trending/sectors |
Returns sectors with highest aggregated buzz on X/Twitter, ranked by buzz score. **Aggregation**: Combines all tweet mentions per sector from ticker_reference. **Buzz score**… |
| GET |
searchXStocks /search |
Search for stocks by ticker symbol or company name. Results sorted by X mention_count descending. |
| GET |
getXTrendingStocks /trending |
Returns stocks with highest buzz on X/Twitter, ranked by buzz score. **Buzz score** (V5.4) combines: - Mention volume (from tweets) - Sentiment score - Engagement (likes) -… |
| GET |
compareXStocks /compare |
Compare sentiment metrics for up to 10 stocks side by side using X/Twitter data. |
| GET |
getXTrendingCountries /trending/countries |
Returns countries with highest aggregated buzz on X/Twitter, ranked by buzz score. **Aggregation**: Combines all tweet mentions per country from ticker_reference. **Buzz score**… |
| GET |
getXStockSentiment /stock/{ticker} |
Returns detailed X/Twitter data for a specific ticker. **Response includes:** - `buzz_score`: V5.4 score from tweet data (mentions, sentiment, likes, diversity) -… |
| Other endpoints | ||
| GET |
getXTrendingStocks /trending |
Returns stocks with highest buzz on X/Twitter, ranked by buzz score. **Buzz score** (V5.4) combines: - Mention volume (from tweets) - Sentiment score - Engagement (likes) -… |
| GET |
getXTrendingSectors /trending/sectors |
Returns sectors with highest aggregated buzz on X/Twitter, ranked by buzz score. **Aggregation**: Combines all tweet mentions per sector from ticker_reference. **Buzz score**… |
| GET |
getXTrendingCountries /trending/countries |
Returns countries with highest aggregated buzz on X/Twitter, ranked by buzz score. **Aggregation**: Combines all tweet mentions per country from ticker_reference. **Buzz score**… |
| GET |
getXStockSentiment /stock/{ticker} |
Returns detailed X/Twitter sentiment analysis for a specific stock ticker. **Includes:** - Buzz score (0-100) from real tweet data - Sentiment breakdown… |
| GET |
compareXStocks /compare |
Compare sentiment metrics for up to 10 stocks side by side using X/Twitter data. |
| GET |
searchXStocks /search |
Search for stocks by ticker symbol or company name. Results are sorted by X mention_count descending (most discussed stocks first). |
| GET |
getXStockSentiment /stock/{ticker} |
Returns detailed X/Twitter data for a specific ticker. **Response includes:** - `buzz_score`: V5.5 score from tweet data (mentions, sentiment, likes, diversity) - `trend`:… |
| GET |
searchXStocks /search |
Search for stocks by ticker symbol, company name, or alias in the X/Twitter universe. Results prioritize match relevance first (exact ticker matches, then prefixes, then… |
| GET |
getXTrendingCountries /trending/countries |
Returns countries with highest aggregated buzz on X/Twitter, ranked by buzz score. **Aggregation**: Combines all tweet mentions per country from ticker_reference. **Trend**:… |
| GET |
compareXStocks /compare |
Compare up to 10 stocks side by side using X/Twitter metrics over the same UTC calendar-day period. Results are sorted by `buzz_score` descending and return the same core… |
| GET |
getXTrendingStocks /trending |
Returns stocks with highest buzz on X/Twitter, ranked by buzz score. **Buzz score** (V5.5) combines: - Mention volume (from tweets) - Sentiment score - Engagement (likes) -… |
| GET |
getXStockRawMentions /stock/{ticker}/mentions |
Returns raw tweet rows for a specific ticker within the live raw-data retention window. **Professional account required.** Free and Hobby accounts cannot use this endpoint. **Use… |
| GET |
getXStockExplanation /stock/{ticker}/explain |
Returns an AI-generated explanation for why a stock is trending on X/Twitter. **Features:** - Uses the same cached explanation pipeline as Reddit and News - Cached for 6 hours to… |
| GET |
getXMarketSentiment /market-sentiment |
Returns the service-level X/Twitter market sentiment snapshot across all tracked stocks. Use this endpoint when you want a single X-wide market state instead of per-ticker… |
| GET |
getXTrendingSectors /trending/sectors |
Returns sectors with highest aggregated buzz on X/Twitter, ranked by buzz score. **Aggregation**: Combines all tweet mentions per sector from ticker_reference. **Trend**:… |
X.com Stock Sentiment API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 100 / minute |
|
| PRO | $19.99 / month | 1000 / minute |
|
| ULTRA Recommended | $250 / month | 1000 / minute |
|