Stock sentiment API for traders and fintech apps. Track X buzz scores, mentions, trend direction, and cross-platform validation. Spot trending tickers before the market moves.
| # | Ticker | Company | Buzz | Mentions | Bullish | Trend |
|---|---|---|---|---|---|---|
| Loading trending stocks... | ||||||
The Trending API allows developers and traders to retrieve all trending tickers, sectors & countries.
Traders share ideas across thousands of accounts. Trending tickers surface and fade within hours. Scanning cashtags and influencer posts takes time and you still miss signals from smaller accounts.
Thousands of FinTwit accounts posting daily. Impossible to track manually.
Hype, bots, and duplicate posts make raw cashtag counts unreliable.
You need a single score to compare $TSLA buzz vs $PLTR buzz objectively.
REST endpoints that fit into any trading workflow. Grok-powered analysis from X with cross-platform Reddit validation.
Grok analysis fetched hourly from X. Trends calculated on rolling 24h windows.
Tickers trending on both X and Reddit are flagged for higher confidence signals.
Grok ranking, mention frequency, and trend momentum combined into one 0-100 score.
Integrate X/Twitter trending data into your trading algorithms, dashboards, or research tools. Our API provides clean, structured data updated every 60 minutes.
Fill out the form below. We'll send you a secure link to retrieve your API key.
RESTful JSON API. All requests require authentication via X-API-Key header. View full documentation → · BuzzScore Whitepaper →
https://api.adanos.org/x/stocks
X-API-Key: sk_live_...
/v1/trending
Returns trending stocks from X/Twitter based on Grok analysis, ranked by buzz score.
days | Time period in days (1-30 free, 1-90 paid; default: 1) |
limit | Maximum results (1-100, default: 20) |
offset | Skip first N results for pagination (default: 0) |
type | Filter by asset type: stock, etf, or all (default: all) |
[
{
"ticker": "TSLA",
"company_name": "Tesla, Inc.",
"buzz_score": 100,
"trend": "rising",
"mentions": 4,
"sentiment_score": 0.45,
"bullish_pct": 72,
"bearish_pct": 12,
"total_upvotes": 8420,
"unique_tweets": 847,
"is_validated": true,
"trend_history": [92.0, 95.0, 97.0, 98.0, 99.0, 100.0, 100.0]
}
]ticker | Stock ticker symbol |
company_name | Company name (null if not found) |
buzz_score | Buzz score (0-100) based on mentions, sentiment, quality, and trend |
trend | rising, falling, or stable (rolling 24h window) |
mentions | Number of fetches where ticker appeared |
sentiment_score | Average sentiment (-1 to +1, null if unavailable) |
bullish_pct | Percentage of bullish mentions (0-100, null if unavailable) |
bearish_pct | Percentage of bearish mentions (0-100, null if unavailable) |
total_upvotes | Total upvotes/likes (null if unavailable) |
unique_tweets | Number of unique tweets (null if unavailable) |
is_validated | Also trending on Reddit (cross-platform validation) |
trend_history | Array of daily buzz scores (oldest to newest, 7 days) |
/v1/trending/sectors
Returns sectors with highest aggregated buzz on X/Twitter, ranked by buzz score. Combines all stock mentions per sector and includes the top 5 tickers per sector.
days | Time period in days (1-30 free, 1-90 paid; default: 1) |
limit | Maximum results (1-100, default: 20) |
offset | Skip first N results for pagination (default: 0) |
[
{
"sector": "Technology",
"buzz_score": 78.4,
"trend": "rising",
"mentions": 4523,
"unique_tickers": 34,
"sentiment_score": 0.28,
"bullish_pct": 54,
"bearish_pct": 22,
"total_upvotes": 128450,
"top_tickers": ["NVDA", "AAPL", "MSFT", "AMD", "GOOGL"]
}
]sector | Industry sector name |
buzz_score | Aggregated buzz score (0-100) |
trend | rising, falling, or stable |
mentions | Total mentions across all tickers in sector |
unique_tickers | Number of unique tickers mentioned |
sentiment_score | Weighted average sentiment (-1 to +1) |
bullish_pct | Percentage of bullish mentions |
bearish_pct | Percentage of bearish mentions |
total_upvotes | Total likes across all mentions |
top_tickers | Top 5 tickers by mention count |
/v1/trending/countries
Returns countries with highest aggregated buzz on X/Twitter, ranked by buzz score. Combines all stock mentions per country and includes the top 5 tickers per country.
days | Time period in days (1-30 free, 1-90 paid; default: 1) |
limit | Maximum results (1-100, default: 20) |
offset | Skip first N results for pagination (default: 0) |
[
{
"country": "United States",
"buzz_score": 82.3,
"trend": "stable",
"mentions": 8934,
"unique_tickers": 156,
"sentiment_score": 0.21,
"bullish_pct": 48,
"bearish_pct": 26,
"total_upvotes": 245000,
"top_tickers": ["NVDA", "TSLA", "AAPL", "AMD", "PLTR"]
}
]country | Country name |
buzz_score | Aggregated buzz score (0-100) |
trend | rising, falling, or stable |
mentions | Total mentions across all tickers from country |
unique_tickers | Number of unique tickers mentioned |
sentiment_score | Weighted average sentiment (-1 to +1) |
bullish_pct | Percentage of bullish mentions |
bearish_pct | Percentage of bearish mentions |
total_upvotes | Total likes across all mentions |
top_tickers | Top 5 tickers by mention count |
/v1/stock/{ticker}
Returns X/Twitter trending data for a specific ticker including buzz score, sentiment metrics, and daily trend history.
ticker | Stock ticker symbol (1-10 uppercase letters, e.g., TSLA) |
days | Time period in days (1-30 free, 1-90 paid; default: 7) |
{
"ticker": "TSLA",
"company_name": "Tesla, Inc.",
"found": true,
"buzz_score": 100,
"trend": "rising",
"total_mentions": 12,
"sentiment_score": 0.45,
"bullish_pct": 72,
"bearish_pct": 12,
"positive_count": 156,
"negative_count": 23,
"neutral_count": 89,
"total_upvotes": 8420,
"unique_tweets": 847,
"period_days": 7,
"is_validated": true,
"daily_trend": [
{ "date": "2025-12-30", "mentions": 2, "sentiment": 0.32, "buzz_score": 98.0, "avg_rank": 3.5 },
{ "date": "2025-12-31", "mentions": 4, "sentiment": 0.51, "buzz_score": 100.0, "avg_rank": 1.0 }
]
}ticker | Stock ticker symbol |
company_name | Company name (null if not found) |
found | Whether ticker was found in X trending |
buzz_score | Buzz score (0-100, null if not found) |
trend | rising, falling, or stable (rolling 24h window) |
total_mentions | Total tweet mentions in the period |
sentiment_score | Average sentiment (-1 to +1, null if unavailable) |
bullish_pct | Percentage of bullish mentions (0-100, null if unavailable) |
bearish_pct | Percentage of bearish mentions (0-100, null if unavailable) |
positive_count | Number of bullish mentions (null if unavailable) |
negative_count | Number of bearish mentions (null if unavailable) |
neutral_count | Number of neutral mentions (null if unavailable) |
total_upvotes | Total likes across mentions (null if unavailable) |
unique_tweets | Number of unique tweets (null if unavailable) |
period_days | Time period analyzed |
is_validated | Whether ticker is also trending on Reddit |
daily_trend | Array of daily data with date, mentions, sentiment, buzz_score, and avg_rank |
401 | Missing or invalid API key |
/v1/search
Search for stocks by ticker symbol or company name. Returns matching stocks with their X mention counts.
q | Search query (ticker or company name, required) |
{
"query": "tesla",
"count": 1,
"results": [
{
"ticker": "TSLA",
"name": "Tesla Inc.",
"aliases": ["Tesla", "Elon"],
"mention_count": 847
}
]
}query | Original search query |
count | Number of results found |
results | Array of matching stocks |
results[].ticker | Stock ticker symbol |
results[].name | Company name |
results[].aliases | Alternative names/aliases |
results[].mention_count | Total X mentions in database |
/v1/compare
Compare sentiment metrics for up to 10 stocks side by side using X/Twitter data.
tickers | Comma-separated list of tickers (max 10, required) |
days | Time period in days (1-30 free, 1-90 paid; default: 7) |
{
"period_days": 7,
"stocks": [
{
"ticker": "TSLA",
"company_name": "Tesla, Inc.",
"buzz_score": 100,
"mentions": 12,
"sentiment": 0.45,
"upvotes": 8420
},
{
"ticker": "NVDA",
"company_name": "NVIDIA Corporation",
"buzz_score": 85.2,
"mentions": 8,
"sentiment": 0.52,
"upvotes": 5210
}
]
}period_days | Analysis period in days |
stocks | Array of stock comparison data |
stocks[].ticker | Stock ticker symbol |
stocks[].company_name | Company name (null if not found) |
stocks[].buzz_score | Overall buzz score (0-100) |
stocks[].mentions | Total number of X mentions |
stocks[].sentiment | Average sentiment (-1 to +1) |
stocks[].upvotes | Total likes across all mentions |
400 | Maximum 10 tickers allowed |
401 | Missing or invalid API key |
All plans include access to the same powerful API.
Perfect for quick tests, API exploration, and early prototypes.
For professional traders, personal trading bots, academic research & side projects
For hedge funds, fintech startups, trading platforms & commercial applications
Non-profit & Education: Free access for qualifying organizations. Get in touch →
Everything you need to know about the X Stock Sentiment API.
We monitor cashtag mentions ($TSLA, $NVDA, etc.) across X/Twitter using Grok analysis. This includes posts from influential FinTwit accounts, traders, financial news sources, and trending discussions in the trading community.
Sentiment analysis is performed on tweet content, measuring bullish vs bearish tone. Scores range from -1.0 (bearish) to +1.0 (bullish). The bullish_pct and bearish_pct fields show the percentage breakdown of positive and negative mentions.
Buzz score (0-100) combines five weighted factors from real tweet data: mentions (20), sentiment (20), quality (10), author diversity (14, HHI-based), and trend (-10 to +20). Scores above 50 use asymptotic scaling to prevent ceiling clustering.
Trend compares rolling 24h windows based on X ranking history. Result: rising (>+10% improvement vs 24h ago), falling (<-10% decline), or stable (within ±10%). The trend_history array shows daily buzz scores for the past 7 days.
Grok analysis is fetched hourly from X/Twitter. Trends are calculated on rolling 24h windows. Historical data is available for up to 90 days (30 days free, 90 days paid).
The free tier includes 250 API calls per month, 100 requests per minute, access to all endpoints (trending, stock details), and 30 days historical data. Perfect for personal projects and prototyping. Upgrade for unlimited monthly usage and 90 days history.
All responses are JSON (UTF-8). The /v1/stock/{ticker} endpoint returns detailed data: daily_trend (per-day breakdown with mentions and avg_rank), sentiment metrics (sentiment_score, bullish_pct, bearish_pct), and cross-platform validation status.
Yes. Free tier keys are limited to 100 requests per minute and 250 requests per month. Paid tiers allow 1000 requests per minute with unlimited monthly usage. Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response. Exceeding limits returns HTTP 429.
Tickers that appear on both X/Twitter and Reddit trending lists are marked as is_validated: true. This provides higher confidence that a stock is genuinely trending across multiple platforms, filtering out platform-specific noise.
Our data is for informational purposes only. Sentiment is one signal among many—it reflects social media discussion, not institutional activity or fundamentals. Many traders use it as a contrarian indicator or for timing. Past sentiment is not indicative of future performance. Always do your own research.
Running a hedge fund, building a fintech product, or need high-volume access for your trading platform? Our Enterprise plan offers significantly higher rate limits for professional use cases.