OPEN-SOURCE SCRIPT
تم تحديثه

Echo Vector

1 290
## Echo Vector

### Overview

Echo Vector is an open-source chart-analysis overlay that combines relative-volume candle classification, moving-average context, confirmed price structure, liquidity references, imbalance zones, trading sessions and higher-timeframe reference levels.

The purpose of the script is to organize several related areas of chart analysis within one configurable workflow:

- relative volume and candle behaviour;
- trend and volatility context;
- confirmed swing structure;
- liquidity references and mitigated zones;
- Fair Value Gaps and Balanced Price Ranges;
- daily, weekly and session-based reference levels;
- optional analytical condition markers;
- simplified historical condition-outcome statistics.

Echo Vector does not predict future price movement. Its colours, zones, lines and markers show when the configured analytical conditions have been detected. They should not be treated as automatic instructions to enter or exit a position.

### Open-source attribution

Echo Vector is an independent derivative that retains and adapts portions of the open-source Traders Reality MT4 Sessions framework and functionality associated with the Traders_Reality_Lib.

The original source credits:

- TradersReality;
- plasmapug;
- infernix;
- peshocore;
- xtech5192.

Retained or adapted areas include selected relative-volume vector-candle concepts, EMA references, market-session timing, daylight-saving handling, daily pivot calculations, M-level calculations, Psy-level concepts and selected daily and weekly reference levels.

This publication is not affiliated with, endorsed by or presented as an official TradersReality or Pattern Watchers publication.

The source is published under the Mozilla Public License 2.0.

This implementation expands the framework with additional liquidity-level management, volume-confirmed pivot zones, market-structure states, Fair Value Gap and Balanced Price Range processing, configurable condition markers, mitigation handling, Fibonacci references, timeframe presets and historical condition-outcome tables.

### What the script measures

Echo Vector examines how candle direction, candle range, candle body size and reported volume relate to their recent historical averages.

The script also examines:

- price position relative to several moving averages;
- confirmed pivot highs and lows;
- breaks of confirmed internal and external structure;
- price interaction with previously identified levels and zones;
- three-candle price imbalances;
- overlap between opposing imbalance zones;
- distance from statistical and moving-average references;
- session location and daily or weekly reference levels.

The individual modules measure different characteristics. A high-volume candle describes participation, while a structure break describes price progression. A liquidity level describes a previous pivot reference, while an FVG describes an imbalance between three candles.

No single component confirms the meaning of another component automatically.

### Relative-volume candle classification

The vector-candle engine compares current volume with a recent volume average.

It also calculates a volume-spread value by multiplying candle range by volume and comparing that value with recent bars.

The principal candle states are:

- Echo Pulse: volume exceeds the configured moderate relative-volume threshold.
- Echo Surge: volume exceeds the stronger threshold or the volume-spread value reaches the recent comparison extreme.
- Echo Peak: volume reaches the configured extreme relative-volume threshold.
- Blow-off condition: a bullish candle combines unusually high volume, an unusually large body and extension above an EMA-based deviation reference.
- Exhaustion condition: a bearish candle combines unusually high volume, an unusually large body and extension below the corresponding deviation reference.

These classifications describe unusual candle and volume relationships. They do not prove accumulation, distribution, institutional activity or an imminent reversal.

An Echo Cascade marker can appear when qualifying volume states occur for the selected number of consecutive bars.

### Moving averages and cloud

The script displays five configurable moving-average references representing fast, medium, baseline, long-term and very-long-term context.

The baseline average is also used as the centre of a volatility cloud. Cloud width is calculated from price standard deviation and can be adjusted with the multiplier and divisor settings.

When dynamic colouring is enabled, selected moving averages change colour according to price position relative to the baseline average.

Moving averages are delayed calculations based on historical prices. They do not identify exact support or resistance and can react slowly after abrupt market changes.

### Liquidity reference levels

The LQ module converts confirmed pivot highs and lows into horizontal reference levels.

- A level above a confirmed pivot high represents a possible high-side liquidity reference.
- A level below a confirmed pivot low represents a possible low-side liquidity reference.

The lines remain active until they are touched, hidden under the selected mitigation rule or removed because the maximum number of retained levels has been reached.

These levels are inferred from historical price structure. They do not display real resting orders or order-book liquidity.

### Volume-confirmed pivot zones

The zone module combines confirmed pivots with relative volume.

A zone is created when:

- a pivot high or pivot low has been confirmed;
- volume at the pivot meets the selected relative-volume threshold;
- the zone satisfies the configured display and storage rules.

