Options Sniper - Trading Agent

Options Sniper is a fully autonomous Bull Call Spread paper-trading agent built for the Alpaca Options Alpha Agents hackathon. It discovers, evaluates, and executes options spread opportunities using 13 Alpaca API endpoints — zero database, zero external AI, zero paid services. DYNAMIC MARKET DISCOVERY replaces static watchlists. Each tick fetches top gainers, losers, and most-active stocks from Alpaca's screener, qualifies them for options availability and momentum, and merges with a default watchlist — capped at 15 sniper candidates. OPTIONS INTELLIGENCE enriches each spread using Alpaca's option snapshots: Greeks (Delta, Gamma, Theta, Vega), IV, volume, OI, and bid/ask spreads. A 0-100 Quality score (spread 40pts + OI 30pts + volume 20pts + IV sweet spot 10pts) adds +0 to +10 to the opportunity score. NEWS & CORPORATE ACTION RISK checks Alpaca's news and corporate-actions APIs before trading. Sentiment is classified via deterministic keywords (no LLM): positive (beat, upgrade, rally) vs. negative (miss, lawsuit, SEC probe). Corporate actions — dividends, splits, mergers — are flagged when ex-dates are near. Impact ≤ -5 rejects the trade. News adds -5 to +5 to the score. AGENT FLOW: Account → Discovery → News/CA Risk → Options Chain → Greeks/Liquidity → Score → Risk Check → Paper Order → Monitor → Auto-Exit. Score 0-120: trend 25, RSI 20, momentum 20, liquidity 15, risk/reward 20, options quality +10, news ±5. Entry requires score ≥ 75, risk ≤ 1% equity. Auto-exit: +25% profit, -20% loss, ≤7 DTE, or bearish reversal. Mleg orders with slippage cushion. Short legs close first to avoid 403 errors. The Alpaca Monitor shows every API call — endpoint, latency, status, sanitized responses — in a 7-step pipeline. Paper trading enforced by hard URL guard. Full mock mode for keyless demos. Next.js 15, React 19, Tailwind 4, Vercel. Serverless. Stateless. Alpaca is the source of truth.