JSON API for traders, fintech apps, dashboards and AI agents. Pull Reddit buzz scores, mentions, bullish ratios, trend direction and historical rankings via REST.
| # | Ticker | Company | Buzz | Mentions | Bullish | Trend |
|---|---|---|---|---|---|---|
| Loading trending stocks... | ||||||
Want the public live leaderboard? See the Reddit Top 100 Stocks page. This section previews the raw JSON output for trending tickers, sectors and countries. Need publisher-based coverage instead of retail chatter? Compare it with the Stock News Sentiment API.
Retail investors share ideas across dozens of subreddits. Trending tickers surface and fade within hours. Scanning r/wallstreetbets, r/stocks and r/investing takes time and you still miss signals in niche communities.
50+ active trading subreddits with thousands of daily posts. Impossible to track manually.
Sarcasm, memes and duplicate posts make raw mention counts unreliable.
You need a single score to compare $TSLA buzz vs $PLTR buzz objectively.
Discover what's trending, analyze any ticker in detail, monitor the market-wide mood and get AI-powered explanations. RESTful JSON endpoints that integrate into trading bots, dashboards, or research tools.
Posts and comments scraped hourly from 50+ subreddits. Today shows activity so far, while trend compares the current 3 UTC days with the previous 3 UTC days.
Hybrid VADER + Twitter-RoBERTa ensemble with 1000+ finance terms like "moon", "tendies", "bearish", plus emoji analysis.
Mention volume, sentiment, upvotes, subreddit spread and momentum combined into one 0-100 score.
Access real-time stock sentiment analytics from Reddit for your trading algorithms, fintech apps, or market research tools.
Fill out the form below. We'll send you a secure link to retrieve your API key.
We've sent a link to retrieve your API key. The link expires in 24 hours and can only be used once.
RESTful JSON API. All requests require authentication via X-API-Key header. View full documentation → · BuzzScore Whitepaper →
https://api.adanos.org/reddit/stocks
X-API-Key: sk_live_...
/v1/trending
Returns stocks with highest buzz on Reddit, ranked by buzz score. Combines mention volume, sentiment, engagement (upvotes) and trend direction.
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
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": 87.5,
"trend": "rising",
"trend_history": [85.2, 82.1, 79.5, 81.3, 84.0, 86.2, 87.5],
"mentions": 342,
"unique_posts": 45,
"subreddit_count": 8,
"sentiment_score": 0.23,
"bullish_pct": 45,
"bearish_pct": 18,
"total_upvotes": 15234
}
]ticker | Stock ticker symbol |
company_name | Company name (null if not found) |
buzz_score | Overall buzz score (0-100) |
trend | rising, falling, or stable activity trend for current 3 UTC days vs previous 3 UTC days |
trend_history | Array of daily buzz scores (oldest to newest, min 7 days, 0.0 for missing data) |
mentions | Total number of mentions |
unique_posts | Number of unique posts |
subreddit_count | Number of subreddits with mentions |
sentiment_score | Average sentiment (-1 bearish to +1 bullish) |
bullish_pct | Percentage of bullish mentions |
bearish_pct | Percentage of bearish mentions |
total_upvotes | Total upvotes across all mentions |
/v1/trending/sectors
Returns sectors with highest aggregated buzz on Reddit, ranked by buzz score. Combines all stock mentions per sector and includes the top 5 tickers per sector.
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
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,
"subreddit_count": 15,
"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 | Sector activity trend for current 3 UTC days vs previous 3 UTC days |
mentions | Total mentions across all tickers in sector |
unique_tickers | Number of unique tickers mentioned |
subreddit_count | Number of subreddits with mentions |
sentiment_score | Weighted average sentiment (-1 to +1) |
bullish_pct | Percentage of bullish mentions |
bearish_pct | Percentage of bearish mentions |
total_upvotes | Total upvotes across all mentions |
top_tickers | Top 5 tickers by mention count |
/v1/trending/countries
Returns countries with highest aggregated buzz on Reddit, ranked by buzz score. Combines all stock mentions per country and includes the top 5 tickers per country.
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
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,
"subreddit_count": 18,
"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 | Country activity trend for current 3 UTC days vs previous 3 UTC days |
mentions | Total mentions across all tickers from country |
unique_tickers | Number of unique tickers mentioned |
subreddit_count | Number of subreddits with mentions |
sentiment_score | Weighted average sentiment (-1 to +1) |
bullish_pct | Percentage of bullish mentions |
bearish_pct | Percentage of bearish mentions |
total_upvotes | Total upvotes across all mentions |
top_tickers | Top 5 tickers by mention count |
/v1/stock/{ticker}
Returns detailed sentiment analysis for a specific stock ticker. Includes daily trend data, top mentions by upvotes and top subreddits.
ticker | Stock ticker symbol (1-5 uppercase letters, e.g., TSLA) |
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
{
"ticker": "TSLA",
"company_name": "Tesla, Inc.",
"found": true,
"buzz_score": 87.5,
"trend": "rising",
"mentions": 342,
"sentiment_score": 0.23,
"bullish_pct": 45,
"bearish_pct": 18,
"positive_count": 154,
"negative_count": 62,
"neutral_count": 126,
"total_upvotes": 15234,
"unique_posts": 45,
"subreddit_count": 8,
"period_days": 7,
"daily_trend": [
{ "date": "2024-12-27", "mentions": 52, "sentiment_score": 0.31, "buzz_score": 87.5 },
{ "date": "2024-12-26", "mentions": 48, "sentiment_score": 0.18, "buzz_score": 85.2 }
],
"top_subreddits": [
{ "subreddit": "wallstreetbets", "count": 89 },
{ "subreddit": "stocks", "count": 67 }
],
"top_mentions": [
{
"text_snippet": "TSLA looking strong after...",
"sentiment_score": 0.85,
"sentiment_label": "positive",
"upvotes": 1234,
"subreddit": "wallstreetbets",
"created_utc": "2024-12-27T10:30:00"
}
]
}ticker | Stock ticker symbol |
company_name | Company name (null if not found) |
found | Whether mentions were found |
buzz_score | Overall buzz score (0-100) |
trend | rising, falling, or stable activity trend for current 3 UTC days vs previous 3 UTC days |
mentions | Total number of mentions |
sentiment_score | Average sentiment (-1 to +1) |
bullish_pct | Percentage of bullish mentions |
bearish_pct | Percentage of bearish mentions |
positive_count | Number of positive mentions |
negative_count | Number of negative mentions |
neutral_count | Number of neutral mentions |
total_upvotes | Total upvotes across all mentions |
unique_posts | Number of unique posts |
subreddit_count | Number of subreddits with mentions |
period_days | Analysis period in days |
daily_trend | Array of daily mentions, sentiment_score and buzz_score |
top_subreddits | Top subreddits by mention count |
top_mentions | Top mentions by upvotes |
404 | No mentions found for ticker in the specified period |
401 | Missing or invalid API key |
/v1/stock/{ticker}/explain
Returns an AI-generated explanation of why a stock is trending based on recent Reddit user-comments.
ticker | Stock ticker symbol (1-5 uppercase letters, e.g., TSLA) |
{
"ticker": "TSLA",
"company_name": "Tesla, Inc.",
"explanation": "Tesla is trending due to strong Q4 delivery numbers and renewed investor optimism about EV demand.",
"cached": false,
"generated_at": "2025-01-14T12:30:00Z",
"model": "llama-3.1-8b-instant"
}ticker | Stock ticker symbol |
company_name | Company name (null if not found) |
explanation | 1-2 sentence AI-generated summary of why the stock is trending |
cached | Whether the response was served from cache |
generated_at | ISO timestamp when the explanation was generated |
model | LLM model used for generation (null if unavailable) |
404 | No mentions found for ticker |
401 | Missing or invalid API key |
503 | Explanation service temporarily unavailable |
/v1/search
Search for stocks by ticker symbol or company name. Search accepts only q and limit; summary metrics use a fixed last 7 UTC calendar days window.
q | Search query (ticker or company name, required) |
limit | Maximum result count (1-200, default: 50) |
{
"query": "tesla",
"count": 1,
"period_days": 7,
"results": [
{
"ticker": "TSLA",
"name": "Tesla Inc.",
"type": "Stock",
"exchange": "NASDAQ",
"sector": "Consumer Discretionary",
"country": "United States",
"aliases": ["Tesla", "Elon"],
"summary": {
"mentions": 342,
"buzz_score": 87.5,
"trend": "rising",
"sentiment_score": 0.23
}
}
]
}query | Original search query |
count | Number of results found |
period_days | Fixed 7 UTC calendar-day lookback used for each summary block |
results | Array of matching stocks |
results[].ticker | Stock ticker symbol |
results[].name | Company name |
results[].type | Asset type (e.g., Stock, ETF) |
results[].exchange | Exchange (e.g., NASDAQ, NYSE) |
results[].sector | Industry sector |
results[].country | Country of headquarters |
results[].aliases | Alternative names/aliases |
results[].summary | Compact Reddit discovery summary for the fixed last 7 UTC calendar days |
results[].summary.mentions | Attributed mentions in the last 7 UTC calendar days |
results[].summary.buzz_score | Buzz score over the last 7 UTC calendar days |
results[].summary.trend | Activity trend over current 3 UTC days vs previous 3 UTC days; not a price trend |
results[].summary.sentiment_score | Average sentiment over the last 7 UTC calendar days |
/v1/compare
Compare sentiment metrics for up to 10 stocks side by side.
tickers | Comma-separated list of tickers (max 10, required) |
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
{
"period_days": 7,
"stocks": [
{
"ticker": "TSLA",
"company_name": "Tesla, Inc.",
"buzz_score": 87.5,
"trend": "rising",
"mentions": 342,
"unique_posts": 45,
"subreddit_count": 8,
"sentiment_score": 0.23,
"bullish_pct": 45,
"bearish_pct": 18,
"total_upvotes": 15234
},
{
"ticker": "NVDA",
"company_name": "NVIDIA Corporation",
"buzz_score": 72.3,
"trend": "stable",
"mentions": 189,
"unique_posts": 31,
"subreddit_count": 6,
"sentiment_score": 0.45,
"bullish_pct": 52,
"bearish_pct": 17,
"total_upvotes": 8921
}
]
}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[].trend | Stock activity trend for current 3 UTC days vs previous 3 UTC days |
stocks[].mentions | Total number of mentions |
stocks[].unique_posts | Number of unique posts in the selected period |
stocks[].subreddit_count | Number of subreddits with mentions |
stocks[].sentiment_score | Average sentiment (-1 to +1) |
stocks[].bullish_pct | Percentage of bullish mentions |
stocks[].bearish_pct | Percentage of bearish mentions |
stocks[].total_upvotes | Total upvotes across all mentions |
400 | Maximum 10 tickers allowed |
401 | Missing or invalid API key |
/v1/market-sentiment
Returns a one-call snapshot of overall Reddit stock sentiment, including activity breadth, sentiment balance and the tickers currently driving discussion.
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
{
"buzz_score": 63.4,
"trend": "rising",
"mentions": 12840,
"unique_posts": 1904,
"subreddit_count": 34,
"total_upvotes": 284531,
"active_tickers": 412,
"sentiment_score": 0.18,
"positive_count": 5210,
"negative_count": 2489,
"neutral_count": 5141,
"bullish_pct": 41,
"bearish_pct": 19,
"trend_history": [52.1, 54.7, 57.3, 59.9, 60.4, 61.8, 63.4],
"drivers": [
{ "ticker": "TSLA", "mentions": 342, "buzz_score": 87.5, "sentiment_score": 0.23 },
{ "ticker": "NVDA", "mentions": 189, "buzz_score": 72.3, "sentiment_score": 0.45 }
]
}buzz_score | Relative Reddit market heat vs. the trailing 90-day Reddit stocks baseline (~50 is normal) |
trend | Service-level Reddit activity trend for current 3 UTC days vs previous 3 UTC days |
mentions | Total Reddit stock mentions across the selected window |
unique_posts | Number of distinct Reddit posts represented in the aggregate snapshot |
subreddit_count | Number of subreddits contributing to the aggregate snapshot |
total_upvotes | Total upvotes across all matched mentions |
active_tickers | Number of tickers active in the selected window |
sentiment_score | Average sentiment across all matched mentions (-1 to +1) |
positive_count | Number of bullish mentions in the aggregate window |
negative_count | Number of bearish mentions in the aggregate window |
neutral_count | Number of neutral mentions in the aggregate window |
bullish_pct | Percentage of bullish mentions across the whole Reddit stocks universe |
bearish_pct | Percentage of bearish mentions across the whole Reddit stocks universe |
trend_history | Daily aggregate buzz-score history (oldest to newest) |
drivers | Top tickers driving the current aggregate Reddit market mood |
/v1/stock/{ticker}/mentions
Pro
Returns raw Reddit mention rows for one ticker within the live raw-data retention window. from/to date windows are interpreted as inclusive UTC calendar dates. Use it when you need post/comment-level snippets, original timestamps and inherited-context filtering.
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Professional-only raw endpoint; earliest start date, counted back from the current UTC date: 365 days |
limit | Maximum raw rows to return (1-100, default: 50) |
include_inherited | Include inherited thread-context mentions in addition to direct ticker matches (default: false) |
{
"ticker": "TSLA",
"period_days": 7,
"count": 1,
"results": [
{
"post_id": "abc123",
"comment_id": "def456",
"subreddit": "wallstreetbets",
"author": "user123",
"text_snippet": "TSLA looks strong into earnings...",
"created_utc": "2026-03-20T18:42:10Z",
"upvotes": 381,
"sentiment_score": 0.62,
"sentiment_label": "positive",
"is_inherited": false
}
]
}ticker | Resolved ticker symbol |
period_days | Applied raw mention lookback window |
count | Total matching raw mention rows before the limit cut |
results | Newest-first raw mention rows for the ticker |
results[].post_id | Reddit post id |
results[].comment_id | Reddit comment id when the row comes from a comment |
results[].subreddit | Source subreddit |
results[].author | Public Reddit author name, when available |
results[].text_snippet | Short text extract from the raw mention row |
results[].created_utc | Original UTC timestamp for the post/comment row |
results[].upvotes | Upvote count captured on the raw row |
results[].sentiment_score | Sentiment score for that raw row (-1 to +1) |
results[].sentiment_label | Sentiment class for that raw row |
results[].is_inherited | Whether the row was inherited from thread context instead of a direct ticker mention |
401 | Missing or invalid API key |
403 | Professional plan required for raw mention access |
422 | Invalid ticker or query parameter |
All plans share the same base API. Professional adds raw mention data and commercial rights.
Perfect for quick tests, API exploration and early prototypes. No credit card required.
For professional traders, personal trading bots, academic research & side projects
For hedge funds, fintech startups, trading platforms & commercial applications
Enterprise: Get in touch for API access, higher rate limits or custom data feeds. We work with quant teams, fintech startups and research groups across stock and crypto sentiment. Contact us → Non-profit or education use? Apply for free access →
Everything you need to know about the Reddit Stock Sentiment API.
We monitor 50+ subreddits including r/wallstreetbets, r/stocks, r/investing, r/stockmarket, r/options, r/Finanzen and r/mauerstrassenwetten. These communities represent the most active retail trading discussions on Reddit.
We use a hybrid VADER + Twitter-RoBERTa sentiment ensemble, with VADER enhanced by a finance-specific lexicon of 1000+ terms. Examples: moon (+3.5), tendies (+2.5), bearish (-3.0), short squeeze (+3.5). Emojis are also analyzed: 🚀 (+3.0), 🐻 (-2.5), 💎🙌 (+2.0). Scores range from -1.0 (bearish) to +1.0 (bullish).
Buzz score (0-100) combines five weighted factors: volume (log₁₀(mentions + 1) × 20), mood (sentiment × 20), quality (log₁₀(upvotes/mentions + 1) × 10), diversity (log₁₀(subreddits + 1) × 14) and momentum (trend boost from -10 to +20). Scores above 50 use asymptotic scaling to prevent ceiling clustering.
Trend compares normalized Reddit activity for the current 3 UTC days with the previous 3 UTC days using a weighted activity score: 60% mentions ratio, 25% upvotes ratio, 15% subreddit spread. Result: rising (>+10%), falling (<-10%), or stable (±10%). It is an attention trend, not a price trend.
Our scraper runs every 60 minutes, processing posts and comments from all tracked subreddits. The worker health endpoint shows scrape status, success rate and last scrape timestamp. Historical data is available for up to 365 days.
The free tier includes 250 API calls per month, 100 requests per minute, access to the full base endpoint surface including market-wide sentiment snapshots, and 30 days historical data. Raw mention endpoints are Professional-only. Perfect for personal projects and prototyping. Upgrade for 250,000 Hobby requests/month or 2,500,000 Professional requests/month.
All responses are JSON (UTF-8). The /v1/stock/{ticker} endpoint returns the richest per-ticker data: daily_trend, top_subreddits, top_mentions and sentiment distribution counts. For a broader view, /v1/market-sentiment returns aggregate buzz, breadth and the top drivers of the current Reddit market mood. Professional accounts can also call /v1/stock/{ticker}/mentions for raw post/comment rows with count and results.
Yes. Free tier keys are limited to 100 requests per minute and 250 requests per month. Hobby allows 1000 requests per minute with 250,000 requests per month. Professional allows 2,500,000 requests per month. Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response. Exceeding limits returns HTTP 429.
The /v1/stock/{ticker}/explain endpoint uses Groq's llama-3.1-8b-instant model to analyze top mentions and generate a 1-2 sentence explanation of why a stock is trending. Explanations are cached for 6 hours. Only available for tickers with ≥10 mentions.
Our data is for informational purposes only. Sentiment is one signal among many. It reflects retail 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.
Need a higher-volume or custom data setup? Contact us and we will help map the right access model.