reddit-stonks

name	reddit-stonks
version	1.1.0
description	Scrape Reddit stock pages (r/wallstreetbets, r/stocks, etc.) and use Deepseek AI to analyze which stock has the highest 1-week return potential. Includes a web app (uvicorn app:app). Use when the user asks about stock picks, Reddit stock sentiment, meme stocks, investing ideas from Reddit, "what should I buy", "best stock this week". Supports --euro flag for European exchange equivalents.
metadata	{"openclaw":{"requires":{"env":["DEEPSEEK_API_KEY"],"bins":["python3"]},"primaryEnv":"DEEPSEEK_API_KEY","homepage":"https://github.com/AltusRossouw/reddit-stonks","emoji":"📈"}}

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.