PSL AI - Analytical Intelligence

=== OVERVIEW ===

PSL AI (Analytical Intelligence) is a comprehensive real-time market analysis assistant that transforms complex technical data into human-readable commentary. Instead of displaying raw numbers, this indicator interprets 19 different analysis modules and presents actionable insights in natural language.

Available in three languages: English, Turkish, and Chinese.

The indicator displays a dynamic commentary panel that updates with each bar, providing:

- Market character assessment (volatile, calm, institutional, panic)
- Trend direction with strength analysis
- Momentum status with divergence warnings
- ICT structures (FVG, MSS, Order Blocks)
- Support/Resistance levels with distance percentages
- Actionable scenarios with entry, target, and stop levels
- Trader psychology warnings (FOMO, panic alerts)


=== WHAT MAKES THIS INDICATOR ORIGINAL ===

Traditional indicators show numbers. PSL AI tells you what those numbers mean.

1. AI-Style Commentary Engine

The indicator contains 19 specialized analysis functions, each with 8 unique phrase variations. This creates over 50 trillion possible commentary combinations, ensuring the text never feels repetitive. The language adapts to market conditions: urgent during high volatility, calm during consolidation.

2. Multi-Factor Scoring System

Rather than relying on a single indicator, PSL AI evaluates 8 independent technical criteria and produces a unified score (0-8) with percentage confidence. This approach reduces false signals by requiring multiple confirmations.

3. Contextual Market Psychology

The indicator detects market "character" and warns traders about emotional traps:

- High volatility + high volume = "Big players are active, respect the move"
- RSI extreme + consecutive candles = "Don't FOMO" or "Don't panic sell"
- Score tie = "No clear edge, patience is also a strategy"

4. Actionable Scenario Planning

Instead of just showing support/resistance lines, PSL AI provides complete trade scenarios:

"If 84,416 breaks -> Target: 97,888 -> Stop: below 84,416"

This saves time and helps traders think in terms of risk/reward.


=== HOW IT WORKS - TECHNICAL DETAILS ===

SCORING SYSTEM (8 Criteria)

Each criterion adds +1 to Long Score or Short Score:

- MACD: Long if MACD > Signal | Short if MACD < Signal
- RSI: Long if between 50-70 | Short if between 30-50
- Stochastic: Long if %K between 50-80 | Short if %K between 20-50
- Volume: Long if RelVol > 1.2 + bullish bar | Short if RelVol > 1.2 + bearish bar
- Delta: Long if Close > Open | Short if Close < Open
- Trend: Long if EMA 50 > EMA 169 | Short if EMA 50 < EMA 169
- ADX + DI: Long if ADX > 20 and DI+ > DI- | Short if ADX > 20 and DI- > DI+
- CCI: Long if between 0-150 | Short if between -150-0

Final output examples:
- Score 7/8 Long = "BUY (7/8, 87%)"
- Score 5/8 Short = "SELL (5/8, 62%)"
- Score 3/3 Tie = "NEUTRAL (3/3)"


SUPPORT/RESISTANCE ALGORITHM

The S/R detection uses:
- Pivot High/Low detection with 10-bar lookback
- 284-bar historical analysis period
- Channel width filtering (10% of range)
- Strength requirement: minimum 2 pivot touches
- Identifies both nearest and secondary levels for multi-target scenarios


ICT STRUCTURES

Fair Value Gap (FVG):
- Bullish FVG: Current low > 2 bars ago high (gap up)
- Bearish FVG: Current high < 2 bars ago low (gap down)
- Minimum size filter: 30% of ATR(10)
- Auto-invalidation when price fills the gap

Market Structure Shift (MSS):
- Bullish MSS: Close breaks above last swing high
- Bearish MSS: Close breaks below last swing low
- Swing detection uses 5-bar pivot lookback

Order Blocks (OB):
- Bullish OB: Last bearish candle before bullish breakout
- Bearish OB: Last bullish candle before bearish breakdown
- 10-bar swing detection for OB identification
- Auto-invalidation when price breaks OB boundaries


ADDITIONAL ANALYSIS MODULES

- VWAP Analysis: Position relative to VWAP with distance percentage
- Gap Analysis: Detects daily gaps and tracks fill status
- Volatility Squeeze: ATR(5) < ATR(20) x 0.75 signals compression
- Breakout Confirmation: 20-bar high/low break with volume validation (>1.5x average)
- Key Level Rejection: Wick-to-body ratio analysis at S/R zones
- Accumulation/Distribution: Detects price/A-D divergence for hidden accumulation or distribution


=== 19 ANALYSIS MODULES ===

The commentary panel combines insights from these modules:

