Reddit Stonks Analyzer
Analyze Reddit stock sentiment + AI-powered stock picks for short-term returns.
Setup (first time only)
cp .env.example .env
# Edit .env: add DEEPSEEK_API_KEY
pip install -r requirements.txt
Quickstart
# Terminal mode
python3 stonks.py
python3 stonks.py -e -p 25
# Web app mode
python3 -m uvicorn app:app --host 0.0.0.0 --port 8080
# Open http://localhost:8080
Flags
| Flag | Description |
|---|---|
-e, --euro |
Show European exchange equivalents for top picks |
-p N, --posts N |
Posts per subreddit (default: 50) |
How it works
- Scrapes 7 stock-related subreddits (r/wallstreetbets, r/stocks, r/investing, r/pennystocks, r/StockMarket, r/thetagang, r/dividends) for hot posts
- Extracts stock tickers ($TICKER and all-caps mentions) from post titles and bodies
- Fetches real-time stock data via Yahoo Finance (price, P/E, beta, volume, short float, analyst targets)
- Sends everything to the Deepseek AI for analysis
Output
Generates a stock data table, then AI analysis with:
- Top Pick (best 1-week return)
- Runner-up
- Wildcard (high risk/reward)
- Risk factors
- Confidence score
- Optionally: European exchange equivalents
Architecture
stonks.py— orchestrator + AI analysis via Deepseekreddit_scraper.py— scrapes 7 subreddits via Reddit JSON API (no auth required)stock_data.py— Yahoo Finance fundamentals/technicals + European ticker lookup
Disclaimer
AI-generated analysis for entertainment/educational purposes only. Not financial advice.