Settings Reference

1. Smart Signals Group

This group controls the core trend-following and signal generation engine.

Enable Smart Signals:

Default: On
Description: The master switch for the entire Smart Signals module. Turn this off to disable the core signals (▲/▼), candle coloring, and related logic.

Signal Mode:

Default: Trend
Options: Trend, Reversal
Description: Selects the core trading strategy. Trend follows the prevailing market direction, while Reversal aims to catch potential turning points or pullbacks. Note that Reversal mode does not produce Strong signals (+▲/+▼) or Exit signals (x).

Smart Signals Mode:

Default: Swing
Options: Scalping, Swing
Description: Switches between the two underlying algorithms. Scalping is a fast, adaptive model for low timeframes (5-min and under). Swing is a more stable model for higher timeframes.

🤖 Find Best Length:

Default: Off
Description: When enabled, automatically tests all 12 length values and selects the one with the best combined win rate and net profit. Overrides the manual Time Horizon value. An Optimization Metrics table is displayed on the chart showing performance for all lengths.

Time Horizon:

Default: 3
Range: 1 to 12
Description: Controls the lookback period for trend detection. Higher values result in slower, longer-term signals. Lower values result in faster, shorter-term signals. This value is ignored when "Find Best Length" is enabled.

2. Confluence Group

This group controls the five optional components used to build a stronger trading thesis.

Fair Value Trail:

Enable: On/Off (Default: Off)
Horizon: Short Term, Medium Term (Default), Long Term
Description: Toggles the Fair Value Trail, which shows liquidity-weighted "fair price" zones for entries/exits. Optimal Entry triangles are always active when the FVT is enabled. The Horizon setting controls its sensitivity.

Trend Spine:

Enable: On/Off (Default: Off)
Horizon: Short Term (Default), Medium Term, Long Term
Description: Toggles the Trend Spine, a decisive line showing the main trend "backbone." The Horizon setting controls its responsiveness.

Trend Bias:

Enable: On/Off (Default: Off)
Horizon: Medium Term (Default), Long Term
Description: Toggles the Trend Bias cloud, which visualizes bullish/bearish momentum strength. The Horizon setting controls the smoothing.

Firmament Clouds:

Enable: On/Off (Default: Off)
Horizon: Short Term, Medium Term (Default), Long Term
Description: Toggles the Firmament Clouds, which show dynamic support and resistance zones. The Horizon setting controls the width and responsiveness of the clouds.

Trend-Range Classifier:

Enable: On/Off (Default: Off)
Horizon: Short Term, Medium Term (Default), Long Term
Memory: Low, Medium (Default), High, Ultra
Description: Toggles the machine-learning model that detects trending vs. ranging markets. The Horizon setting adjusts the input data for the model. The Memory setting controls how many historical samples the model trains on per bar — higher values may give more stable results but increase computation time. ⚠️ "Ultra" may cause timeouts on some charts.

3. Smart Exits Group

This group controls the automated stop-loss, take-profit, and exit signal features.

Exits Signals:

Default: On
Description: Enables the momentum-based exit signals (orange 'x'). Only active in Trend Mode — automatically disabled in Reversal Mode.

Take-Profit Levels:

Default: Off
Description: Enables the automatic plotting of Take-Profit lines.

Stop-Loss Level:

Default: Off
Description: Enables the automatic plotting of the Stop-Loss line.

TP/SL Distance Type:

Default: Volatility
Options: Volatility, Percentage
Description: Determines how distances between entry and TP/SL levels are calculated. Volatility uses ATR for dynamic, market-adaptive distances. Percentage uses a fixed percentage of the entry price for predictable, consistent distances.

Max Exit Signals:

Default: 3
Description: Sets the maximum number of exit signals ('x') to show per trade.

Take-Profit Levels (count):

Default: 3
Range: 1 to 5
Description: Sets the number of Take-Profit levels to plot, allowing for multi-stage profit-taking.

Take-Profit Distance Multiplier:

Default: 3.3
Description: Controls the distance to TP levels. When Volatility is selected in TP/SL Distance Type, this acts as a volatility (ATR) multiplier. When Percentage is selected, this directly sets the percentage distance from entry.

Stop-Loss Distance Multiplier:

Default: 1.0
Description: Controls the distance to the SL level. When Volatility is selected in TP/SL Distance Type, this acts as a volatility (ATR) multiplier. When Percentage is selected, this directly sets the percentage distance from entry.

4. Appearance Group

This group controls the visual elements of the indicator.

Main Colors:

Sets the primary Bullish (green) and Bearish (red) colors used across the indicator.

ML Trend/Range Colors:

Sets the colors for the Trend-Range Classifier background (Trending vs. Ranging). Default: Blue for Trending, Gray for Ranging. These are customizable.

Detect Ranging Candles (Gray):

Default: On
Description: Enables or disables the gray candle feature, which highlights periods of consolidation and weakening momentum.

Candle Coloring Mode:

Default: Trend Gradient
Options: Trend Static, Trend Gradient, Volume Gradient, None
Description: Defines how candles are colored.
- Trend Static: Solid green/red based on trend direction.
- Trend Gradient: Fades from gray to green/red based on momentum intensity. Brighter = stronger momentum.
- Volume Gradient: Colors candles from gray to orange based on relative trading volume.
- None: Disables all candle coloring.

Show Component Table:

Default: On
Description: Toggles the visibility of the component status table on the chart. This table displays the current state and statistics for each enabled component, including:
- Component Type: Name of the component (Smart Signals, FVT, Trend Spine, Trend Bias, Firmament Clouds, TRC).
- Signal: Current direction (▲ bullish, ▼ bearish) or regime icon (🎢 trending, ⚖️ ranging for TRC).
- Avg Signal Duration: Average number of bars each signal/state has lasted historically.
- Current Signal Duration: How many bars the current signal/state has been active.
- Disabled components display "NaN" for duration values.

Table Size:

Options: Tiny, Small (Default), Medium, Large
Description: Adjusts the font size of the component table.

Table Position:

Default: bottom right
Options: bottom center, bottom left, bottom right, middle center, middle left, middle right, top center, top left, top right
Description: Sets the location of the component table on the chart.

5. Alerts Group

This group contains all settings for the advanced, multi-step alert system.

Show Historical Alerts:

Default: Off
Description: Toggles a visual overlay showing where your custom alert conditions would have triggered in the past. When enabled, small colored squares appear at the bottom of the chart — red when conditions were met, gray otherwise. Requires at least one alert condition to be enabled.

Condition 1–7: A set of 7 inputs for building the alert logic. Each includes:

Enable Checkbox: Toggles the condition.
Condition Type: A dropdown to select any available trigger or state from the indicator's components.
Boolean: (AND/OR) Chains the condition with others in the same step. (Excluding Condition 1, which has a fixed AND.)
Step: Assigns the condition to a step from 1 to 7. Up to 7 steps are supported.

Note on Sequence Invalidation: The alert system enforces strict sequencing. If a later step's conditions become true before earlier steps are completed, the sequence resets automatically. There are no configurable invalidation settings — this behavior is built in.