Custom Alerts

Get notified when trades match your criteria

Custom Alerts turn Optionomics from something you watch into something that pings you when your rules hit. You define what counts—a fat print on a name you care about, a sweep above a premium threshold, a new AI trade idea that matches your style, or a piece of market commentary tagged with a severity you care about. When a match happens, we deliver through the channels you select (email, SMS, Slack, Discord, mobile push, webhook, and optionally the in-app Notifications feed).

Think of each alert as a small program: “If the market does X, tell me on Y.” Cooldowns throttle repeat fires so one noisy name does not blow up your phone; per-source criteria keep rules legible (option fields live with option alerts, trade-idea fields with trade ideas, and so on—you do not mix them on a single rule).

When alerts shine: You are away from the desk but want first touch on whales in your watchlist; you run a short list of underlyings into earnings; you want Slack or a webhook to fan out to a team or a journal. When alerts hurt is when criteria are too loose—start strict (higher premium, higher unusual score, fewer symbols), then relax if you are missing too much.

Availability: Option flow alerts — Gamma, Theta, and Vega. Trade idea and market commentary alerts require Theta or Vega (the same plans where those products exist). See Trade Ideas and Market Commentary.

In-app history: Notifications

Alert sources

Every alert has exactly one source at a time. When you create or edit an alert, choose Alert source first; the form then shows only the criteria that apply to that source:

Source	What triggers it
Option Alerts	A live option print matches your trade filters (premium, unusual score, DTE, sides, alert types, etc.).
Trade Ideas	A new AI trade idea matches your symbol, direction, strategy, and confidence filters.
Market Commentary	A new AI commentary post matches your symbol, category, and severity filters.

Cooldowns and notification channels apply to all sources. Each source uses its own criteria keys (you cannot mix option fields with trade-idea fields on the same alert).

Quick Start (option flow)

Click bell icon (🔔) → “Manage Custom Alerts”
Click “Create Alert”
Leave Alert source on Option Alerts
Set criteria: Stock, Premium ≥ $100K, Unusual Score ≥ 70
Select delivery channels
Click “Create Alert”

Done. You will be notified when matching trades occur.

For Trade Ideas or Market Commentary, select that source first, then fill only the criteria panel that appears for that source.

Option flow alerts — criteria

All criteria must match (AND logic).

Criteria	Description
Stock Symbol(s)	Up to 10 stocks, or blank for all stocks
Option Type	Call, Put, or Both
Premium Range	Min/Max in dollars (e.g., $50K - $1M)
Unusual Score	0-100 (use 70+ for quality signals, 85+ for high priority)
Order Side	AA (Above Ask), A (At Ask), M (Mid), B (At Bid), BB (Below Bid)
DTE Range	Days to expiration (e.g., 0-30 for near-term)
Volume/OI Ratio	Min ratio (>2.0 = fresh positioning, >5.0 = very unusual)
Alert Types	Specific patterns (see below)
Trade Types	Sweep, Block, ISO, Multi-leg

Alert Types

aggressive_call_buying - Calls bought at/above ask with size and premium
aggressive_put_buying - Puts bought at/above ask with size and premium
aggressive_call_selling - Calls sold at/below bid aggressively
aggressive_put_selling - Puts sold at/below bid aggressively
whale_trade - $500K+ premium OR 1000+ contracts
volume_spike - Trade size ≥10% of open interest
iv_spike - Implied volatility increasing ≥20%
short_term_options_activity - Significant trades with 0-7 DTE
consistent_call_buying - Pattern of repeated call accumulation
consistent_put_buying - Pattern of repeated put accumulation

Example Configurations

Whale Trades Only

Alert Types: whale_trade
Premium: $500,000+
Unusual Score: 85+
Side: AA, A (aggressive buying only)

Short-term Aggressive Calls

Option Type: Call
Alert Types: aggressive_call_buying
DTE: 0-14
Premium: $50,000+
Unusual Score: 70+
Side: AA, A

Volume Spikes on Specific Stocks

Symbols: AAPL, TSLA, NVDA
Alert Types: volume_spike
Volume/OI Ratio: 3.0+
Premium: $25,000+

Near-term Unusual Activity

DTE: 0-7
Unusual Score: 80+
Premium: $100,000+
Alert Types: short_term_options_activity

Trade idea alerts

Triggers when a new trade idea is created and every configured criterion matches. Leave Stock symbol blank on the form to watch all symbols (only trade-idea-specific fields are stored).

Criteria	Description
Stock Symbol	One ticker, or blank for any symbol
Direction	Bullish, bearish, neutral, or any
Strategy	e.g. buy call, bull call spread, long stock — or any
Minimum Confidence	0.0–1.0; idea must meet or exceed this AI confidence

→ Product overview: Trade Ideas

Market commentary alerts

Triggers when a new commentary row is saved and every criterion matches. Use Stock symbol to require that ticker to appear in the commentary’s symbol list (or leave blank for any).

Criteria	Description
Stock Symbol	Commentary must tag this symbol, or blank for any
Category	e.g. unusual activity, whale trade, flow shift — or any
Minimum Severity	Info, notable, or critical — fires at that level or higher

→ Product overview: Market Commentary

Notification Channels

Channel	Setup
Browser	Automatic
Email	No setup required
SMS	Add phone in account settings
Mobile Push	Install app, enable Push
Slack	Add webhook URL
Discord	Add webhook URL
Webhook	Add your endpoint URL

Cooldown

Set minimum time between notifications (1 minute to 1 day). Recommended: 30 minutes.

Webhook Integration

Slack

Slack → Apps → Incoming Webhooks → Add to Slack
Copy webhook URL
Paste in alert settings

Discord

Discord → Server Settings → Integrations → Webhooks
Copy webhook URL
Paste in alert settings

Generic Webhook

Option alert payloads look like:

{
  "alert_name": "AAPL Whale Trades",
  "stock_symbol": "AAPL",
  "option_type": "call",
  "strike": 150.0,
  "premium": 250000.0,
  "dte": 7,
  "sentiment": "bullish",
  "unusual_score": 85.3,
  "triggered_at": "2024-01-15T10:30:00Z",
  "matched_criteria": {}
}

Trade idea webhook (source: "trade_idea"):

{
  "alert_name": "High confidence bullish",
  "source": "trade_idea",
  "symbol": "NVDA",
  "direction": "bullish",
  "strategy": "buy_call",
  "entry_price": 142.5,
  "target_price": 148.0,
  "stop_price": 139.0,
  "confidence_score": 0.82,
  "triggered_at": "2026-03-25T14:22:00Z",
  "matched_criteria": {}
}

Market commentary webhook (source: "market_commentary"):

{
  "alert_name": "Critical tape only",
  "source": "market_commentary",
  "headline": "Massive Call Buying on NVDA",
  "body": "Short narrative with cited figures.",
  "category": "unusual_activity",
  "severity": "critical",
  "symbols": ["NVDA"],
  "triggered_at": "2026-03-25T14:22:00Z",
  "matched_criteria": {}
}

Return HTTP 200 for success. Timeout: 10 seconds.

Best Practices

Start specific: One stock, high threshold, then broaden
Use cooldowns: 30 minutes minimum
Combine criteria: Premium + Score + Side for quality
Review weekly: Adjust based on trigger frequency
Aim for 3-10 triggers/day: Too many = noise

Ready? Go to Custom Alerts and create your first alert.

Remember: Alerts identify opportunities—they’re not trading recommendations. Always do your own analysis.