Zone height can be based on a fixed tick value and may also be scaled by relative volume or ATR.

Mitigation can be evaluated using candle wicks or candle bodies. Mitigated zones may be removed or retained with a faded appearance.

The zones represent areas of prior price and volume interaction. They do not prove the presence of institutional orders.

### Market structure

Echo Vector maintains separate external and internal structure states.

External structure uses the major pivot lookback. Internal structure uses a shorter pivot lookback to detect smaller structural movements.

Depending on the previous stored direction, confirmed breaks may be labelled as:

- BOS;
- CHoCH;
- internal BOS;
- internal CHoCH;
- MSS.

The user can choose whether a break is evaluated using the candle close or the candle wick.

Structure labels are descriptive classifications based on confirmed pivots. Different pivot settings can produce different structure interpretations.

### Fair Value Gaps and Balanced Price Ranges

A bullish Fair Value Gap is detected when the current candle low remains above the high from two candles earlier.

A bearish Fair Value Gap is detected when the current candle high remains below the low from two candles earlier.

The gap must satisfy the configured minimum tick size.

When an active bullish and bearish FVG overlap, the overlapping section is displayed as a Balanced Price Range.

FVG and BPR zones are managed until their invalidation or fill condition is met.

These zones identify historical price imbalances. Price is not required to revisit, fill or react to them.

### Analytical condition markers

Echo Vector includes optional markers based on combinations of volume, candle body, wick structure, moving-average distance, RSI thresholds and recent price extremes.

Available modules include:

- swing-sweep conditions;
- stopping-volume-style conditions;
- high-volume displacement conditions;
- large-volume candle conditions;
- wick-rejection conditions;
- RSI extreme-threshold conditions;
- blow-off and exhaustion conditions.

These names describe the intended analytical category. The conditions are OHLCV-based heuristics and do not directly identify actual stop orders, passive absorption or order-book events.

Bullish and bearish markers indicate the directional interpretation assigned by the selected calculation. They are not buy or sell recommendations.

### Sessions and reference levels

The script can display selected market-session boxes and labels, including:

- London;
- New York;
- Tokyo;
- Hong Kong;
- Sydney;
- a combined Asia window;
- EU and US break windows.

Internal daylight-saving calculations adjust selected session times.

The script can also display:

- previous-day high and low;
- previous-week high and low;
- daily open;
- daily pivot levels;
- M0 through M5 midpoint levels;
- average-range references;
- Psy High and Psy Low references;
- dynamic Fibonacci retracement levels.

Session alignment can vary because of symbol trading hours, exchange calendars, chart timeframes, holidays and daylight-saving transitions.

### Fibonacci references

The Fibonacci module uses confirmed swing points maintained by the script.

When a new structural extreme is confirmed or the stored range is broken, the active swing range may be updated and the Fibonacci levels recalculated.

The user can control:

- pivot sensitivity;
- displayed ratios;
- line colours;
- line style;
- label visibility;
- standard or extended ratio sets.

Because the anchors depend on confirmed and changing swing structure, the displayed range can change as new information becomes available.

### Timeframe presets

Echo Vector provides Auto, Intraday, Daily, Weekly and Manual modes.

The presets adjust selected moving-average, RSI and volume parameters.

- Auto selects a parameter group according to the chart timeframe.
- Intraday, Daily and Weekly force a selected preset.
- Manual uses the user-defined values.

Preset values are starting configurations. They are not automatically optimized for the current symbol and do not guarantee suitable behaviour across all markets.

### How to use Echo Vector

Begin with the broader moving-average and market-structure context.

Next, examine where price is trading relative to:

- confirmed LQ levels;
- volume-confirmed pivot zones;
- FVG and BPR zones;
- session highs and lows;
- daily and weekly reference levels;
- the active Fibonacci range.

Then review the candle classification.

A Pulse, Surge or Peak candle shows that the selected volume criteria were met. It does not determine whether price will continue or reverse.

Finally, examine optional condition markers only after considering their location. A marker occurring near a relevant level or structural area may provide more context than the same marker appearing in the middle of an undefined range.

Users remain responsible for independently determining risk, position size, entry and exit rules.

### Minimal Mode

Minimal Mode reduces chart congestion by hiding selected condition markers and simplifying parts of the visual display.

It is intended for users who want to focus primarily on moving averages, the cloud, levels, sessions and broader structure.

Because individual modules also have separate visibility controls, users should confirm which elements remain active after enabling Minimal Mode.

### Historical condition-outcome table

