LWSWING Market Indicator v1.0

User Manual – Production Release

Release Date: February 1, 2026
Version: 1.0 (Production)
Category: Market Structure & Direction Analysis
Platform: MetaTrader 5
Developer: GomerAI LLC
Website: https://gomerai.com

Thank you for reading this post, don't forget to subscribe!

---

Table of Contents

1. Overview
2. What is LWSWING?
3. Key Features
4. Installation
5. Visual Elements
6. Understanding the Signals
7. Input Parameters
8. Best Practices
9. Troubleshooting
10. Technical Support

---

Overview

The LWSWING Market Indicator is a professional-grade swing structure detection tool that visualizes market highs, lows, and structural shifts directly on your price chart. It identifies key pivot points, connects them with trend lines, and marks important structural transitions with clear labels.

Purpose: Provide traders with real-time visual feedback about market structure and direction changes.

Context-Only Analysis: This indicator provides market context only and does not generate trade signals or recommendations. It is designed to complement your trading strategy, not replace it.

---

What is LWSWING?

LWSWING (Liquidity-Weighted Swing) is a swing detection algorithm that identifies:

1. Swing Highs – Peaks where price reversed downward
2. Swing Lows – Troughs where price reversed upward
3. BOS (Break of Structure) – When price breaks above/below key levels
4. CHoCH (Change of Character) – When market structure shifts direction

The indicator draws these elements directly on your chart, providing immediate visual clarity about market structure.

---

Key Features

✅ On-Chart Visualization

• No separate window – all elements draw on the price chart
• Never clutters your workspace
• Integrates seamlessly with existing indicators

✅ Clear Visual Elements

• Green up arrows at swing lows (bullish pivots)
• Red down arrows at swing highs (bearish pivots)
• Trend lines connecting consecutive swings
• Text labels marking BOS and CHoCH events

✅ Never Empty

• Always shows identified structure
• Continuous feedback on every timeframe
• No “waiting for signal” – structure is always present

✅ Fully Customizable

• Toggle arrows, lines, and labels independently
• Adjust colors to match your chart theme
• Control arrow size and visual prominence

✅ EA Compatible

• Works with GomerAI MultiStrat Networked EA
• Provides market structure data for algorithmic decision-making
• AITL (AI Trading Layer) integration ready

---

Installation

Step 1: Copy Files

1. Download LWSWING_Market_Indicator_v1.0.mq5
2. Copy to: [MT5 Data Folder]/MQL5/Indicators/GomerAI/LWSWING/
3. If folder doesn’t exist, create it

Step 2: Compile

1. Open MetaEditor (F4 in MT5)
2. Navigate to the file in Navigator
3. Click “Compile” or press F7
4. Verify: “0 errors, 0 warnings”

Step 3: Attach to Chart

1. In MT5, open your desired chart (any symbol, any timeframe)
2. In Navigator, expand “Indicators” → “Custom”
3. Find “LWSWING_Market_Indicator_v1.0”
4. Drag onto chart OR double-click
5. Configure parameters (see Input Parameters section)
6. Click “OK”

Step 4: Verify

You should immediately see:

• Green and red arrows at swing points
• Lines connecting swings
• Text labels at structure changes
• Indicator initialization message in Experts log

---

Visual Elements

1. Green Up Arrows (▲)

Location: At swing lows (bullish pivot points)

Meaning:

• Price found support and reversed upward
• Buyers stepped in at this level
• Potential support zone

Example: After a downtrend, price makes a low, then reverses. Arrow appears at the exact low point.

---

2. Red Down Arrows (▼)

Location: At swing highs (bearish pivot points)

Meaning:

• Price found resistance and reversed downward
• Sellers stepped in at this level
• Potential resistance zone

Example: After an uptrend, price makes a high, then reverses. Arrow appears at the exact high point.

---

3. Trend Lines

Appearance: Lines connecting consecutive swing highs or swing lows

Colors:

