PUBLIC BETA · UNDER ACTIVE DEVELOPMENT

X.com Stock
Sentiment API

Real-time sentiment analysis from X/Twitter's most active trading communities. Track which tickers FinTwit is talking about before the market moves.

Get API Access View Trending Tickers

Power your trading tools with X sentiment data

Integrate X/Twitter trending data into your trading algorithms, dashboards, or research tools. Our API provides clean, structured data updated every 60 minutes.

  • Top 100 trending tickers from FinTwit
  • Buzz scores & trend detection
  • Cross-platform validation with Reddit
  • Grok-powered analysis from X/Twitter
  • Free tier: 250 requests/month
  • 10,000+ tickers monitored hourly, and growing
  • Reddit Sentiment API also available

Request API Access

Fill out the form below to get your API key instantly.

Endpoints

RESTful JSON API. All requests require authentication via X-API-Key header.

Base URL

https://api.adanos.org/x/stocks

Authentication

X-API-Key: sk_live_...

Rate Limit

100 requests/minute

Response Format

JSON (UTF-8)
GET /v1/stock/{ticker}

Returns X/Twitter trending data for a specific ticker including buzz score and daily trend history.

Path Parameters

tickerStock ticker symbol (1-10 uppercase letters, e.g., TSLA)

Query Parameters

daysTime period in days (1-30, default: 7)

Response

{
  "ticker": "TSLA",
  "company_name": "Tesla, Inc.",
  "found": true,
  "buzz_score": 100,
  "total_mentions": 12,
  "period_days": 7,
  "is_validated": true,
  "daily_trend": [
    { "date": "2025-12-30", "mentions": 2, "avg_rank": 3.5 },
    { "date": "2025-12-31", "mentions": 4, "avg_rank": 1.0 }
  ]
}

Response Fields

tickerStock ticker symbol
company_nameCompany name (null if not found)
foundWhether ticker was found in X trending
buzz_scoreBuzz score (0-100, null if not found)
total_mentionsTotal appearances in the period
period_daysTime period analyzed
is_validatedWhether ticker is also trending on Reddit
daily_trendArray of daily data with date, mentions, and avg_rank

Error Codes

401Missing or invalid API key
FAQ

Frequently Asked Questions

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

What data sources do you track?

We monitor cashtag mentions ($TSLA, $NVDA, etc.) across X/Twitter, including posts from influential FinTwit accounts, traders, and financial news sources.

How is buzz score calculated?

Buzz score is a proprietary metric (0-100) that reflects how much attention a stock is getting on X/Twitter. Higher scores indicate more buzz.

How often is data updated?

Our API updates every 60 minutes. Historical data is available for the past 90 days.

What's included in the free tier?

The free tier includes 250 API calls per month and access to all 100 trending stocks. Perfect for personal projects and prototyping.

What is cross-platform validation?

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.

What format is the API response?

All responses are in JSON format. Core fields include ticker, x_rank, buzz_score, trend, and is_validated. The is_validated field indicates cross-platform validation with Reddit.

Is there rate limiting?

Yes. All API keys are limited to 100 requests per minute. Rate limit headers are included in every response.

Can I use this for trading decisions?

Our data is for informational purposes only. While many traders use sentiment as one input, we recommend combining it with other analysis. Past sentiment is not indicative of future performance.

For Professionals

Need more API requests?

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.

Contact Sales