# StonkUP — Social Sentiment & Market Intelligence

> StonkUP (https://stonkup.com) is a real-time financial market intelligence platform that monitors and quantifies retail investor sentiment across social media (Reddit: r/wallstreetbets, r/stocks, r/investing) and major financial news feeds. The platform features an empirical "Reddit Oracles" leaderboard tracking the predictive win rates of retail stock analysts.

## Core Features & Intelligence
- **Real-Time Sentiment Scores**: Quantitative scores ranging from -1.0 (strongly bearish) to +1.0 (strongly bullish) for publicly traded US equities and ETFs.
- **Reddit Oracles Leaderboard**: Evaluates stock calls made by Reddit authors against actual 7-day stock price movements to track win rates, total predictions, and winning trades.
- **Trending Tickers**: Ranked lists of the most discussed tickers, top bullish momentum stocks, and top bearish stocks across 24-hour, 7-day, and all-time timeframes.
- **Live Social & News Feed**: Continuously ingested post stream from Reddit and financial news with entity-extracted tickers and calculated sentiment scores.
- **Interactive Price & Sentiment Charts**: Historical stock closing prices overlaid with social sentiment trends over 7d, 30d, 90d, and 1-year horizons.

## Canonical Web URLs
- [Homepage & Dashboard](https://stonkup.com/): Primary dashboard featuring trending tickers, sentiment charts, and live feed.
- [Ticker Sentiment View](https://stonkup.com/?ticker=NVDA): Deep-link into specific ticker intelligence (replace `NVDA` with any ticker, e.g. `AAPL`, `TSLA`, `SPY`, `PLTR`).
- [Privacy Policy](https://stonkup.com/privacy): Data privacy and user data policies.
- [Terms of Service](https://stonkup.com/terms): Terms and disclaimer on financial information.
- [Contact](https://stonkup.com/contact): Inquiries and support.

## Public JSON API Endpoints
All public endpoints are accessible without authentication:
- `GET https://stonkup.com/api/market/oracles`: Returns Reddit Oracle rankings, win rates, total calls, and winning posts.
- `GET https://stonkup.com/api/trending?timeframe=24h`: Top bullish, bearish, and most mentioned tickers (timeframe: `24h`, `7d`, `all`).
- `GET https://stonkup.com/api/feed`: Latest news and Reddit posts with extracted ticker sentiment.
- `GET https://stonkup.com/api/tickers/search?q={query}`: Autocomplete search for tracked tickers.
- `GET https://stonkup.com/api/ticker/{symbol}?timeframe=30d`: Comprehensive ticker overview, company financials, historical price series, and sentiment points.

## Comprehensive AI & LLM Documentation
- [Full LLM Reference & API Specifications](https://stonkup.com/llms-full.txt): In-depth algorithmic methodology, calculation formulas, and response schemas.