TIME-SPLT ACADEMY INDICATOR

# TIME-SPLT ACADEMY CISD + FVG + TSM FRACTALS - Comprehensive Market Structure Analysis Tool

## Overview
This indicator combines three essential market structure analysis components into a unified trading tool: Change in State Direction (CISD), Fair Value Gaps (FVG), and TSM Fractals. This integration provides traders with a complete framework for identifying market structure breaks, price imbalances, and key pivot levels on any timeframe.

## Component 1: CISD (Change in State Direction)
**What it is:** CISD identifies significant breaks in market structure by tracking when price decisively breaks above previous swing highs (bullish CISD) or below previous swing lows (bearish CISD). This concept is fundamental to understanding trend changes and continuation patterns.

**How it works:**
- Monitors swing highs and lows using customizable pivot periods
- Tracks when price closes above a previous swing high (bullish structure break)
- Tracks when price closes below a previous swing low (bearish structure break)
- Draws horizontal lines from the pivot point to the break point with "CISD" labels
- Works on multiple timeframes simultaneously

**Trading Applications:**
- Identifies trend changes and continuation signals
- Provides entry signals on structure breaks
- Helps determine market bias and direction

## Component 2: FVG (Fair Value Gaps)
**What it is:** Fair Value Gaps are price imbalances that occur when there's a gap between the high of one candle and the low of another candle two periods later, with the middle candle not filling this gap. These represent areas where price moved inefficiently and often return to "fill" the gap.

**How it works:**
- Analyzes 3-candle patterns to identify gaps
- Bearish FVG: Gap between low[2] and high[0] where price dropped leaving unfilled space above
- Bullish FVG: Gap between high[2] and low[0] where price rose leaving unfilled space below
- Tracks 8 different candle body combinations for each direction (up, down, doji patterns)
- Monitors gap mitigation when price returns to fill the imbalance
- Changes color when gaps are partially or fully mitigated

**Gap Detection Logic:**
- Bearish FVG patterns: DDD, DDJ, JDD, UDJ, JDU, UDD, DDU, UDU
- Bullish FVG patterns: DUD, DUJ, JUD, UUJ, JUU, UUD, DUU, UUU
- (D=Down candle, U=Up candle, J=Doji candle)

**Trading Applications:**
- High-probability reversal zones when price returns to FVGs
- Support and resistance levels
- Target areas for limit orders
- Risk management reference points

## Component 3: TSM Fractals
**What it is:** TSM Fractals identify significant pivot highs and lows using Williams Fractal methodology. These mark potential reversal points and key support/resistance levels.

**How it works:**
- Identifies fractal highs: peaks where the center candle's high is higher than surrounding candles
- Identifies fractal lows: valleys where the center candle's low is lower than surrounding candles
- Uses customizable lookback periods (default 15) for fractal identification
- Displays horizontal lines with "$" symbols at fractal levels
- Maintains a configurable number of recent fractals on the chart

**Trading Applications:**
- Key support and resistance levels
- Potential reversal zones
- Confluence with other analysis tools
- Stop loss placement reference points

## Why This Combination Works
**Synergistic Analysis:** Each component provides different but complementary information:

1. **CISD** shows when market structure changes, indicating trend shifts or continuation
2. **FVGs** reveal where price has moved inefficiently and may return for rebalancing
3. **Fractals** highlight key pivot points that often act as support/resistance

**Trading Edge:** The combination allows for:
- **Entry Confirmation:** Wait for CISD breaks near unfilled FVGs at fractal levels
- **Risk Management:** Use FVG boundaries and fractal levels for stop placement
- **Target Selection:** Project moves to opposite FVGs or fractal levels
- **Market Context:** Understand whether you're trading with or against structure

## Key Features
**Multi-Timeframe CISD:**
- Customizable timeframe settings (Minute, Hour, Day, Week, Month)
- Adjustable swing length for pivot identification
- Customizable line styles, widths, and colors
- Optional alerts on structure breaks

**Advanced FVG Management:**
- Automatic gap size filtering
- Real-time mitigation tracking
- Color-coded active vs. mitigated gaps
- Optional pip value labels
- Large gap alerts for significant imbalances

**Intelligent Fractal Display:**
- Configurable fractal periods
- Maximum fractal count management
- Clean visual presentation
- Historical fractal preservation

## Settings & Customization
**CISD Settings:**
- Timeframe selection and multipliers
- Swing length adjustment (default 7)
- Line styling options
- Color customization for bullish/bearish breaks
- Alert toggle options

**FVG Settings:**
- Show/hide toggles for each direction
- Minimum gap size filtering
- Alert threshold for large gaps
- Color schemes for active and mitigated gaps
- Optional size labels in pips

**Fractal Settings:**
- Fractal period adjustment (default 15)
- Maximum display count (default 10)
- Show/hide toggle

## Educational Value
This indicator teaches traders to:
- Understand market structure concepts
- Recognize price inefficiencies
- Identify key pivot points
- Combine multiple analysis methods
- Develop systematic trading approaches

## Use Cases
**Swing Trading:** Identify major structure breaks with FVG confluence
**Day Trading:** Use lower timeframe CISDs with intraday FVGs
**Scalping:** Quick entries at FVG mitigation near fractal levels
**Position Trading:** Higher timeframe structure analysis with major FVGs

## Technical Implementation
- Utilizes Pine Script v6 for optimal performance
- Efficient array management for historical data
- Real-time calculations without repainting
- Memory-optimized box and line management
- Multi-timeframe data handling with proper security functions

This comprehensive tool eliminates the need for multiple separate indicators, providing everything needed for complete market structure analysis in one cohesive package. The educational component helps traders understand not just what the signals are, but why they work and how to use them effectively in different market conditions.