Reddit Stonks Analyzer#

Analyze Reddit stock sentiment + AI-powered stock picks for short-term returns.

Setup (first time only)#

bash

cp .env.example .env
# Edit .env: add DEEPSEEK_API_KEY
pip install -r requirements.txt

Quickstart#

bash

# 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#

FlagDescription-e, --euroShow European exchange equivalents for top picks-p N, --posts NPosts 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.