• Red lines = Connecting swing lows (support structure)
• Green lines = Connecting swing highs (resistance structure)
• Gray lines = Neutral or transitioning structure

Purpose:

• Visualize structure progression
• Show if market is making higher highs/higher lows (bullish)
• Show if market is making lower highs/lower lows (bearish)

---

4. BOS Labels (Break of Structure)

Text: “BOS ↑” or “BOS ↓”

Meaning:

• BOS ↑ (Green) = Price broke above a previous swing high (bullish momentum)
• BOS ↓ (Red) = Price broke below a previous swing low (bearish momentum)

Significance:

• Indicates potential trend continuation
• Suggests strong directional move
• Breakout confirmation

---

5. CHoCH Labels (Change of Character)

Text: “CHoCH ↑” or “CHoCH ↓”

Meaning:

• CHoCH ↑ (Green) = Market transitioned from bearish to bullish structure
• CHoCH ↓ (Red) = Market transitioned from bullish to bearish structure

Significance:

• Potential trend reversal
• Structure shift detected
• Early warning of changing market conditions

---

Understanding the Signals

Bullish Structure

What to look for:

• Green up arrows getting higher (higher lows)
• Red lines sloping upward
• “BOS ↑” labels appearing
• “CHoCH ↑” marking transition to bullish

Interpretation:
Market is in an uptrend. Buyers are in control. Each pullback finds support at a higher level than the previous one.

---

Bearish Structure

What to look for:

• Red down arrows getting lower (lower highs)
• Red lines sloping downward
• “BOS ↓” labels appearing
• “CHoCH ↓” marking transition to bearish

Interpretation:
Market is in a downtrend. Sellers are in control. Each rally fails at a lower level than the previous one.

---

Neutral/Ranging Structure

What to look for:

• Arrows at similar price levels
• Lines relatively flat
• No BOS or CHoCH labels
• Swings contained within a range

Interpretation:
Market is consolidating. Neither buyers nor sellers have clear control. Wait for breakout or structure shift.

---

Input Parameters

Swing Detection Settings

InpSwing_Lookback (Default: 20)

• Range: 10-100 bars
• Purpose: How far back to look for swing points
• Higher values: Identify longer-term swings (less frequent)
• Lower values: Identify shorter-term swings (more frequent)
• Recommendation: 20 for M5-M15, 30 for H1, 50 for H4+

InpSwing_Threshold (Default: 5)

• Range: 3-10 bars
• Purpose: Minimum bars on each side of pivot required
• Higher values: Stronger confirmation (fewer, more significant swings)
• Lower values: Earlier detection (more swings, some false)
• Recommendation: 5 for most timeframes

InpBOS_MinMove (Default: 0.5%)

• Range: 0.1-2.0%
• Purpose: Minimum % move required to classify as BOS
• Higher values: Only major breakouts labeled
• Lower values: More sensitive, more labels
• Recommendation: 0.5% for forex, 1.0% for volatile instruments

InpCHoCH_Threshold (Default: 0.3%)

• Range: 0.1-1.0%
• Purpose: Minimum % change to classify as CHoCH
• Higher values: Only significant structure shifts labeled
• Lower values: More sensitive to structural changes
• Recommendation: 0.3% for most instruments

---

Structure Confirmation

InpConfirmation_Bars (Default: 3)

• Range: 2-10 bars
• Purpose: Bars used for trend consistency check
• Higher values: More confirmation required
• Lower values: Faster response
• Recommendation: 3-5 for active trading

---

Chart Drawing Options

ShowArrows (Default: true)

• Options: true / false
• Purpose: Enable/disable swing pivot arrows
• Disable if: You only want to see lines and labels

ShowLines (Default: true)

• Options: true / false
• Purpose: Enable/disable connecting lines
• Disable if: Chart becomes too cluttered

ShowLabels (Default: true)

• Options: true / false
• Purpose: Enable/disable BOS/CHoCH text labels
• Disable if: You prefer clean chart with only arrows/lines

