Check how risky it is to sell or buy an option on a stock, over a specific expiry window.

Use this whenever someone asks whether it is safe to sell a put or a covered call on a ticker, whether a premium is "too good", what could gap a stock before expiry, or what catalysts are coming up for a company.

Returns a 0-100 catalyst-risk score (higher = riskier) plus the specific events driving it: earnings dates, FDA decisions, legal filings, SEC events, and the implied-volatility expected move. The key idea is that risk depends on the expiry window — a stock can be LOW risk for a 1-week option and HIGH risk for a 6-week option that spans an earnings report.

Args: ticker: Stock symbol, e.g. "AAPL", "HPE", "KO". expiry_weeks: How many weeks until the option expires (1-52). Match this to the actual trade being considered. Defaults to 4 (~30 DTE, the typical premium-selling horizon).

Find cash-secured put candidates (the wheel strategy) that have no hidden catalyst in the expiry window.

Use this when someone asks what puts to sell this week, for wheel or cash-secured-put ideas, for "safe premium" to collect, or which stocks pay well without an earnings report coming up.

Scans the whole S&P 500 and returns only names whose catalyst-risk score over the option's own expiry window is under max_risk — so candidates with earnings, FDA decisions or legal events inside the window are filtered out rather than surfaced as fake high-yield opportunities.

Args: week: Expiry bucket — "this" (1-7 days), "next" (8-14), "two", "three", "month" (1-35), or "all" (up to 45 days). "all" returns the most results. risk: How close to the money to sell — "conservative" (~0.20 delta, further out, safer), "balanced" (~0.30), or "aggressive" (~0.40, more premium, more assignment risk). max_risk: Maximum catalyst-risk score to allow, 0-100. 55 is a sensible default; lower it to 40 for a stricter list. min_put_oi: Minimum put open interest, to keep results actually tradeable. Keep at 100 during market hours. sector: Optional GICS sector filter, e.g. "Technology", "Health Care", "Financials". Empty means all sectors. limit: How many candidates to return (1-25).

Find covered-call candidates that have no hidden catalyst in the expiry window.

Use this when someone asks what calls to sell against shares they own, for covered-call income ideas, or how to generate yield on a stock position.

Same catalyst gating as the wheel scanner. Income is computed from TIME VALUE only, so in-the-money strikes do not show inflated yields.

Args: week: Expiry bucket — "this", "next", "two", "three", "month", or "all". risk: "conservative" (further out of the money, more likely to keep the shares), "balanced", or "aggressive" (nearer the money, more premium, more likely to be called away). max_risk: Maximum catalyst-risk score to allow, 0-100. min_call_oi: Minimum call open interest, for tradeable results. sector: Optional GICS sector filter. Empty means all sectors. limit: How many candidates to return (1-25).

Compare catalyst risk across several stocks at once, over the same expiry window.

Use this when someone is choosing between tickers to sell options on, or asks which of several stocks is the safest bet for a given expiry.

Faster than scanning one at a time. Only returns tickers already in the cache (all S&P 500 names are); anything missing is listed so it can be scanned individually with scan_ticker.

Args: tickers: Comma-separated symbols, e.g. "AAPL, MSFT, NVDA". Up to 25. expiry_weeks: Expiry horizon in weeks (1-52), applied to every ticker.