431 lines
12 KiB
Markdown
431 lines
12 KiB
Markdown
# Trade Signal & Strategy Enhancement Features
|
|
|
|
This document describes the comprehensive enhancements made to the institutional trading system, transforming badge combinations into actionable trade signals and adding advanced pattern detection capabilities.
|
|
|
|
## Overview
|
|
|
|
The system has been enhanced with three major tiers of improvements:
|
|
|
|
### TIER 1 (Completed) ✅
|
|
- Trade Signal Generation from Badge Combinations
|
|
- Flow Decay Detection
|
|
- Signal Convergence Detection
|
|
|
|
### TIER 2 (Completed) ✅
|
|
- Playbook Generator (Pattern Detection)
|
|
- Trade Plan Generator
|
|
- Strategy Backtester
|
|
|
|
---
|
|
|
|
## 1. Trade Signal Generation (Script 1 - Options Flow)
|
|
|
|
### Features Added
|
|
|
|
#### A. Badge Combinations → Trade Signals
|
|
|
|
The system now automatically converts badge patterns into actionable trade signals:
|
|
|
|
**Pattern 1: Institutional FOMO (BUY)**
|
|
- Criteria: 🟢 + 💎 + ⭐ + 💰 + ⚡
|
|
- Signal: BUY
|
|
- Entry: Next VWAP pullback (wait for retest)
|
|
- Stop: -1.5% or below opening range low
|
|
- Target: Next gamma strike or +3%
|
|
|
|
**Pattern 2: Institutional Distribution (SHORT)**
|
|
- Criteria: 🔴 + 💎 + ⭐ + 💰
|
|
- Signal: SHORT
|
|
- Entry: Next rally into VWAP or resistance
|
|
- Stop: +1.5% or above opening range high
|
|
- Target: Prior day low or -3%
|
|
|
|
**Pattern 3: Trap Warning (WAIT)**
|
|
- Criteria: 🟢 but TapeAlign = blank
|
|
- Signal: WAIT
|
|
- Action: Flow bullish but price NOT confirming = potential reversal
|
|
|
|
**Pattern 4: Slow Accumulation (BUY)**
|
|
- Criteria: 🟢 + 💎 but NO ⚡
|
|
- Signal: BUY (Swing Trade)
|
|
- Action: Build position over 2-3 days (swing trade, not scalp)
|
|
|
|
#### B. Flow Decay Detection
|
|
|
|
Tracks when institutional flow stops and flags potential retail FOMO or distribution phases:
|
|
|
|
- **Last Flow Timestamp**: Tracks when last flow occurred per ticker
|
|
- **Decay Thresholds**:
|
|
- 30+ minutes = CAUTION
|
|
- 60+ minutes = STRONG_DECAY
|
|
- **Signals**:
|
|
- Flow stopped + Price rising = FADE (retail chasing)
|
|
- Flow stopped + Price dropping = AVOID (no one stepping in)
|
|
|
|
**Example Output:**
|
|
```
|
|
AAPL | 🚀🚀 | Last Flow: 45min ago | Price: Still rising | Signal: FADE (retail chasing)
|
|
TSLA | 🚀🚀🚀 | Last Flow: 5min ago | Price: Rising | Signal: ACTIVE (institutions still buying)
|
|
```
|
|
|
|
#### C. Flow Reversal Detection
|
|
|
|
Detects when net premium direction flips (institutions switching sides):
|
|
|
|
- **Trajectory Tracking**: Monitors net premium over 30-minute windows
|
|
- **Reversal Alerts**: Flags when flow flips from BULL to BEAR (or vice versa)
|
|
- **Auto-Alert**: "⚠️ FLOW REVERSAL: XYZ flipped from BULL to BEAR at 10 AM"
|
|
|
|
### API Endpoints
|
|
|
|
**GET /api/options/flow**
|
|
- Now includes:
|
|
- `tradeSignal`: Complete trade signal object
|
|
- `tradeSignalDisplay`: Formatted display string
|
|
- `flowDecay`: Flow decay analysis
|
|
- `flowReversal`: Flow reversal detection
|
|
- `metadata`: Summary of decay and reversals
|
|
|
|
**Example Response:**
|
|
```json
|
|
{
|
|
"success": true,
|
|
"data": [
|
|
{
|
|
"Symbol": "AAPL",
|
|
"tradeSignal": {
|
|
"signal": "BUY",
|
|
"type": "INSTITUTIONAL_FOMO",
|
|
"confidence": 85,
|
|
"entry": {
|
|
"primary": "Wait for pullback to $175.20 (VWAP retest)",
|
|
"aggressive": "Market order if breaks $176.50 (opening range high)"
|
|
},
|
|
"stop": {
|
|
"tight": "$174.00 (-0.8% risk)",
|
|
"wide": "$172.50 (-1.5% risk or below opening range low)"
|
|
},
|
|
"target": {
|
|
"t1": "$178.50 (+1.5%, take 50%)",
|
|
"t2": "$180.00 (+2.3%, take 30%)",
|
|
"t3": "$182.00 (+3.4%, runner 20%)"
|
|
}
|
|
},
|
|
"flowDecay": {
|
|
"display": "🟢 ACTIVE | Last Flow: 5min ago",
|
|
"status": "ACTIVE"
|
|
}
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 2. Multi-Signal Scanner Enhancements (Script 4)
|
|
|
|
### Features Added
|
|
|
|
#### A. Signal Convergence Detection
|
|
|
|
Flags tickers where 3+ signals fire within 10 minutes:
|
|
|
|
- **Label**: "🔥 CONVERGENCE EVENT"
|
|
- **Reasoning**: "Dark pool + Options + Breakout = Institutional momentum ignition"
|
|
|
|
**Example:**
|
|
```
|
|
NVDA at 10:15 AM:
|
|
- Dark/Block Cluster (3 pts)
|
|
- Options + Prints (3 pts)
|
|
- 52W High + $Vol (2 pts)
|
|
Total Score: 8 → CONVERGENCE EVENT
|
|
```
|
|
|
|
#### B. Stealth vs Aggressive Classification
|
|
|
|
Classifies trade horizon based on signal characteristics:
|
|
|
|
- **SCALP**: ORB + Shock Tape + high rVol = minutes to hours
|
|
- **INTRADAY**: Options + Prints + RTH session = 2-4 hours
|
|
- **SWING**: Stealth Dark + low rVol = 1-5 days
|
|
|
|
**Example Output:**
|
|
```
|
|
AAPL | Score: 7 | Convergence: Yes | Horizon: INTRADAY | Reason: Options + Block prints
|
|
TSLA | Score: 6 | Convergence: No | Horizon: SWING | Reason: Stealth dark accumulation
|
|
```
|
|
|
|
#### C. False Signal Filtering
|
|
|
|
Filters out retail noise and spoofed liquidity:
|
|
|
|
1. **Dumb Money Trap Detection**
|
|
- Options flow appears BUT it's all OTM lotto tickets (>20% OTM)
|
|
- Volume spike BUT it's all retail platforms (9:30-10 AM)
|
|
- Action: Flag as "⚠️ Retail Noise - Fade This"
|
|
|
|
2. **Spoofed Liquidity Detection**
|
|
- Dark pool prints appear BUT price doesn't move
|
|
- Block prints appear BUT immediately followed by opposite side
|
|
- Action: Flag as "🚫 Fake Flow - Ignore"
|
|
|
|
3. **End-of-Day Noise Detection**
|
|
- Signals fire in last 30min (3:30-4 PM)
|
|
- Often MOC rebalancing, not directional
|
|
- Action: Flag as "⏰ MOC Noise - Wait for Tomorrow"
|
|
|
|
### API Endpoints
|
|
|
|
**GET /api/scanner/multi-signal**
|
|
- Now includes:
|
|
- `convergence`: Convergence detection results
|
|
- `tradeHorizon`: SCALP/INTRADAY/SWING classification
|
|
- `falseSignalFilter`: Filtering results with warnings
|
|
|
|
---
|
|
|
|
## 3. Trade Plan Generator
|
|
|
|
### Features
|
|
|
|
Auto-generates comprehensive trade plans for every high-score signal:
|
|
|
|
**Components:**
|
|
- Entry Strategy (Primary + Aggressive)
|
|
- Stop Loss (Tight + Wide)
|
|
- Profit Targets (T1, T2, T3 with scaling)
|
|
- Time Horizon (Expected + Max Hold)
|
|
- Reasoning (Why this setup works)
|
|
- Invalidation Conditions (When to exit)
|
|
- Historical Win Rate (Similar setups performance)
|
|
|
|
**Example Output:**
|
|
```json
|
|
{
|
|
"symbol": "AAPL",
|
|
"signal": "BUY",
|
|
"confidence": "85%",
|
|
"score": 8.5,
|
|
"entryStrategy": {
|
|
"primary": "Wait for pullback to $175.20 (VWAP retest)",
|
|
"aggressive": "Market order if breaks $176.50 (opening range high)"
|
|
},
|
|
"stopLoss": {
|
|
"tight": "$174.00 (-0.8% risk)",
|
|
"wide": "$172.50 (-1.5% risk or below opening range low)"
|
|
},
|
|
"profitTargets": {
|
|
"t1": "$178.50 (+1.5%, take 50%)",
|
|
"t2": "$180.00 (+2.3%, take 30%)",
|
|
"t3": "$182.00 (+3.4%, runner 20%)"
|
|
},
|
|
"timeHorizon": {
|
|
"expected": "2-4 hours",
|
|
"maxHold": "EOD (cut if no move)"
|
|
},
|
|
"reasoning": "Badge: 🟢 | Badges: 💎⭐💰 | Tape alignment: ↗︎ | Options flow: $5M net bullish",
|
|
"invalidation": [
|
|
"If breaks below $172.50, INSTITUTIONS WRONG → Exit immediately",
|
|
"If no follow-through in 30min → Exit breakeven",
|
|
"If new bearish flow appears → Reverse bias"
|
|
]
|
|
}
|
|
```
|
|
|
|
### API Endpoints
|
|
|
|
**POST /api/trade-plans/generate**
|
|
- Request body:
|
|
```json
|
|
{
|
|
"signalData": { /* options flow or scanner result */ },
|
|
"priceData": { /* optional - will fetch if not provided */ },
|
|
"options": {
|
|
"includeHistoricalWinRate": true,
|
|
"lookbackDays": 60
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 4. Playbook Generator (Daily Post-Mortem)
|
|
|
|
### Features
|
|
|
|
Auto-detects repeatable patterns from historical data:
|
|
|
|
**Pattern 1: FDA Approval Squeeze**
|
|
- Criteria:
|
|
- news_fda = 1
|
|
- first_cross_session = PRE
|
|
- opt_notional_bull > 2x bear
|
|
- max_abs_pct_rth > max_abs_pct_pre
|
|
- Historical Win Rate: Calculated from last 90 days
|
|
- Trade Setup: Enter at RTH open IF gap holds
|
|
|
|
**Pattern 2: Earnings Beat Fade**
|
|
- Criteria:
|
|
- news_earnings = 1
|
|
- first_cross_session = POST
|
|
- max_abs_pct_post > max_abs_pct_rth
|
|
- opt_notional_bear > bull
|
|
- Historical Win Rate: Calculated from last 90 days
|
|
- Trade Setup: Enter SHORT if gap opens but fades below VWAP
|
|
|
|
**Pattern 3: Options Flow Pre-Positioning**
|
|
- Detects exponential growth in options flow 1-3 days before events
|
|
- Signal: "⚠️ XYZ options flow surging 3 days before earnings → Bullish setup"
|
|
|
|
### API Endpoints
|
|
|
|
**GET /api/analysis/playbooks**
|
|
- Query params:
|
|
- `lookbackDays` (default: 90)
|
|
- `minOccurrences` (default: 5)
|
|
- `minWinRate` (default: 0.60)
|
|
- Returns: Top 10 patterns sorted by win rate and expectancy
|
|
|
|
---
|
|
|
|
## 5. Strategy Backtester
|
|
|
|
### Features
|
|
|
|
Validates signals with historical win rates:
|
|
|
|
**Capabilities:**
|
|
- Queries historical matches for pattern criteria
|
|
- Calculates outcomes (WIN/LOSS) based on price movement
|
|
- Aggregates statistics:
|
|
- Win Rate
|
|
- Average Win %
|
|
- Average Loss %
|
|
- Expectancy
|
|
- Risk:Reward Ratio
|
|
- Identifies best/worst setup conditions
|
|
|
|
**Example Output:**
|
|
```
|
|
PATTERN: 🚀🚀🚀 + Tape Alignment + RTH
|
|
|
|
Historical Performance (Last 90 Days):
|
|
- Total Occurrences: 127
|
|
- Wins: 89 (70.1%)
|
|
- Losses: 38 (29.9%)
|
|
- Avg Win: +2.7%
|
|
- Avg Loss: -1.3%
|
|
- Expectancy: +1.5% per trade
|
|
- Best Setup: When premium > $1M (79% win rate)
|
|
- Worst Setup: When first 30min after open (58% win rate)
|
|
```
|
|
|
|
### API Endpoints
|
|
|
|
**POST /api/analysis/backtest**
|
|
- Request body:
|
|
```json
|
|
{
|
|
"pattern": {
|
|
"name": "Rocket + Tape Alignment",
|
|
"minRocketScore": 5.0,
|
|
"requireTapeAlignment": true,
|
|
"session": "RTH",
|
|
"minMove": 1.0
|
|
},
|
|
"options": {
|
|
"lookbackDays": 90,
|
|
"minOccurrences": 10
|
|
}
|
|
}
|
|
```
|
|
|
|
**POST /api/analysis/backtest-multiple**
|
|
- Backtests multiple patterns and returns top 10 strategies
|
|
|
|
---
|
|
|
|
## Implementation Files
|
|
|
|
### New Services
|
|
- `backend/src/services/tradeSignalGenerator.js` - Trade signal generation
|
|
- `backend/src/services/flowDecayDetector.js` - Flow decay detection
|
|
- `backend/src/services/flowReversalDetector.js` - Flow reversal detection
|
|
- `backend/src/services/scannerEnhancer.js` - Scanner enhancements
|
|
- `backend/src/services/tradePlanGenerator.js` - Trade plan generation
|
|
- `backend/src/services/playbookGenerator.js` - Playbook generation
|
|
- `backend/src/services/strategyBacktester.js` - Strategy backtesting
|
|
|
|
### Updated Routes
|
|
- `backend/src/routes/optionsFlow.js` - Added trade signals, flow decay, flow reversal
|
|
- `backend/src/routes/scanner.js` - Added convergence, horizon, false signal filtering
|
|
- `backend/src/routes/dailyAnalysis.js` - Added playbooks and backtesting endpoints
|
|
- `backend/src/routes/tradePlans.js` - New route for trade plan generation
|
|
- `backend/src/server.js` - Added trade plans route
|
|
|
|
---
|
|
|
|
## Usage Examples
|
|
|
|
### 1. Get Options Flow with Trade Signals
|
|
```bash
|
|
GET /api/options/flow?startDate=2024-01-01&endDate=2024-01-31
|
|
```
|
|
|
|
### 2. Get Enhanced Scanner Results
|
|
```bash
|
|
GET /api/scanner/multi-signal
|
|
```
|
|
|
|
### 3. Generate Trade Plan
|
|
```bash
|
|
POST /api/trade-plans/generate
|
|
{
|
|
"signalData": {
|
|
"Symbol": "AAPL",
|
|
"badges": { "round": "🟢", "more": "💎⭐💰", "flash": "⚡" },
|
|
"rocketScore": 8.5,
|
|
"tapeAligned": true
|
|
}
|
|
}
|
|
```
|
|
|
|
### 4. Get Playbooks
|
|
```bash
|
|
GET /api/analysis/playbooks?lookbackDays=90&minWinRate=0.65
|
|
```
|
|
|
|
### 5. Backtest Strategy
|
|
```bash
|
|
POST /api/analysis/backtest
|
|
{
|
|
"pattern": {
|
|
"name": "Institutional FOMO",
|
|
"minRocketScore": 5.0,
|
|
"requireTapeAlignment": true,
|
|
"session": "RTH"
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Next Steps
|
|
|
|
1. **Frontend Integration**: Update frontend components to display new trade signals and plans
|
|
2. **Real-time Alerts**: Add WebSocket notifications for flow reversals and convergence events
|
|
3. **Advanced Pattern Matching**: Expand playbook generator with more pattern types
|
|
4. **Machine Learning**: Use historical data to improve confidence scoring
|
|
5. **Performance Monitoring**: Track actual trade outcomes vs predicted signals
|
|
|
|
---
|
|
|
|
## Notes
|
|
|
|
- All new features are backward compatible with existing API responses
|
|
- Historical win rate calculations require sufficient data (minimum 10-20 occurrences)
|
|
- Flow decay and reversal detection work best with real-time data updates
|
|
- Trade plan generation requires current price data (fetched automatically if not provided)
|
|
|