Custom Alerts

Get notified when trades match your criteria

Define your criteria. We monitor the tape, new trade ideas, and market commentary posts. You get notified when something matches.

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

In-app history: Notifications

Alert sources

When you create or edit an alert, choose Alert 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)

  1. Click bell icon (🔔)“Manage Custom Alerts”
  2. Click “Create Alert”
  3. Leave Alert source on Option Alerts
  4. Set criteria: Stock, Premium ≥ $100K, Unusual Score ≥ 70
  5. Select delivery channels
  6. 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

  1. Slack → AppsIncoming WebhooksAdd to Slack
  2. Copy webhook URL
  3. Paste in alert settings

Discord

  1. Discord → Server SettingsIntegrationsWebhooks
  2. Copy webhook URL
  3. 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

  1. Start specific: One stock, high threshold, then broaden
  2. Use cooldowns: 30 minutes minimum
  3. Combine criteria: Premium + Score + Side for quality
  4. Review weekly: Adjust based on trigger frequency
  5. 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.


Optionomics Documentation

Getting Started
Main Features
Daily Analytics
Historical Analytics

Optionomics Documentation