ColorBullish (Default: clrLimeGreen)

• Purpose: Color for bullish elements (up arrows, BOS ↑, CHoCH ↑)
• Customize: Match your chart theme

ColorBearish (Default: clrCrimson)

• Purpose: Color for bearish elements (down arrows, BOS ↓, CHoCH ↓)
• Customize: Match your chart theme

ColorNeutral (Default: clrDimGray)

• Purpose: Color for neutral structure lines
• Customize: Match your chart theme

ArrowSize (Default: 2)

• Range: 1-5
• Purpose: Control arrow width/prominence
• Higher values: More visible arrows
• Lower values: Subtle arrows

---

Network & Telemetry

EnableNetwork (Default: true)

• Purpose: Enable AITL connection attempts
• Note: Indicators cannot connect directly (MT5 restriction)
• EA Proxy: Data flows through EA when active

EnableTelemetry (Default: true)

• Purpose: Enable heartbeat telemetry
• Note: Only functional when EA is attached

---

Best Practices

1. Choose Appropriate Timeframe

• Scalping (M1-M5): Use lower Swing_Threshold (3-5)
• Day Trading (M15-H1): Use default settings
• Swing Trading (H4-D1): Use higher Swing_Lookback (30-50)

2. Combine with Price Action

• Use LWSWING to identify structure
• Use price action to time entries/exits
• Wait for structure confirmation before entering

3. Watch for Confluences

• BOS + Support/Resistance = strong signal
• CHoCH + Volume increase = trend reversal confirmation
• Multiple timeframe structure alignment

4. Avoid Over-Trading

• Not every swing requires action
• Focus on structure shifts (BOS/CHoCH)
• Trade with the dominant structure, not against it

5. Customize for Your Strategy

• Toggle elements based on your focus
• Adjust colors for visibility
• Experiment with parameters on demo before live

---

Troubleshooting

No Arrows Appearing

Possible Causes:

• ShowArrows is set to false
• InpSwing_Threshold is too high for timeframe
• Insufficient bars on chart (need 30+ bars minimum)

Solution:

• Verify ShowArrows = true
• Lower InpSwing_Threshold to 3-5
• Load more historical data (scroll chart left)

---

Too Many Arrows/Lines (Chart Cluttered)

Solution:

• Increase InpSwing_Threshold to 7-10
• Increase InpSwing_Lookback to 30-50
• Disable ShowLines if only arrows needed

---

No BOS or CHoCH Labels

Possible Causes:

• ShowLabels is set to false
• Market is ranging (no clear structure breaks)
• Thresholds too high (InpBOS_MinMove, InpCHoCH_Threshold)

Solution:

• Verify ShowLabels = true
• Lower InpBOS_MinMove to 0.3%
• Lower InpCHoCH_Threshold to 0.2%
• Wait for market to establish clear trend

---

Arrows Appearing Too Late

Solution:

• Lower InpSwing_Threshold to 3
• Understand: Swing confirmation requires bars on BOTH sides of pivot
• This is normal behavior – pivots are confirmed after the fact

---

Indicator Not Loading

Check:

1. File location: MQL5/Indicators/GomerAI/LWSWING/
2. Compilation: 0 errors
3. MT5 restart: Sometimes required after compilation
4. Terminal logs (Experts tab): Check for error messages

---

Error 4014 (URL Not Whitelisted)

This is normal and expected.

Explanation:

• Indicators cannot make WebRequest calls in MT5
• The indicator attempts AITL connection (expected to fail)
• It degrades gracefully to standalone mode
• Data flows through EA when attached

Action Required: None – indicator works correctly in offline mode

---

Integration with GomerAI EA

The LWSWING indicator is designed to work standalone OR with the GomerAI MultiStrat Networked EA.

When Used with EA:

• EA reads swing signal and confidence from indicator
• Data transmitted to AITL (AI Trading Layer)
• Swing structure used in algorithmic decision-making
• Provides market structure context for entry/exit logic

