Reddit Sentiment API

The Reddit Stock Sentiment API is a REST API that scores discussion from r/wallstreetbets and 50+ other subreddits and returns mentions, a bullish ratio, a buzz score, trend direction and history per ticker as JSON, refreshed hourly for 35,000+ stocks. The free tier includes 250 requests per month; paid plans add more history and commercial use.

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 1000+ term finance lexicon. 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, enriched top_subreddits, top_mentions and sentiment distribution counts. Sector and country trending responses include trend_history. 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. Monthly quota headers, including X-RateLimit-Remaining-Monthly and X-RateLimit-Reset-Monthly, are included in protected responses. 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.