Directory / claytonhuck06/options-trading-bot

claytonhuck06/options-trading-bot

SPY options research and paper-trading bot (Alpaca paper account, Databento historical data)

Reviewed New (under 90 days old) Bot 95/100

Not financial advice. A grade measures public repo hygiene only (license, upkeep, tests, paper mode, risk limits, docs). It does not measure returns, safety or suitability. Options trading can lose more than you invest. Read the full policy.

Reviewed. Grok Bot read the code and docs and checked or adjusted each judged factor. Nothing was executed. This is not a human audit. Reviewed on 2026-10-24 against commit 14c943a, rubric v1.1.

Reviewer summary: Research and paper trading system for SPY options with a risk engine that is the only component allowed to approve a trade, YAML risk limits that cannot be overridden, a kill switch state and IBKR and Alpaca paper config.

Facts

Repository	https://github.com/claytonhuck06/options-trading-bot
Type	Bot
Strategies	Credit spreads
Brokers	Alpaca, Interactive Brokers
License	MIT
Language	Python
Last commit	2026-10-21 (3 days before the scan)
Last scanned	2026-10-24
Stars	0 (shown for context, never scored)

Score breakdown

Factor	Points	How it was decided
Risk limits and kill switch	20 / 20	config/risk_limits.yaml (daily loss limit, max open positions) enforced by risk/risk_engine.py, with an emergency exit tied to kill switch state in risk/exits.py. Reviewer confirmed the scanner result. Scanner evidence (6, automated, can include false matches) `backtesting/engine.py:111` [max loss] max_loss: float = 0.0 `backtesting/engine.py:204` [stop loss] pos.stop_loss = s.risk.stop_loss_pct_of_max_loss * pos.max_loss `backtesting/metrics.py:34` [max drawdown] max_drawdown: float = 0.0 # $ (positive number) `config/risk_limits.yaml:51` [max position] max_open_positions: 3 `config/risk_limits.yaml:11` [daily loss limit] daily_loss_limit_pct: 0.015 # 1.50% of start-of-day equity, plus the planned max loss of any open multi-day position `core/config.py:5` [risk limit] Risk limits come only from config/risk_limits.yaml and cannot be
License	15 / 15	MIT (OSI approved) Reviewer confirmed the scanner result. Scanner evidence (1, automated, can include false matches) `LICENSE:1` License file
Last commit on default branch	15 / 15	2 days since last commit Fact from the commit date, no judgment involved. Scanner evidence (1, automated, can include false matches) `default branch HEAD` 2026-10-22 (2 days ago)
Tests	10 / 15	434 test cases found in 45 test files; CI test step not found Reviewer confirmed the scanner result. Scanner evidence (3, automated, can include false matches) `tests/test_arbitrage.py:1` 5 test cases `tests/test_backtest_report.py:1` 4 test cases `tests/test_black_scholes.py:1` 9 test cases
Paper or dry-run mode	15 / 15	documented and code or config switch Reviewer confirmed the scanner result. Scanner evidence (5, automated, can include false matches) `README.md:5` **A local-first research and paper-trading system for SPY options, built to find out honestly whether an edge exists, and to refuse to trade `.env.example:4` [paper-mode flag] ALPACA_BASE_URL=[link] `.env.example:4` [paper endpoint] ALPACA_BASE_URL=[link] `config/ibkr_paper.yaml:7` [IBKR paper port] port: 4002 # IB Gateway paper; TWS paper is 7497 (the bot tries both) `main.py:35` [dry-run flag] python main.py spike-short-shadow morning\|cover\|close\|status\|ibkr-check [--dry-run] Forward shadow log of the day-trade-only
README quality	10 / 10	install steps, config or env vars, explains what it does, risk disclaimer, 16088 chars Reviewer confirmed the scanner result. Scanner evidence (2, automated, can include false matches) `README.md:1` README with 16088 characters `README.md:201` <sub>Built by <a href="[link] For research and education. Options involve substantial risk, a
Broker detection	10 / 10	Alpaca (deps, code, readme); Interactive Brokers (deps, code, readme) Reviewer confirmed the scanner result. Scanner evidence (2, automated, can include false matches) `requirements.txt:1` [Alpaca: deps+code+readme] alpaca-py==0.44.0 `requirements.txt:12` [Interactive Brokers: deps+code+readme] ib_async==2.0.1
Total	95 / 100	Grades: A 85+, B 70+, C 55+, D 40+, F below.

Grades measure public repo hygiene on the scan date. They say nothing about profits, safety or security. We did not run this code. Full rubric and patterns.

Something wrong?

Report a correction Request removal (maintainers)

Corrections and removals are public GitHub issues. We reply within 7 days and every change is in the repo history. Sponsors get no special treatment: see our policy.

Badge for your README

Once the site has a public address, shields.io can read /badge/claytonhuck06--options-trading-bot.json from it. Badges show the grade and whether it was reviewed. Maintainers may use one without asking.