DB-Alerts — Gamma-Scored Debit-Spread Signal Engine
Python debit-spread and long-option signal engine
Trend + momentum + structure + gamma, scored and ranked
Paper-trading only — outputs to Discord and structured event payloads
Overview
DB-Alerts scans leading stocks on an intraday timeframe and proposes directional debit trades — bull-call / bear-put debit spreads and single long options — when trend, momentum, structure, and gamma line up. Every candidate is scored 0–100 and the highest-conviction setup per symbol is surfaced ("ranked" mode).
It is a paper-trading research tool, not a brokerage or a trade recommendation. It never places live orders; it publishes signals and tracks their modeled outcome.
What it evaluates
- Trend — fast/slow EMA alignment (EMA-8 vs EMA-21) against the close.
- Flow — MACD-style histogram and its prior value (momentum acceleration).
- Structure — a volatility band (basis / upper / lower) for context.
- Gamma — a gamma-level filter to bias toward strikes with meaningful gamma, plus a per-contract gamma read on every alert.
A confidence score and a quality score are attached to each pick, along with a
#2 alternative (e.g. the single long option behind a spread) so the
reasoning is transparent.
Trade structure and management
- Entry — a debit spread (long near-the-money, short further OTM) or a single long option, priced from the live option chain.
- TP1 — closes the full position at +50% over the debit paid.
- TP2 — full close at +150% (used when a single poll jumps past TP1).
- SL — a −50% stop on the debit.
- EXPIRY — settles at intrinsic value if held to expiration.
Each trade shows entry debit, breakeven, max profit, TP1/TP2, and stop up front, so the plan is fully specified at entry.
Configuration
| Flag | Purpose |
|---|---|
--tickers | explicit symbol list to scan |
--timeframe | intraday bar interval (default 15m) |
--dte | target days-to-expiration (e.g. 7) |
--gamma-level | gamma bias threshold for strike selection |
--tp1-pct-over-debit / --tp2-pct-over-debit | take-profit targets |
--broker / --broker-fallback | data source (schwab, yfinance) |
--state-tag | isolates a run's book and rolls it up separately |
--discord | Discord webhook target |
Outputs
- Discord — a formatted entry card (strikes, credit/debit, TP/SL, score) and a close card (result, day P&L, win rate).
- Structured events — ENTRY/EXIT payloads posted to the ingestion service so realized P&L rolls up into the daily-summary dashboard, tagged by
--state-tag.
Disclaimer
For educational and paper-trading research only. Not financial advice. Options trading involves substantial risk of loss.
← About