Mattbusel/Reddit-Options-Trader-ROT-

English | 简体中文 | 日本語 | 한국어
**A Python app that reads Reddit and market news, spots which stock tickers people are suddenly excited about, scores how trustworthy each post looks, and turns it into an options trade idea, or a clear reason not to trade.** It is a Reddit sentiment and options signal pipeline with a web dashboard, a REST/WebSocket API and optional LLM reasoning (OpenAI, Anthropic or DeepSeek).
For developers and retail options traders who want to study Reddit sentiment as a signal, and for anyone curious how a social-media NLP pipeline is built end to end.
Project site ·
Try it ·
How it works ·
Examples ·
Full reference
> [!WARNING]
> **Research and educational tool only. Not financial advice.** ROT produces signals and trade ideas, not a tested strategy. Options can lose 100% of the premium paid, Reddit sentiment is noisy and often manipulated, and LLM reasoning can be confidently wrong. Broker integration defaults to paper trading.
*The dashboard running locally (February 2026 screenshot, live Reddit data).*
Try it in one command
No Reddit account, no API keys. The demo runs the real pipeline on five bundled sample posts:
Python 3.10+. The sample posts in examples/sample/posts.json were written for the demo (they are not real Reddit posts); ticker checks and prices come from a Yahoo Finance snapshot saved on 2026-09-28, so it runs offline. Add --live for fresh prices.
To run the full app with live Reddit data and the dashboard, copy .env.example to .env, add your Reddit API keys, and run docker compose up --build (then open http://localhost:8000/dashboard). There is no hosted instance: the old Railway deployment is offline.
How it works
In plain words, on every poll (Reddit is polled every 20 seconds by default):
1. **Ingest and trend.** Posts come in from Reddit and RSS news feeds. A post "trends" when its upvotes and comments grow fast between two polls.
2. **Find the ticker and the story.** A custom NLP engine pulls out $TSLA-style tickers, the kind of event (earnings rumour, product news, squeeze chatter...), the stance (bullish, bearish, mixed) and the time horizon. Tickers are checked against real market data.
3. **Score trust.** A credibility score from 0 to 1 rewards DD posts, good subreddits and engagement, and penalises cross-posts, new accounts and pump-and-dump language.
4. **Reason and decide.** An LLM (or a built-in stub when there is no key) writes a thesis, and the trade builder either proposes a structure (debit/credit spread, straddle...) or records why it will not trade.
Code: src/rot/app/runner.py (PipelineRunner.run_once). Diagram source: scripts/make_pipeline_svg.py.
Examples
Real output of python examples/demo.py on 2026-09-28 (stub reasoning, bundled market snapshot):
What it shows: the DD post on r/options scores highest (0.70) and the r/wallstreetbets rumour lowest (0.45); the hype post has no ticker and the calm question never trends, so both stop early; and ROT refuses to trade all three events, for the reasons it logs. Every stage also writes a JSONL audit trail. python examples/demo.py --keep leaves it on disk, for example: