| 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
pip install -r requirements.txt
Quickstart
python3 stonks.py
python3 stonks.py -e -p 25
python3 -m uvicorn app:app --host 0.0.0.0 --port 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.
