🤖 AI Momentum Trader — Stocks & Options on Robinhood, hands off

One AI-picked momentum trade a day. Stocks, options, or both. You pick the risk with one word, pick the asset mode with one word, and pick the AI brain (Claude, OpenAI, Grok, or Gemini) with one word. Everything that touches your money — sizing, stops, the daily loss breaker, the options expiry guard — is plain, deterministic Python you can read. The AI only decides what to buy.

🎛️ Don't want to edit code by hand? Use the interactive Config Builder — flip the toggles, copy your generated config, paste it in. (Enable GitHub Pages on this repo and it's a live webpage.)

⚠️ READ THIS FIRST — the honest version

This is an experiment, not a money machine.

• It trades real money with no approval prompts (--dangerously-skip-permissions on purpose, so it can run unattended).
• Options can go to ZERO. A long call or put is defined-risk, but "defined" includes losing 100% of the premium. Fast.
• On the degen profile it puts your whole balance behind ONE idea.
• It holds overnight. Gaps and after-hours news can blow through any stop.
• Robinhood requires options approval on your account before options mode will work at all.
• The code is unaudited, and the AI can be wrong.

Not financial advice. No warranty. Use money you can fully afford to lose, and start with a tiny balance until you trust it.

How it's wired

Your computer wakes the bot every minute. It reads your account, quotes, and option chains through the Robinhood agentic MCP, asks your chosen AI for one pick (name + direction + instrument + conviction), does its own risk math, places the order, and (optionally) pings you on Telegram. Nothing runs in the cloud.

🎛️ The three toggles

Toggle 1 — Risk profile (one word)

ACTIVE_PROFILE = "normal"   # "conservative" | "normal" | "degen" | "custom"

Toggle 2 — Asset mode (one word)

"asset_mode": "stocks",   # "stocks" | "options" | "both"

• "stocks" — shares only. The classic bot.
• "options" — single-leg long calls (long puts too if you flip allow_puts on).
• "both" — the AI chooses shares vs. a contract per pick; falls back to shares if a contract doesn't fit the budget.

Toggle 3 — AI brain (one word)

"pick_provider": "claude",   # "claude" | "openai" | "grok" | "gemini"

Claude is the default: no API key, and it can web-search fresh catalysts. The other three need their API key set as an environment variable. Order execution always runs through the Robinhood MCP via Claude Code no matter which brain you pick.

What you need

1. A computer that stays on and awake during market hours (Windows / macOS / Linux).
2. Python 3.9+ (python --version).
3. Claude Code CLI, logged in — this is the broker bridge.
4. A Robinhood account with agentic trading enabled (and options approval if you want options mode).
5. Optional: an OpenAI / xAI / Gemini API key, only if you want that brain to pick.
6. Optional: a Telegram bot for a text on every buy and sell.

Setup, step by step

• Windows: install from python.org. On the first installer screen tick "Add python.exe to PATH." Then open a NEW terminal:

  python --version
  

• macOS: brew install python or python.org.
• Linux: almost certainly installed. python3 --version.

You want 3.9 or newer.

Follow Anthropic's current install guide for Claude Code, then:

claude --version     # prints a version = installed
claude               # run once, log in, then /exit
claude -p "say hi"   # headless works = you're good

If claude -p says "Invalid API key", you have a stale ANTHROPIC_API_KEY environment variable overriding your login. Delete it, open a new terminal, log in with plain claude.

claude mcp add -s user --transport sse robinhood https://agent.robinhood.com/mcp/trading

If it later shows "Failed to connect," it's usually the transport. Remove and re-add with the other one:

claude mcp remove -s user robinhood
claude mcp add -s user --transport http robinhood https://agent.robinhood.com/mcp/trading

Then open interactive claude, run /mcp, select robinhood, and finish the login in your browser. Confirm:

claude mcp list      # robinhood should show connected

claude -p "Call get_accounts and return only JSON listing each account_number and its agentic_allowed flag." --allowedTools "mcp__robinhood__get_accounts" --dangerously-skip-permissions

Write down the account number that shows agentic_allowed: true. That's the account the bot trades. If this returns your account, the whole pipeline works.

Options mode only: your Robinhood account also needs options trading approval (Robinhood app → account settings → options). Without it, options orders will simply fail.

Green Code button → Download ZIP → unzip. Or:

git clone https://github.com/merjua14/ai-momentum-trader.git
cd ai-momentum-trader
python -m pip install -r requirements.txt

(The only dependency is tzdata, and only Windows actually needs it.)

Easiest path: open the Config Builder, flip your toggles, hit copy, and paste the generated block over the top of momentum_trader.py.

By hand, set at the top of momentum_trader.py:

• ACTIVE_PROFILE — "conservative", "normal", "degen", or "custom".
• CONFIG["account_number"] — the agentic account number from Step 4.
• CONFIG["asset_mode"] — "stocks", "options", or "both".
• CONFIG["allow_puts"] — True if you want bearish trades via long puts.
• CONFIG["pick_provider"] — which AI picks.
• CONFIG["universe"] — the tickers it may choose from. Keep them liquid; wide option spreads eat you alive in options mode.
• CONFIG["extra_pick_guidance"] — your own standing instructions to the AI, e.g. "Only large caps. Avoid earnings weeks. Favor AI and energy."

1. Get the key: platform.openai.com / console.x.ai / aistudio.google.com.
2. Set it as an environment variable:

# Windows (PowerShell), then open a NEW terminal
setx OPENAI_API_KEY "your_key_here"        # or XAI_API_KEY / GEMINI_API_KEY

# macOS / Linux — add to ~/.zshrc or ~/.bashrc
export OPENAI_API_KEY="your_key_here"

3. Set pick_provider and the matching model name in CONFIG. Model names change over time — if a provider rejects the string, set whatever your account currently lists.

1. Message @BotFather on Telegram → /newbot → copy the token.
2. Message your new bot once (it can't text you first).
3. Open https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates and find the numeric "id" under "chat".
4. Set TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID as environment variables (same pattern as Step 7).

python momentum_trader.py --once

Outside market hours it prints "Outside the session. Idle." — that's correct. During the session it warms up, scores the universe, runs the pick, and either enters or passes. Start with a tiny balance and watch a full trade go through before you automate anything.

Windows (Task Scheduler via PowerShell):

$py  = (python -c "import sys; print(sys.executable)")
$dir = "C:\path\to\ai-momentum-trader"

$action  = New-ScheduledTaskAction -Execute $py -Argument "momentum_trader.py --once" -WorkingDirectory $dir
$trigger = New-ScheduledTaskTrigger -Daily -At 9:00am
$trigger.Repetition = (New-ScheduledTaskTrigger -Once -At 9:00am `
    -RepetitionInterval (New-TimeSpan -Minutes 1) `
    -RepetitionDuration (New-TimeSpan -Hours 8)).Repetition
$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable `
    -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries `
    -MultipleInstances IgnoreNew -ExecutionTimeLimit (New-TimeSpan -Minutes 5)

Register-ScheduledTask -TaskName "MomentumTrader" -Action $action -Trigger $trigger -Settings $settings

MultipleInstances IgnoreNew matters — it stops a slow tick from double-trading.

macOS / Linux (cron): crontab -e, then:

* * * * 1-5 cd ~/ai-momentum-trader && /usr/bin/python3 momentum_trader.py --once >> ~/.momentum_trader.log 2>&1

The bot idles outside its session window, so every-minute-all-day is fine. Keep the machine awake (caffeinate -s on macOS).

Or just leave a loop running:

python momentum_trader.py --loop

📟 Monitoring and the kill switch

# watch the log live
tail -f ~/.momentum_trader.log                                  # mac/Linux
Get-Content ~\.momentum_trader.log -Tail 20 -Wait               # Windows

# see the live position, peak, and current stop
~/.momentum_trader_state.json

To stop it fast: disable the scheduled task / comment out the cron line / kill the loop. The max_daily_loss_usd circuit breaker also halts new entries by itself after a losing day. And you can always just sell in the Robinhood app — the bot reconciles against the broker every tick and goes flat instead of freezing.

🛡️ How the safety rails work

• At most one entry per day. Never buy on a day you sold — so on a cash account under T+1, the money behind any buy has already settled. A good-faith violation is structurally impossible.
• Sized to settled cash, not raw buying power.
• Options expiry guard: any contract is force-closed at opt_close_dte days before expiration (default 1), no matter what the stop says. You will not wake up to an expired worthless contract that the stop never got to.
• Premium stops: options are stopped on the contract's mark (its own price), with wider bands than stock because premium moves several times faster.
• Daily loss breaker: after max_daily_loss_usd of realized loss, no new entries that day.
• Broker reconciliation: every tick the bot checks its records against your real account. A manual sale can't freeze it.

Per-profile risk knobs:

Top-level CONFIG:

Files in this repo

• momentum_trader.py — the trader. All risk math lives here.
• docs/index.html — the interactive Config Builder (works locally or on GitHub Pages).
• SKILL.md — the strategy playbook in plain language.
• architecture.svg, flow.svg — the diagrams above.
• requirements.txt, LICENSE (MIT).

Not financial advice. No warranty. Options involve substantial risk and are not suitable for everyone — read the OCC's Characteristics and Risks of Standardized Options. Trade at your own risk. The author is not responsible for your losses.