The optional table applies fixed percentage target and stop distances to historical condition markers.

For each tracked condition, it counts whether the selected target or stop boundary was reached first.

The table is a simplified observational tool and is not equivalent to TradingView Strategy Tester.

It does not model:

- commission;
- spread;
- slippage;
- order type;
- execution delay;
- liquidity;
- position sizing;
- portfolio equity;
- all intrabar sequencing ambiguities.

Only one active observation is maintained for each tracked condition and direction. Historical results depend on the symbol, timeframe, available history, target distance, stop distance and selected settings.

Historical table values do not imply future performance.

### Settings

The main settings control:

- timeframe presets;
- moving-average periods and colours;
- volatility-cloud width;
- relative-volume thresholds;
- candle-state visibility;
- pivot sensitivity;
- liquidity-level retention;
- zone volume requirements;
- ATR and volume zone scaling;
- mitigation rules;
- internal and external structure sensitivity;
- close- or wick-based break evaluation;
- FVG minimum size;
- session visibility;
- daily and weekly reference levels;
- Fibonacci anchors and ratios;
- RSI thresholds;
- wick, volume and body filters;
- marker colours;
- alert conditions;
- table target and stop distances.

Lower thresholds and shorter lookbacks generally increase sensitivity and noise.

Higher thresholds and longer lookbacks generally produce fewer conditions and later confirmation.

### Alerts

Alerts are available for selected vector-candle states, FVG conditions, sweep-style conditions, stopping-volume-style conditions, wick conditions and Psy-level crosses.

Many conditions use values from the active candle. They can therefore appear, change or disappear before the candle closes.

For confirmed alerts, select Once Per Bar Close when creating the TradingView alert.

Pivot-based conditions are available only after the required right-side pivot bars have completed.

### Repainting and confirmation behaviour

FVG and BPR objects are created only after the relevant chart candle is confirmed.

Other current-bar conditions may change while the candle remains open.

Pivot highs and lows require bars on both sides of the pivot. A pivot is therefore confirmed only after the selected number of right-side bars has completed.

Once confirmed, a pivot marker, liquidity line, structure line, zone or Fibonacci anchor may be drawn at the earlier pivot location. The object was not available in real time on that earlier candle.

Current daily-open and session values can change as their active periods develop.

Users should evaluate signals according to the time at which they became confirmed rather than only by their final historical chart position.

### Limitations

- Volume quality differs between exchanges, brokers and symbols.
- Forex and CFD symbols may provide tick volume rather than centralized exchange volume.
- Relative-volume classifications do not show true bid-and-ask delta.
- Pivot confirmation introduces delay.
- Current-bar markers can change before candle close.
- High volume can accompany continuation, reversal or temporary volatility.
- Extreme conditions can persist.
- Liquidity levels do not show actual resting orders.
- Volume-confirmed zones do not prove institutional activity.
- FVG and BPR zones may remain unfilled or fail to produce a reaction.
- Structure classifications depend on the selected pivot settings.
- Moving averages lag price.
- Session timing can vary across exchanges and instruments.
- Lower timeframes generally generate more noise.
- Historical outcome tables do not reproduce realistic execution.
- Platform limits can restrict the number of retained boxes, labels and lines.
- The script should not be used as the sole basis for a trading decision.


------------


## HOW-TO: Use Echo Vector to Read Volume, Liquidity and Structure

Echo Vector combines relative-volume candles, moving-average context, confirmed market structure, liquidity references, imbalance zones, sessions and higher-timeframe levels.

This guide explains a structured way to read the indicator without treating any single marker as an automatic trade signal.

## Step 1: Choose the operating mode

Open the indicator settings and select an Optimization Mode.

- Auto applies a parameter group according to the chart timeframe.
- Intraday forces the intraday settings.
- Daily forces the daily settings.
- Weekly forces the weekly settings.
- Manual uses the values entered by the user.

The presets are starting configurations rather than symbol-specific optimizations.

When changing symbols or timeframes, review whether the pivot sensitivity, volume thresholds and moving-average lengths remain appropriate.

## Step 2: Establish the broader context

Begin with the moving averages and the baseline cloud.

Ask:

- Is price above or below the baseline average?
- Are the fast and medium averages moving in the same direction?
- Is price compressed inside the cloud or extended away from it?
- Is price above or below the long-term averages?

Moving averages provide context, not precise entries.

A strong move can remain extended for longer than expected, while sideways markets can cause repeated crossings.

## Step 3: Read the vector-candle states

