50K+ tickers · 60+ subreddits · Hourly

Reddit Stock
Sentiment API

Track Reddit stock mentions, buzz scores, bullish ratios, trend direction and historical rankings through one JSON API. Use finance-tuned sentiment data in trading tools, fintech apps, dashboards and AI agents.

Reddit moves fast. Reading it by hand doesn’t scale.

Retail ideas surface across dozens of trading subreddits and fade within hours. Scanning r/wallstreetbets, r/stocks and r/investing takes time. The smaller communities still slip through.

Too many places

60+ active trading subreddits with thousands of daily posts. Impossible to track manually.

Noisy signals

Sarcasm, memes and repeat posters make raw counts unreliable. We check every mention in context.

No common scale

A buzz score from 0 to 100 puts $TSLA and $PLTR on one scale, so you compare them directly.

From one comment to a buzz score.

Every hour the pipeline reads 60+ subreddits, finds the stocks in each comment, scores its tone and adds it to the ticker’s numbers.

  1. 01 Collect

    Posts and comments from 60+ subreddits in a 60-minute cycle. The busiest comment feeds are read more often.

    r/ValueInvesting“I would remove Tesla from MAG 7”
  2. 02 Match

    The entity graph finds tickers, names and products. A mention counts only after our AI has checked its context.

    TeslaTSLA
  3. 03 Score

    RoBERTa (60%) and VADER (40%), tuned with 1,000+ finance terms and 68 emoji. From −1 bearish to +1 bullish.

    −0.21 bearish
  4. 04 Aggregate

    Every mention of a ticker feeds one buzz score from 0 to 100, its bullish share and its trend.

    74.3 buzz score
  5. 05 Serve

    Ten REST endpoints return the results as JSON, from the trending list to a ticker’s daily history.

    GET /v1/stock/TSLA { "ticker": "TSLA", "buzz_score": 74.35, "trend": "stable", "mentions": 1255 }

Reddit sentiment API endpoints

A RESTful JSON API. Every request needs your key in the X-API-Key header. Try each call below with real responses.

Base URL
https://api.adanos.com/reddit/stocks
Authentication
X-API-Key header on every request
Rate limits
100 to 1,000/min, plus a monthly quota
Format
JSON (UTF-8), times in UTC
GET/v1/trending
Window
Type
Limit
3
from
Inclusive UTC start date (YYYY-MM-DD)
to
Inclusive UTC end date (YYYY-MM-DD). Without a window: the current UTC day so far. At most 30 days back on Free, 90 on Hobby and 365 on Professional; data starts on 2025-06-01
limit
Maximum results, 1 to 100Default 20
offset
Skip the first N results for paginationDefault 0
type
Asset type: stock, etf or allDefault all

Docs, SDKs and CLI

Official SDKs for Python, TypeScript, PHP and Go. For the terminal, scripts and agents there is the Adanos CLI. Every client uses the same API key.

  • Python SDKpip install adanos
  • TypeScript SDKnpm install finance-sentiment
  • PHP SDKcomposer require adanos/adanos-php
  • Go SDKgo get github.com/adanos-software/adanos-go-sdk
  • Adanos CLIpipx install adanos-cli

Start free. Upgrade when you ship.

One key opens all five sentiment APIs. The plans differ in volume, history and commercial use.

Free

$0

No credit card required

Perfect for quick tests, API exploration and early prototypes.

  • 250 requests a month
  • 100 requests a minute
  • 30 days of history
  • Email support
  • Non-commercial use

Hobby

$29$24.17a month*Hobby includes VAT where applicable and is non-commercial only. Prices in EUR and USD are fixed local prices.

$290 billed yearlySave $58

For professional traders, personal trading bots, academic research & side projects.

  • 250,000 requests a month
  • 1,000 requests a minute
  • 90 days of history
  • Email support
  • Non-commercial use

Professional

Recommended

$299$249.17a month

$2,990 billed yearlySave $598

For hedge funds, fintech startups, trading platforms & commercial applications.

  • 2,500,000 requests a month
  • 1,000 requests a minute
  • Up to 365 days of history
  • Raw mentions and the text sentiment API
  • Priority support with SLA
  • Commercial use

One key, every source

Every plan, Free included, opens all five sentiment APIs with the same key. YouTube is next.

X-API-Key: YOUR_KEY

Higher limits or custom feeds? Talk to us about Enterprise. Every feature side by side on the pricing page.

Frequently asked questions

Everything you need to know about the Reddit Stock Sentiment API.

Not answered here? Write to support@adanos.com

What is the Reddit Stock Sentiment API?

The Reddit Stock Sentiment API is a REST API that scores discussion from r/wallstreetbets and 60+ other subreddits and returns mentions, a bullish ratio, a buzz score, trend direction and history per ticker as JSON, refreshed hourly for 50,000+ stocks. The free tier includes 250 requests per month and 30 days of history. Hobby adds 90 days of history for non-commercial use. Professional adds 365 days, raw mentions and commercial use.

Academic background: Bradley, Hanousek, Jame and Xiao (2024), Place Your Bets? The Value of Investment Research on Reddit’s WallStreetBets, Review of Financial Studies 37(5).

GET/reddit/stocks/v1/stock/TSLA

Which subreddits do you track?

We monitor 60+ 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.

"subreddit_count": 38

How often is data updated?

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.

GET/reddit/stocks/v1/health

What format is the API response?

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.

Content-Type: application/json

How is sentiment calculated?

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).

"sentiment_score": -0.007

How is buzz score calculated?

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.

"buzz_score": 74.35

How is trend calculated?

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.

"trend": "rising"

How does the AI explanation work?

The /v1/stock/{ticker}/explain endpoint uses a large language model to analyze top mentions and generate a 1-2 sentence explanation of why a stock is trending. The model field names the model. Explanations are cached for 6 hours. Only available for tickers with ≥10 mentions.

GET/reddit/stocks/v1/stock/TSLA/explain

What’s included in the free tier?

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.

X-RateLimit-Limit-Monthly: 250

Is there rate limiting?

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 1000 requests per minute with 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.

HTTP 429 Too Many Requests

Can I use this for trading decisions?

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.

"bullish_pct": 22