12 KiB

Raw Blame History

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:

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

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

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

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

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

GET /api/options/flow?startDate=2024-01-01&endDate=2024-01-31

2. Get Enhanced Scanner Results

GET /api/scanner/multi-signal

3. Generate Trade Plan

POST /api/trade-plans/generate
{
  "signalData": {
    "Symbol": "AAPL",
    "badges": { "round": "🟢", "more": "💎⭐💰", "flash": "⚡" },
    "rocketScore": 8.5,
    "tapeAligned": true
  }
}

4. Get Playbooks

GET /api/analysis/playbooks?lookbackDays=90&minWinRate=0.65

5. Backtest Strategy

POST /api/analysis/backtest
{
  "pattern": {
    "name": "Institutional FOMO",
    "minRocketScore": 5.0,
    "requireTapeAlignment": true,
    "session": "RTH"
  }
}

Next Steps

Frontend Integration: Update frontend components to display new trade signals and plans
Real-time Alerts: Add WebSocket notifications for flow reversals and convergence events
Advanced Pattern Matching: Expand playbook generator with more pattern types
Machine Learning: Use historical data to improve confidence scoring
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)

12 KiB Raw Blame History

Trade Signal & Strategy Enhancement Features

Overview

TIER 1 (Completed) ✅

TIER 2 (Completed) ✅

1. Trade Signal Generation (Script 1 - Options Flow)

Features Added

A. Badge Combinations → Trade Signals

B. Flow Decay Detection

C. Flow Reversal Detection

API Endpoints

2. Multi-Signal Scanner Enhancements (Script 4)

Features Added

A. Signal Convergence Detection

B. Stealth vs Aggressive Classification

C. False Signal Filtering

API Endpoints

3. Trade Plan Generator

Features

API Endpoints

4. Playbook Generator (Daily Post-Mortem)

Features

API Endpoints

5. Strategy Backtester

Features

API Endpoints

Implementation Files

New Services

Updated Routes

Usage Examples

1. Get Options Flow with Trade Signals

2. Get Enhanced Scanner Results

3. Generate Trade Plan

4. Get Playbooks

5. Backtest Strategy

Next Steps

Notes

12 KiB

Raw Blame History