Echo Vector classifies candles according to relative volume and candle behaviour.

- Echo Pulse marks moderately elevated volume.
- Echo Surge marks stronger relative volume or an elevated volume-spread relationship.
- Echo Peak marks an extreme relative-volume condition.
- Echo Cascade marks consecutive qualifying vector states.
- Blow-off and exhaustion conditions add body-size and statistical-extension requirements.

A coloured candle answers the question:

Did this candle meet the selected relative-volume criteria?

It does not answer:

Will the next candle move higher or lower?

Always compare a vector candle with its location and surrounding structure.

## Step 4: Identify confirmed liquidity references

LQ lines are created from confirmed pivot highs and lows.

A high-side line marks a previous confirmed high. A low-side line marks a previous confirmed low.

Use these lines to examine whether price is:

- approaching an earlier swing;
- trading through the level;
- closing back across it;
- accepting beyond it;
- reacting without reaching it.

The lines are historical price references. They do not show actual stop orders or order-book liquidity.

## Step 5: Examine volume-confirmed pivot zones

The shaded pivot zones require both a confirmed pivot and the selected relative-volume condition.

Zone height can be adjusted with:

- the base tick value;
- relative-volume scaling;
- ATR scaling.

A larger zone does not automatically mean stronger support or resistance. It means that the configured sizing calculation produced a wider reference area.

Watch how price interacts with the zone:

- wick interaction;
- body interaction;
- partial mitigation;
- complete mitigation;
- movement through the zone without reaction.

## Step 6: Read market structure

Echo Vector separates external and internal structure.

External structure describes larger confirmed pivots. Internal structure describes smaller movements inside the broader structure.

Labels can include BOS, CHoCH, internal BOS, internal CHoCH and MSS.

Use them in sequence rather than isolation.

For example:

- an internal bullish change inside an external bearish structure is not automatically a complete trend reversal;
- an external break can be more significant but will normally confirm later;
- wick-based confirmation reacts sooner but can produce more false breaks;
- close-based confirmation reacts later but requires the candle to finish beyond the level.

## Step 7: Use FVG and BPR zones

A bullish FVG appears when the current candle low remains above the high from two candles earlier.

A bearish FVG uses the inverse relationship.

A Balanced Price Range appears where active opposing FVG zones overlap.

Use these zones to study areas of historical imbalance.

Possible observations include:

- price returning into an FVG;
- partial filling;
- complete invalidation;
- reaction near a BPR;
- an imbalance aligning with a structural or liquidity reference.

Price is not required to fill every FVG.

## Step 8: Add session and higher-timeframe context

Enable only the sessions relevant to the market being studied.

Echo Vector can display London, New York, Tokyo, Hong Kong, Sydney, Asia and selected break windows.

The reference-level section can also display:

- previous-day high and low;
- previous-week high and low;
- daily open;
- pivot and M levels;
- average-range levels;
- Psy High and Psy Low;
- Fibonacci retracements.

These levels provide location context.

A condition occurring near a previous-day extreme may have a different context from the same condition occurring in the centre of the daily range.

## Step 9: Interpret condition markers carefully

The script contains optional markers based on combinations of:

- recent highs and lows;
- volume;
- candle bodies;
- wick ratios;
- moving-average distance;
- RSI thresholds;
- price extension.

Treat the markers as analytical filters.

Do not assume that names such as Stop Hunt, Stopping Volume or Liquidity Grab prove the presence of actual stop orders or institutional absorption.

They are OHLCV-based approximations.

Before using a marker, check:

- broader trend;
- external structure;
- internal structure;
- nearby LQ levels;
- active zones;
- session location;
- FVG or BPR location;
- candle-close confirmation.

## Step 10: Understand pivot delay

A confirmed pivot requires later candles.

When Pivot Strength is set to three, three bars to the right must complete before the earlier candle can be confirmed as a pivot.

The script may then place the marker or line on the original pivot candle.

This makes the historical chart easier to read, but the information was not available on the original pivot candle in real time.

The same principle applies to:

- liquidity lines;
- volume-confirmed pivot zones;
- structure pivots;
- dynamic Fibonacci anchors.

## Step 11: Use the outcome table as an observation tool

The table applies fixed target and stop distances to selected historical conditions.

It is useful for comparing how a condition behaved under one set of assumptions.

It is not a strategy backtest.

The table does not include commission, spread, slippage, realistic order fills, position sizing or portfolio equity.

Changing the symbol, timeframe, target, stop or signal filters can materially change the displayed results.

Do not interpret the historical percentage as a probability of future success.

