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

1. Scrapes 7 stock-related subreddits (r/wallstreetbets, r/stocks, r/investing, r/pennystocks, r/StockMarket, r/thetagang, r/dividends) for hot posts
2. Extracts stock tickers ($TICKER and all-caps mentions) from post titles and bodies
3. Fetches real-time stock data via Yahoo Finance (price, P/E, beta, volume, short float, analyst targets)
4. 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 Deepseek
• reddit_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.