Market Sentiment Reader

A personal, read-only tool that collects public posts from financial subreddits to gauge community sentiment around US stocks.

What it does

• Searches Reddit financial communities for mentions of stock tickers
• Reads publicly available post data (title, body, score, timestamp)
• Runs local sentiment analysis using VADER (lexicon-based NLP)
• Outputs daily sentiment scores per stock for personal research

What it does NOT do

• Never posts, comments, votes, or sends messages on Reddit
• Never modifies any content on Reddit
• Never shares or sells collected data
• Never operates as a bot within any subreddit

Subreddits

Reads from: r/wallstreetbets, r/stocks, r/investing

Setup

pip install -r requirements.txt
cp .env.example .env
# Fill in your Reddit API credentials

Usage

# Collect sentiment for a stock
python main.py --symbol AAPL

# Collect sentiment for multiple stocks
python main.py --symbols AAPL,TSLA,NVDA

How it works

1. Uses PRAW to search subreddits for ticker mentions
2. Collects only public metadata: title, body, timestamp, score, comment count
3. Runs VADER sentiment analysis locally on each post
4. Aggregates into daily sentiment scores (range: -1.0 to +1.0)
5. Saves results locally as CSV/Parquet for personal use

Rate Limiting

Respects Reddit API rate limits. PRAW handles throttling automatically. The app runs once daily.

License

For personal use only.