## Step 12: Configure alerts

Select the condition in TradingView’s alert menu.

For conditions based on the active candle, use Once Per Bar Close when confirmed alerts are required.

Without bar-close confirmation, a condition may trigger while the candle is developing and disappear before the candle closes.

Pivot-based divergence or structure conditions naturally occur later because they require right-side confirmation bars.

## Example reading sequence

A structured analysis could follow this order:

- Determine whether price is above or below the baseline and long-term averages.
- Identify the latest external and internal structure direction.
- Mark nearby LQ levels and volume-confirmed pivot zones.
- Check whether price is inside or near an FVG or BPR.
- Identify the active trading session and daily or weekly location.
- Observe whether a Pulse, Surge, Peak or exhaustion condition appears.
- Review any optional marker only after checking its location.
- Wait for candle-close confirmation where required.
- Apply independent risk and execution rules.

The indicator is most useful as a context framework. It should not replace independent analysis or risk management.

## Open-source attribution

Echo Vector is an independent derivative of open-source work associated with TradersReality and the Traders_Reality_Lib.

The supplied original source credits TradersReality, plasmapug, infernix, peshocore and xtech5192.

This publication is not affiliated with or endorsed by TradersReality or Pattern Watchers and is published under the Mozilla Public License 2.0.
ملاحظات الأخبار
updated chart image
ملاحظات الأخبار
This update focuses mainly on improving chart readability and higher-timeframe behaviour.

- Added automatic higher-timeframe cleanup, configurable from a selected timeframe, with 4H as the default.
- Session labels are automatically hidden from 4H and above, while the session areas themselves can remain visible.
- Volume Displacement (VD) signals are automatically disabled from 4H and above to reduce unnecessary higher-timeframe clutter.
- Added a more compact display for bullish and bearish VD signals, using smaller directional markers.
- On Daily and higher, internal market-structure drawings can be automatically suppressed while the underlying structure logic remains active.
- Restored the Condition Outcome Table so the bullish and bearish columns use the actual signal colours as visual swatches, rather than displaying unnecessary “B” and “S” text.
- Existing features such as Minimal Mode remain separate and unchanged.

The goal of the update is to make Echo Vector cleaner and more adaptive across different chart timeframes without removing the underlying analytical functionality.
ملاحظات الأخبار
Echo Vector – Latest Updates

- Fixed the 50 EMA cloud layering so it stays behind the candles during normal chart use. Changed its colour from green to purple.

- Added behind-chart handling for the indicator so the EMA cloud and other visuals remain behind the main price chart where possible.

- Adjusted the EMA cloud plot order so the 50 EMA cloud is placed at the bottom of the indicator’s internal plot stack.

- Reworked session rendering to reduce the large hoverable session-box area that was causing TradingView to temporarily bring the whole indicator forward.

- Added candle-protection handling so when TradingView focuses Echo Vector while hovering objects such as Sessions, FVGs, lines or zones, the EMA cloud remains underneath the visible candles.

- Reduced plot-count usage by converting selected plotshape markers to labels so the candle-protection layer could be added without exceeding TradingView’s plot-count limit.

- Updated the Condition Outcome table terminology:
Target replaces Wins.
Stop replaces Losses.

- Table results now display as:
T:12 S:5 (70.59%)

- Updated the table headers to use Target / Stop terminology.

- Renamed the input:
Invalidation Distance (%) → Stop Distance (%)

- Renamed:
Invalidation Lines → Stop Lines

- Updated the related Stop Line tooltips so they consistently use Stop terminology instead of Invalidation.

- Updated the Outcome Study tooltip to explain results using Target and Stop terminology.

- When both the Target and Stop are reached within the same bar, the historical outcome study continues to count the ambiguous result conservatively as a Stop.

- Renamed the table settings section to:
Outcome Table Settings

- Added a user-selectable position input for the Condition Outcome table.

- Added a separate user-selectable position input for the FVG table.

- Both tables can now independently be positioned at:
Top Left
Top Center
Top Right
Middle Left
Middle Center
Middle Right
Bottom Left
Bottom Center
Bottom Right

- Default table positions remain:
Condition Outcome Table: Top Left
FVG Table: Top Right

إخلاء المسؤولية

لا يُقصد بالمعلومات والمنشورات أن تكون، أو تشكل، أي نصيحة مالية أو استثمارية أو تجارية أو أنواع أخرى من النصائح أو التوصيات المقدمة أو المعتمدة من TradingView. اقرأ المزيد في شروط الاستخدام.