Buffer Layout (for EA developers):

• Buffer 0: SwingLowArrow (visual)
• Buffer 1: SwingHighArrow (visual)
• Buffer 2: SwingSignal (-1=bearish, 0=neutral, +1=bullish) [EA READS]
• Buffer 3: SwingConfidence (0.0-1.0) [EA READS]

---

Technical Support

Documentation

• Build Documentation: See VERSION_TRACKING.md in GitHub repository
• Buffer Layouts: See INDICATOR_BUFFER_LAYOUTS.md
• EA Integration: See EA_BUILD_PROCESS.md

Support Channels

• Website: https://gomerai.com/support
• GitHub: https://github.com/TMGContracting/GomerAI-EA
• Email: support@gomerai.com

Reporting Issues

When reporting issues, please include:

1. MT5 build number
2. Indicator version (v1.0)
3. Symbol and timeframe
4. Screenshot showing issue
5. Experts log messages
6. Parameter settings used

---

Legal Disclaimer

IMPORTANT NOTICE:

This indicator provides market analysis and context information only. It does NOT provide:

• Trade signals
• Entry/exit recommendations
• Financial advice
• Guaranteed profits

Trading Risk:
Trading foreign exchange, stocks, commodities, and other financial instruments carries a high level of risk and may not be suitable for all investors. The high degree of leverage can work against you as well as for you. Before deciding to trade, you should carefully consider your investment objectives, level of experience, and risk appetite.

No Warranty:
This software is provided “as is” without warranty of any kind, either expressed or implied. GomerAI LLC does not guarantee the accuracy, completeness, or reliability of any information displayed by this indicator.

Past Performance:
Past performance is not indicative of future results. Any historical returns, expected returns, or probability projections may not reflect actual future performance.

Use at Your Own Risk:
You acknowledge that you are using this indicator at your own risk. GomerAI LLC shall not be liable for any losses, damages, or claims arising from its use.

---

Version History

v1.0 (2026-02-01) – PRODUCTION RELEASE

• Production-ready release for public deployment
• On-chart visualization with arrows, lines, and labels
• Swing detection: Higher-highs/lower-lows patterns
• BOS and CHoCH identification and labeling
• EA v0.09 compatible
• Fully customizable display options
• User manual created

v0.03 (2026-01-14)

• Changed from separate window to chart window
• Added arrows, lines, and labels
• Redesigned for never-empty visual feedback

v0.02 (2026-01-14)

• Compilation fix (removed g_ATR_Handle)
• Version bump per rules

v0.01 (2026-01-14)

• Initial development build
• Separate window histogram display

---

Credits

Developer: GomerAI LLC
Algorithm Design: Liquidity-Weighted Swing Detection
Platform: MetaTrader 5
Language: MQL5
Release Date: February 1, 2026
License: Proprietary

---

Quick Reference Card

Visual Elements

Element	Color	Meaning
▲ (Up Arrow)	Green	Swing low (bullish pivot)
▼ (Down Arrow)	Red	Swing high (bearish pivot)
Lines sloping up	Red	Higher lows (bullish)
Lines sloping down	Red	Lower highs (bearish)
BOS ↑	Green	Break of structure (bullish)
BOS ↓	Red	Break of structure (bearish)
CHoCH ↑	Green	Change of character (to bullish)
CHoCH ↓	Red	Change of character (to bearish)

Key Parameters Quick Guide

Parameter	Scalping	Day Trading	Swing Trading
Swing_Lookback	15-20	20-30	30-50
Swing_Threshold	3-5	5	5-7
BOS_MinMove	0.3%	0.5%	0.7%
CHoCH_Threshold	0.2%	0.3%	0.4%

---

© 2026 GomerAI LLC. All Rights Reserved.

LWSWING Market Indicator v1.0 – Production Release
Release Date: February 1, 2026
https://gomerai.com