Custom Alerts

Get notified when trades match your criteria

Define your criteria. We monitor every trade. You get notified instantly when something matches.

Availability: Gamma, Theta, and Vega plans

Quick Start

  1. Click bell icon (🔔)“Manage Custom Alerts”
  2. Click “Create Alert”
  3. Set criteria: Stock, Premium ≥ $100K, Unusual Score ≥ 70
  4. Select the delivery method
  5. Click “Create Alert”

Done. You’ll get notified when matching trades occur.

Alert 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

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

Your endpoint receives:

{
  "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": {}
}

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