1. Market Character - Volatile, calm, institutional, or retail panic
2. Trend Analysis - Direction, strength, EMA distance, consecutive candles
3. Momentum - RSI/Stochastic status with overbought/oversold context
4. Candle Patterns - 21 formations (Doji, Hammer, Engulfing, Morning Star, etc.)
5. Volume Analysis - Relative volume, accumulation signals
6. ICT/FVG/MSS - Smart money concepts with entry levels
7. Order Blocks - OB position and status
8. Volatility - ATR-based risk assessment
9. 50-Bar Range - Distance to recent high/low
10. S/R Distance - Proximity warnings for support/resistance
11. Trader Psychology - FOMO/panic warnings based on conditions
12. VWAP - Intraday bias indicator
13. Gap Analysis - Gap status and fill probability
14. Volatility Squeeze - Pre-breakout compression detection
15. Breakout Confirmation - Real vs fake breakout assessment
16. Key Level Rejection - Wick rejection signals at critical levels
17. Accumulation/Distribution - Hidden buying/selling detection
18. Close Watch - Levels to monitor for confirmed breaks
19. Scenarios - Complete if/then trade plans


=== HOW TO USE ===

STEP 1: ADD TO CHART
Apply the indicator to any symbol and timeframe. Recommended: 15m, 1H, 4H, Daily.

STEP 2: CONFIGURE SETTINGS
- Language: Choose Turkish, English, or Chinese
- Position: Place panel in any corner or center
- Size: Adjust text size for your screen
- Color: Select neon accent color (Cyan, Purple, Pink, Green)

STEP 3: READ THE PANEL
The panel is organized top-to-bottom:
- Header: Symbol, timeframe, current price
- Analysis: Market commentary organized by topic
- Result: Final BUY/SELL/NEUTRAL verdict with score
- Close Watch: Key levels to monitor
- Scenarios: Conditional trade plans

STEP 4: ACT ON SCENARIOS
Example panel output:

CLOSE WATCH:
- 74,466 close BELOW = SELL
- 84,416 close ABOVE = BUY

SCENARIOS:
A) If 84,416 breaks:
Target: 97,888
Stop: below 84,416

B) If 74,466 breaks:
Target: 70,743
Stop: above 74,466

Wait for a confirmed candle close above/below the level before acting.


=== SETTINGS EXPLAINED ===

- Show AI Panel: Toggle the entire commentary panel on/off
- Language: Choose between Turkish, English, or Chinese
- Panel Position: 6 options available (corners, top-center, bottom-center)
- Text Size: Small (compact), Normal, or Large (more readable)
- Neon Color: Panel accent color (Cyan, Purple, Pink, or Green)


=== BEST PRACTICES ===

Recommended:
- Use on higher timeframes (1H+) for more reliable signals
- Wait for candle close before acting on breakout scenarios
- Combine with price action analysis, do not rely solely on the score
- Pay attention to psychology warnings during extreme RSI/consecutive candles
- Check volume confirmation for breakouts (indicator will warn if volume is weak)

Not Recommended:
- Trading every signal. Look for high-score (6+/8) setups
- Ignoring the "NEUTRAL" verdict. Sometimes no trade is the best trade
- Using on very low timeframes (1m, 5m) for swing trading decisions


=== LIMITATIONS ===

- Gap Analysis: Most effective on markets with sessions (stocks, forex). 24/7 crypto markets rarely produce traditional gaps.

- Real-time Updates: Commentary updates per bar close. Intra-bar price swings will not change the text until the bar completes.

- Language in Inputs: Due to Pine Script limitations, input labels remain in Turkish regardless of selected language. Only the commentary panel text changes.

- Not a Trading System: This is a decision-support tool. Always apply your own analysis and risk management.


=== EXAMPLE INTERPRETATION ===

When you see this commentary:

"Cold winds blowing! Trend down, be careful. 4 red candles in a row!
Selling pressure continues. Lower Low formed, decline deepening.

RSI at 22.6. For brave ones, opportunity! Stoch in extreme selling zone.

ICT ALERT! MSS down + Bear FVG! Smart money says SELL! Entry: 84704

RESULT: SELL (6/8, 75%)"

This tells you:
1. Trend is bearish with strong momentum (4 consecutive red candles)
2. RSI is oversold (22.6) - could bounce, but trend still down
3. ICT structure confirms bearish bias (MSS + FVG alignment)
4. 6 out of 8 criteria favor short positions
5. Consider short entries, but watch for oversold bounce


=== DISCLAIMER ===

This indicator is for educational and informational purposes only. It does not constitute financial advice, investment recommendations, or trading signals.

Past performance of any trading methodology is not indicative of future results. Trading financial instruments involves substantial risk of loss and is not suitable for all investors.

Always conduct your own research and consult with a qualified financial advisor before making any investment decisions. Use proper risk management and never trade with money you cannot afford to lose.