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
- Click bell icon (🔔) → “Manage Custom Alerts”
- Click “Create Alert”
- Set criteria: Stock, Premium ≥ $100K, Unusual Score ≥ 70
- Select the delivery method
- 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 premiumaggressive_put_buying- Puts bought at/above ask with size and premiumaggressive_call_selling- Calls sold at/below bid aggressivelyaggressive_put_selling- Puts sold at/below bid aggressivelywhale_trade- $500K+ premium OR 1000+ contractsvolume_spike- Trade size ≥10% of open interestiv_spike- Implied volatility increasing ≥20%short_term_options_activity- Significant trades with 0-7 DTEconsistent_call_buying- Pattern of repeated call accumulationconsistent_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 |
| 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
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
- 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.