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)
- 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 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
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 |
| 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.