OPEN-SOURCE SCRIPT
Bias Matrix Pro X WTK
# Bias Matrix Pro X — Cinematic Multi-Timeframe Market Bias Engine
## Overview
**Bias Matrix Pro X** is an advanced multi-timeframe market-bias indicator designed to transform complex trend, momentum, volatility, and timeframe-alignment data into one structured and visually intuitive market overview.
Instead of relying on a single moving average, oscillator, or trend signal, the indicator evaluates several independent technical components on up to six customizable timeframes. Each timeframe receives its own directional score, confidence reading, trend-quality assessment, and alignment status.
These individual results are then combined into a weighted aggregate bias ranging from **−100 to +100**.
The goal is not to predict every market movement or generate automatic entries. The indicator is designed to answer a more important contextual question:
**Is the broader market environment currently bullish, bearish, strongly expanding, or balanced?**
Bias Matrix Pro X can be used as a directional filter for discretionary trading systems, price-action setups, liquidity concepts, breakout strategies, pullback entries, trend-following systems, and multi-timeframe analysis.
---
## Core Concept
Every selected timeframe is analyzed through a combination of:
* Fast and slow EMA structure
* Price location relative to the fast EMA
* Fast EMA slope
* RSI regime
* MACD histogram direction
* Supertrend direction
* ADX-based trend-quality adjustment
* Full component-alignment bonus
Each component produces one of three states:
* **+1:** Bullish
* **0:** Neutral
* **−1:** Bearish
The component states are multiplied by their individual importance weights and combined into a raw directional score.
The score is then adjusted by ADX to account for trend quality.
A directional signal occurring in a strong, established market receives more credibility than the same signal occurring in weak or directionless conditions.
The final score is limited to a range between:
* **+100:** Maximum bullish pressure
* **0:** Balanced or conflicting conditions
* **−100:** Maximum bearish pressure
---
# The Bias Engine
## 1. EMA Structure
The indicator compares the fast EMA with the slow EMA.
Default values:
* Fast EMA: 21
* Slow EMA: 55
Interpretation:
* Fast EMA above slow EMA: bullish
* Fast EMA below slow EMA: bearish
* Equal values: neutral
This component represents the underlying trend structure of the selected timeframe.
Its default weight is **25**, making it the most influential individual component in the engine.
---
## 2. Price Location
The current closing price is compared with the fast EMA.
Interpretation:
* Price above the fast EMA: bullish
* Price below the fast EMA: bearish
* Price equal to the fast EMA: neutral
This determines whether price is currently trading on the supportive or opposing side of the local trend average.
Its default weight is **10**.
Price location reacts faster than the EMA structure and can therefore identify short-term pullbacks or early shifts before the slower trend structure changes.
---
## 3. EMA Slope
The indicator measures the difference between the current fast EMA and its value several bars earlier.
Default slope lookback:
* 2 timeframe bars
Unlike a basic rising-or-falling calculation, the slope component uses an ATR-based neutral zone.
A tiny EMA movement is not automatically classified as a meaningful trend.
The default neutral band is:
* 0.04 × ATR
Interpretation:
* EMA rise greater than the neutral band: bullish
* EMA decline greater than the neutral band: bearish
* Movement inside the neutral band: neutral
This reduces unnecessary signal changes during flat or low-volatility conditions.
Its default weight is **15**.
---
## 4. RSI Regime
RSI is used as a directional regime filter rather than as a traditional overbought or oversold signal.
Default settings:
* RSI length: 14
* Bullish threshold: 55
* Bearish threshold: 45
Interpretation:
* RSI above 55: bullish momentum regime
* RSI below 45: bearish momentum regime
* RSI between 45 and 55: neutral momentum regime
The neutral zone helps prevent the indicator from treating every move above or below RSI 50 as a meaningful directional confirmation.
Its default weight is **10**.
---
## 5. MACD Momentum
The MACD histogram is used to measure directional momentum.
Default settings:
* Fast length: 12
* Slow length: 26
* Signal length: 9
Interpretation:
* MACD histogram above zero: bullish
* MACD histogram below zero: bearish
* MACD histogram equal to zero: neutral
This component helps identify whether momentum supports or opposes the broader EMA structure.
Its default weight is **15**.
---
## 6. Supertrend Direction
Supertrend provides an additional volatility-adjusted directional reading.
Default settings:
* ATR length: 10
* Factor: 2.5
Interpretation:
* Bullish Supertrend direction: bullish
* Bearish Supertrend direction: bearish
Its default weight is **15**.
The Supertrend component can help distinguish trending conditions from ordinary price fluctuations around the moving averages.
---
## 7. Full Alignment Bonus
A bonus is added when the following components all point in the same non-neutral direction:
* EMA structure
* Price location
* EMA slope
* MACD momentum
* Supertrend direction
When all five agree, the engine adds an additional directional score.
Default alignment bonus:
* 10 points
This allows fully synchronized conditions to receive a stronger score than markets where only some components agree.
RSI is still included in the main score, but it is not required for the full-alignment bonus.
---
## 8. ADX Quality Adjustment
ADX does not determine bullish or bearish direction.
Instead, it adjusts the strength of the combined directional score.
Default ADX reference:
* 25
The indicator applies an internal multiplier ranging approximately from:
* 0.65 during weak conditions
* Up to 1.10 during stronger conditions
This means:
* Weak trend conditions reduce the final score.
* Strong trend conditions preserve or slightly enhance it.
* Directional signals in low-quality conditions are treated more cautiously.
The final score is capped between −100 and +100.
---
# Multi-Timeframe Weighting
Bias Matrix Pro X supports up to six customizable timeframes.
Default configuration:
* 5-minute: weight 1.0
* 15-minute: weight 1.5
* 1-hour: weight 2.0
* 4-hour: weight 2.5
* Daily: weight 3.0
* Weekly: weight 3.5
Higher timeframes receive more influence by default because they generally represent broader and more persistent market structure.
The aggregate score is calculated as a weighted average:
**Aggregate Score = Sum of timeframe score × timeframe weight ÷ total valid weight**
This prevents a short-term timeframe from automatically carrying the same influence as a daily or weekly timeframe.
All timeframe values and weights can be customized.
A weight of zero effectively removes that timeframe from the aggregate score.
Duplicate timeframes are ignored to prevent accidental double-counting.
---
# Market Regimes
The aggregate score is converted into five possible market regimes.
With the default thresholds:
## Expansion Bull
Displayed when:
**Aggregate score ≥ +55**
This represents strong bullish multi-timeframe alignment.
Typical characteristics may include:
* Bullish EMA structure
* Positive momentum
* Rising EMA slope
* Supportive Supertrend direction
* Stronger ADX conditions
* Agreement across several weighted timeframes
This does not mean price must move upward immediately. It means the broader technical environment strongly favors bullish continuation compared with bearish continuation.
---
## Bullish
Displayed when:
**Aggregate score is between +18 and +54.9**
The market has a bullish directional advantage, but the alignment is less powerful than an Expansion Bull regime.
This condition may appear during:
* Developing bullish trends
* Pullbacks inside larger bullish structures
* Mixed lower-timeframe momentum
* Bullish higher timeframes with temporary short-term weakness
---
## Balanced
Displayed when:
**Aggregate score is between −18 and +18**
Balanced does not necessarily mean that the market is inactive.
It means that the selected timeframes and technical components do not provide a sufficiently strong directional advantage.
Balanced conditions can occur during:
* Consolidation
* Range-bound price action
* Trend transitions
* Conflicting timeframes
* Low-momentum environments
* Pullbacks against a larger trend
Balanced conditions are often where directional systems may experience lower-quality signals.
---
## Bearish
Displayed when:
**Aggregate score is between −18 and −54.9**
The market has a bearish directional advantage, but full bearish expansion is not yet present.
---
## Expansion Bear
Displayed when:
**Aggregate score ≤ −55**
This represents strong bearish multi-timeframe alignment and directional pressure.
---
# How to Read the Dashboard
The dashboard provides one row for every valid selected timeframe.
## TF
Displays the analyzed timeframe.
Examples:
* 5
* 15
* 60
* 240
* D
* W
PulseWire timeframe notation is used.
---
## Weight
Shows how much influence the timeframe has on the aggregate score.
A timeframe with a weight of 3.0 contributes three times as much as a timeframe with a weight of 1.0.
The weight affects the final multi-timeframe result, but it does not change the timeframe’s individual score.
---
## Bias
Displays the directional classification of the timeframe.
* **▲ BULLISH:** Score is above the positive bias threshold
* **▼ BEARISH:** Score is below the negative bias threshold
* **◆ NEUTRAL:** Score remains between the two thresholds
The background color provides immediate visual identification:
* Green: bullish
* Red: bearish
* Amber: neutral
---
## Score
Displays the calculated score for that individual timeframe.
The approximate interpretation is:
* +80 to +100: exceptionally strong bullish alignment
* +55 to +79: strong bullish expansion
* +18 to +54: bullish advantage
* −17 to +17: neutral or conflicting
* −18 to −54: bearish advantage
* −55 to −79: strong bearish expansion
* −80 to −100: exceptionally strong bearish alignment
The score should be interpreted as a directional alignment measurement, not as a probability of a winning trade.
For example, a score of +70 does not mean there is a 70% probability that price will rise.
---
## Power
The Power meter visualizes the absolute size of the timeframe score.
Example:
**████████░░**
A fuller meter means the timeframe has a stronger directional score.
The meter measures strength, while its color shows direction:
* Green meter: bullish power
* Red meter: bearish power
* Amber meter: neutral or balanced condition
A score of +70 and a score of −70 display similar meter lengths, but with different directional colors.
---
## RSI
Displays the current RSI value calculated on that timeframe.
This allows the user to see whether the RSI component is:
* Above the bullish threshold
* Below the bearish threshold
* Inside the neutral zone
---
## ADX
Displays the ADX value and a simplified trend-quality classification.
Possible classifications:
* Low
* Medium
* Good
* High
These labels are calculated relative to the selected ADX reference value.
With the default reference of 25:
* Values well below 25 indicate weaker trend quality.
* Values around 25 indicate established directional conditions.
* Values above the reference indicate stronger trend quality.
ADX measures trend strength, not direction.
A high ADX can occur in both bullish and bearish markets.
---
## Alignment
The Alignment column compares several internal directional components.
### Full
Displayed when the following components all agree in the same non-neutral direction:
* EMA structure
* Price location
* EMA slope
* MACD histogram
* Supertrend
Full alignment represents the highest level of internal directional synchronization.
### Partial
Displayed when EMA structure and price location agree, but the remaining components are not fully synchronized.
### Mixed
Displayed when the internal components conflict.
A bullish timeframe with Mixed alignment may still have a positive score, but the move has less internal agreement than a Full bullish timeframe.
---
# Dashboard Summary
The Summary row combines all valid weighted timeframes.
It displays:
* Number of valid timeframes
* Aggregate bullish, bearish, or neutral state
* Aggregate score
* Aggregate Power meter
* Total bullish timeframe weight
* Total bearish timeframe weight
* Total neutral timeframe weight
The Bull W, Bear W, and Neutral W values represent the sum of timeframe weights classified in each category.
Example:
* Bull W: 7.5
* Bear W: 2.0
* Neutral W: 1.0
This provides more context than a simple count because higher-weight timeframes have greater importance.
---
# Dominance
The live regime label displays a Dominance percentage.
Dominance measures the percentage of total valid timeframe weight belonging to the largest bias group:
* Bullish
* Bearish
* Neutral
Example:
If bullish timeframes represent 70% of the total valid weight, Dominance will display approximately 70%.
Dominance is not the same as the aggregate score.
The aggregate score measures the average directional intensity of all timeframes.
Dominance measures how concentrated the timeframe classifications are in one category.
A market can therefore have:
* High bullish dominance but only a moderate bullish score
* Lower dominance but a strong score from a few heavily weighted timeframes
* High neutral dominance during consolidation
---
# Local Market Reading
The Engine section also displays the current chart timeframe separately.
It includes:
* Local bias
* Local score
* Local RSI
* Local ADX
* Local ADX-quality classification
This makes it possible to compare the current execution timeframe with the broader multi-timeframe environment.
Example:
* Aggregate regime: Expansion Bull
* Local timeframe: Neutral
This may indicate that the broader market remains bullish while the execution timeframe is currently consolidating or pulling back.
Another example:
* Aggregate regime: Bearish
* Local timeframe: Bullish
This may represent a short-term countertrend rally against a broader bearish environment.
---
# Chart Visuals
## Trend Ribbon
The chart displays the fast and slow EMAs from the current chart timeframe.
The area between them is filled to create a visual trend ribbon.
The ribbon color is based on the aggregate multi-timeframe regime:
* Green: bullish aggregate environment
* Red: bearish aggregate environment
* Amber: balanced environment
Important distinction:
The EMA values come from the current chart timeframe, while their color reflects the combined multi-timeframe result.
---
## Supertrend Aura
The current chart timeframe’s Supertrend line is displayed as a softer secondary trend layer.
Its color also follows the aggregate market regime.
This creates a visual connection between local price structure and the broader multi-timeframe bias.
---
## Chart Glow
When enabled, the chart background receives a subtle regime color:
* Green glow: bullish
* Red glow: bearish
* Amber glow: balanced
The glow is deliberately transparent so it can provide directional context without hiding price action.
---
## Candle Tint
When enabled, candle colors are tinted according to the aggregate regime.
The tint intensity is influenced by the local timeframe’s score strength.
This creates a combined visual effect:
* Direction comes from the aggregate multi-timeframe bias.
* Tint intensity is influenced by local confidence.
---
## Bias Shift Markers
The indicator marks changes in the aggregate bias classification.
### BIAS+
Appears when the aggregate state changes into bullish territory.
### BIAS−
Appears when the aggregate state changes into bearish territory.
### Neutral Marker
A small amber marker appears when the aggregate state returns to neutral.
These markers identify regime transitions. They are not intended to be used as standalone entry signals.
A bias shift can occur after part of a market move has already developed because the engine requires sufficient technical confirmation.
---
## Live Regime Label
The label near the most recent candle displays:
* Indicator name
* Current market regime
* Aggregate score
* Dominance percentage
This provides a compact real-time overview without requiring the user to inspect the full dashboard.
---
# Dark Mode and Light Mode
Bias Matrix Pro X includes two complete dashboard themes.
## Dark Mode
Designed for dark PulseWire charts.
It uses:
* Deep navy backgrounds
* High-contrast text
* Gold title elements
* Soft green, red, amber, and blue status panels
## Light Mode
Designed for white or light PulseWire layouts.
It uses:
* Light neutral backgrounds
* Dark readable text
* Softer transparent status colors
* Reduced visual harshness
The selected theme affects the dashboard and live regime label.
Users can also customize:
* Dashboard position
* Dashboard text size
* Dashboard visibility
* Chart glow
* Candle tint
* Trend ribbon
* Live regime label
---
# Confirmed Higher-Timeframe Mode
The setting **Use confirmed higher-TF values only** is enabled by default.
When enabled, higher-timeframe readings use the most recently completed candle from each requested higher timeframe.
This provides stable historical and real-time higher-timeframe values.
Example:
On a 5-minute chart, the 4-hour row will use the last fully completed 4-hour candle rather than the currently developing 4-hour candle.
Advantages:
* More stable multi-timeframe readings
* Reduced higher-timeframe repainting
* More reliable historical comparison
* Better suitability for rule-based filters
Trade-off:
* The higher-timeframe reading updates only after the higher-timeframe candle closes.
* It is intentionally one completed higher-timeframe candle behind the live developing candle.
The current chart timeframe still uses the active chart data and can change until the current chart candle closes.
---
## Unconfirmed Higher-Timeframe Mode
When confirmed higher-timeframe values are disabled, the indicator uses the currently developing higher-timeframe candle.
Advantages:
* Faster response to developing market changes
* Earlier recognition of possible regime shifts
Trade-offs:
* Higher-timeframe values can change before the candle closes.
* Historical readings after a chart reload may differ from what was visible during the live candle.
* Signals are less stable and should be treated as provisional.
For systematic or confirmation-based use, confirmed higher-timeframe mode is generally the more conservative setting.
---
# Lower-Timeframe Protection
The indicator intentionally blocks requested timeframes that are lower than the current chart timeframe.
Example:
* Current chart: 15 minutes
* Requested timeframe: 5 minutes
The 5-minute row will display:
**LTF blocked**
This is intentional.
A simple higher-timeframe request method does not provide a complete and reliable lower-timeframe evaluation when used from a larger chart timeframe.
To analyze the default 5-minute timeframe, the chart should therefore be set to 5 minutes or lower.
Recommended rule:
**Use a chart timeframe that is equal to or lower than the smallest selected dashboard timeframe.**
---
# Suggested Usage
Bias Matrix Pro X is designed primarily as a context and filtering tool.
## Trend-Following Example
A trader may choose to:
* Look for long setups only during Bullish or Expansion Bull regimes.
* Look for short setups only during Bearish or Expansion Bear regimes.
* Reduce activity during Balanced conditions.
* Require the execution timeframe to move back into alignment with the aggregate bias before entering.
---
## Pullback Example
Possible bullish sequence:
1. Aggregate regime is Bullish or Expansion Bull.
2. Higher timeframes remain bullish.
3. Local timeframe becomes Neutral or temporarily Bearish during a pullback.
4. Local momentum begins turning bullish again.
5. The trader applies a separate entry model.
The indicator does not identify the exact pullback entry. It provides the directional environment in which the trader can evaluate the setup.
---
## Breakout Example
Before taking a bullish breakout, a trader may check whether:
* Aggregate score is positive
* Dominance favors bullish timeframes
* Higher-weight timeframes are bullish
* ADX quality is Good or High
* Alignment is Full or Partial
* The local timeframe is not strongly opposing the breakout
---
## Countertrend Warning
If a trader identifies a long setup while the indicator displays:
* Expansion Bear
* Strong negative aggregate score
* High bearish dominance
* Bearish higher-timeframe alignment
The setup is occurring against the broader technical environment.
This does not automatically make the trade invalid, but it identifies the trade as countertrend and potentially higher risk.
---
# Recommended Starting Configuration
For intraday trading, the default configuration provides a broad hierarchy:
* 5-minute: execution context
* 15-minute: short-term structure
* 1-hour: intraday directional structure
* 4-hour: higher-timeframe trend
* Daily: major market regime
* Weekly: long-term context
Users should adjust the selected timeframes and weights to match their trading horizon.
### Scalping Example
* 1-minute chart
* 3-minute
* 5-minute
* 15-minute
* 30-minute
* 1-hour
* 4-hour
Higher weights can be assigned to the 15-minute, 1-hour, and 4-hour timeframes.
### Swing-Trading Example
* 1-hour or 4-hour chart
* 4-hour
* Daily
* Weekly
* Monthly
Lower requested timeframes should not be used below the active chart timeframe.
---
# Important Settings
## Bias Threshold
Controls how much positive or negative score is required before a timeframe is classified as directional.
Default:
* 18
Higher values:
* Produce fewer bullish and bearish classifications
* Increase the neutral range
* Require stronger alignment
Lower values:
* React faster
* Produce more directional classifications
* May create more frequent regime changes
---
## Strong Bias Threshold
Defines when Bullish or Bearish becomes an Expansion regime.
Default:
* 55
This setting affects the regime name and visual classification.
It does not change the basic bullish or bearish threshold.
---
## Component Weights
Every technical component can be weighted independently.
Increasing a component’s weight gives it more influence over each timeframe score.
Examples:
* Increasing EMA Structure favors slower trend confirmation.
* Increasing Price vs Fast EMA makes the system more reactive to local price changes.
* Increasing EMA Slope gives more importance to trend acceleration.
* Increasing RSI emphasizes momentum regime.
* Increasing MACD emphasizes momentum direction.
* Increasing Supertrend emphasizes volatility-adjusted trend direction.
* Increasing Full Alignment Bonus rewards synchronized conditions more strongly.
Weights should be modified carefully.
Extreme weighting can cause one component to dominate the engine and reduce the value of combining several independent measurements.
---
## Timeframe Weights
Timeframe weights determine influence over the final aggregate score.
They do not affect the internal score of the individual timeframe.
A higher weight means the timeframe has greater influence over:
* Aggregate score
* Aggregate bias
* Bullish, bearish, and neutral weight totals
* Dominance
---
# Practical Interpretation Guidelines
## Strongest Bullish Environment
Look for a combination such as:
* Expansion Bull regime
* Positive score above +55
* High bullish dominance
* Higher-weight timeframes bullish
* Good or High ADX quality
* Full alignment on several timeframes
* Local timeframe turning bullish after a pullback
---
## Strongest Bearish Environment
Look for:
* Expansion Bear regime
* Score below −55
* High bearish dominance
* Higher-weight timeframes bearish
* Good or High ADX quality
* Full bearish alignment
* Local timeframe turning bearish after a corrective rally
---
## Caution Environment
Exercise caution when:
* Aggregate regime is Balanced
* Dominance is low
* Higher and lower timeframes conflict
* Most rows display Mixed alignment
* ADX quality is Low
* The aggregate bias changes frequently
* The selected chart timeframe is too high for the configured lower timeframes
---
# Important Limitations
Bias Matrix Pro X is a technical analysis tool, not a complete trading system.
It does not include:
* Automatic entries
* Stop-loss placement
* Take-profit placement
* Position sizing
* Risk management
* Fundamental analysis
* News-event filtering
* Liquidity analysis
* Market-session filtering
* Volume-profile analysis
* Guaranteed non-lagging signals
The indicator combines several lagging and reactive technical measurements.
Because the engine requires confirmation, regime changes may occur after a market move has already started.
Strong bullish conditions can appear close to a temporary top.
Strong bearish conditions can appear close to a temporary bottom.
A high score describes technical alignment, not guaranteed future direction.
The indicator should therefore be combined with:
* A defined entry model
* Clear invalidation logic
* Position sizing
* Maximum-risk rules
* Session awareness
* Economic-news awareness
* Independent testing
---
# Repainting and Real-Time Behavior
With confirmed higher-timeframe mode enabled:
* Completed higher-timeframe readings remain stable.
* Historical higher-timeframe values are based on completed candles.
* The current chart timeframe continues to update while its active candle is open.
* A local score or aggregate score may still change before the current chart candle closes.
With confirmed higher-timeframe mode disabled:
* Developing higher-timeframe values can change during the active higher-timeframe candle.
* Bias states and chart visuals may update before candle confirmation.
* Historical behavior after reloading the chart may differ from what was observed intrabar.
Users who require stable confirmation should evaluate signals after the chart candle closes and keep confirmed higher-timeframe mode enabled.
---
# Final Notes
Bias Matrix Pro X was created to provide a structured visual answer to three questions:
1. **What is the directional condition of each important timeframe?**
2. **How strong and internally aligned is that condition?**
3. **What is the combined weighted market regime?**
The indicator is intentionally information-rich, but the main reading remains simple:
* Green favors bullish conditions.
* Red favors bearish conditions.
* Amber represents balance or conflict.
* Higher absolute scores represent stronger directional alignment.
* Higher dominance represents broader agreement between the selected timeframes.
* Full alignment represents stronger internal synchronization.
* ADX indicates the quality of the directional environment.
Use the indicator as a market-context framework, not as a standalone promise of future performance.
---
## Disclaimer
This indicator is provided for educational and informational purposes only.
It does not constitute financial advice, investment advice, or a recommendation to buy or sell any financial instrument.
Past performance and historical technical alignment do not guarantee future results.
Trading involves substantial risk, including the possible loss of capital. Every user is responsible for conducting independent research, testing the indicator on the relevant market and timeframe, and applying appropriate risk management.
## Overview
**Bias Matrix Pro X** is an advanced multi-timeframe market-bias indicator designed to transform complex trend, momentum, volatility, and timeframe-alignment data into one structured and visually intuitive market overview.
Instead of relying on a single moving average, oscillator, or trend signal, the indicator evaluates several independent technical components on up to six customizable timeframes. Each timeframe receives its own directional score, confidence reading, trend-quality assessment, and alignment status.
These individual results are then combined into a weighted aggregate bias ranging from **−100 to +100**.
The goal is not to predict every market movement or generate automatic entries. The indicator is designed to answer a more important contextual question:
**Is the broader market environment currently bullish, bearish, strongly expanding, or balanced?**
Bias Matrix Pro X can be used as a directional filter for discretionary trading systems, price-action setups, liquidity concepts, breakout strategies, pullback entries, trend-following systems, and multi-timeframe analysis.
---
## Core Concept
Every selected timeframe is analyzed through a combination of:
* Fast and slow EMA structure
* Price location relative to the fast EMA
* Fast EMA slope
* RSI regime
* MACD histogram direction
* Supertrend direction
* ADX-based trend-quality adjustment
* Full component-alignment bonus
Each component produces one of three states:
* **+1:** Bullish
* **0:** Neutral
* **−1:** Bearish
The component states are multiplied by their individual importance weights and combined into a raw directional score.
The score is then adjusted by ADX to account for trend quality.
A directional signal occurring in a strong, established market receives more credibility than the same signal occurring in weak or directionless conditions.
The final score is limited to a range between:
* **+100:** Maximum bullish pressure
* **0:** Balanced or conflicting conditions
* **−100:** Maximum bearish pressure
---
# The Bias Engine
## 1. EMA Structure
The indicator compares the fast EMA with the slow EMA.
Default values:
* Fast EMA: 21
* Slow EMA: 55
Interpretation:
* Fast EMA above slow EMA: bullish
* Fast EMA below slow EMA: bearish
* Equal values: neutral
This component represents the underlying trend structure of the selected timeframe.
Its default weight is **25**, making it the most influential individual component in the engine.
---
## 2. Price Location
The current closing price is compared with the fast EMA.
Interpretation:
* Price above the fast EMA: bullish
* Price below the fast EMA: bearish
* Price equal to the fast EMA: neutral
This determines whether price is currently trading on the supportive or opposing side of the local trend average.
Its default weight is **10**.
Price location reacts faster than the EMA structure and can therefore identify short-term pullbacks or early shifts before the slower trend structure changes.
---
## 3. EMA Slope
The indicator measures the difference between the current fast EMA and its value several bars earlier.
Default slope lookback:
* 2 timeframe bars
Unlike a basic rising-or-falling calculation, the slope component uses an ATR-based neutral zone.
A tiny EMA movement is not automatically classified as a meaningful trend.
The default neutral band is:
* 0.04 × ATR
Interpretation:
* EMA rise greater than the neutral band: bullish
* EMA decline greater than the neutral band: bearish
* Movement inside the neutral band: neutral
This reduces unnecessary signal changes during flat or low-volatility conditions.
Its default weight is **15**.
---
## 4. RSI Regime
RSI is used as a directional regime filter rather than as a traditional overbought or oversold signal.
Default settings:
* RSI length: 14
* Bullish threshold: 55
* Bearish threshold: 45
Interpretation:
* RSI above 55: bullish momentum regime
* RSI below 45: bearish momentum regime
* RSI between 45 and 55: neutral momentum regime
The neutral zone helps prevent the indicator from treating every move above or below RSI 50 as a meaningful directional confirmation.
Its default weight is **10**.
---
## 5. MACD Momentum
The MACD histogram is used to measure directional momentum.
Default settings:
* Fast length: 12
* Slow length: 26
* Signal length: 9
Interpretation:
* MACD histogram above zero: bullish
* MACD histogram below zero: bearish
* MACD histogram equal to zero: neutral
This component helps identify whether momentum supports or opposes the broader EMA structure.
Its default weight is **15**.
---
## 6. Supertrend Direction
Supertrend provides an additional volatility-adjusted directional reading.
Default settings:
* ATR length: 10
* Factor: 2.5
Interpretation:
* Bullish Supertrend direction: bullish
* Bearish Supertrend direction: bearish
Its default weight is **15**.
The Supertrend component can help distinguish trending conditions from ordinary price fluctuations around the moving averages.
---
## 7. Full Alignment Bonus
A bonus is added when the following components all point in the same non-neutral direction:
* EMA structure
* Price location
* EMA slope
* MACD momentum
* Supertrend direction
When all five agree, the engine adds an additional directional score.
Default alignment bonus:
* 10 points
This allows fully synchronized conditions to receive a stronger score than markets where only some components agree.
RSI is still included in the main score, but it is not required for the full-alignment bonus.
---
## 8. ADX Quality Adjustment
ADX does not determine bullish or bearish direction.
Instead, it adjusts the strength of the combined directional score.
Default ADX reference:
* 25
The indicator applies an internal multiplier ranging approximately from:
* 0.65 during weak conditions
* Up to 1.10 during stronger conditions
This means:
* Weak trend conditions reduce the final score.
* Strong trend conditions preserve or slightly enhance it.
* Directional signals in low-quality conditions are treated more cautiously.
The final score is capped between −100 and +100.
---
# Multi-Timeframe Weighting
Bias Matrix Pro X supports up to six customizable timeframes.
Default configuration:
* 5-minute: weight 1.0
* 15-minute: weight 1.5
* 1-hour: weight 2.0
* 4-hour: weight 2.5
* Daily: weight 3.0
* Weekly: weight 3.5
Higher timeframes receive more influence by default because they generally represent broader and more persistent market structure.
The aggregate score is calculated as a weighted average:
**Aggregate Score = Sum of timeframe score × timeframe weight ÷ total valid weight**
This prevents a short-term timeframe from automatically carrying the same influence as a daily or weekly timeframe.
All timeframe values and weights can be customized.
A weight of zero effectively removes that timeframe from the aggregate score.
Duplicate timeframes are ignored to prevent accidental double-counting.
---
# Market Regimes
The aggregate score is converted into five possible market regimes.
With the default thresholds:
## Expansion Bull
Displayed when:
**Aggregate score ≥ +55**
This represents strong bullish multi-timeframe alignment.
Typical characteristics may include:
* Bullish EMA structure
* Positive momentum
* Rising EMA slope
* Supportive Supertrend direction
* Stronger ADX conditions
* Agreement across several weighted timeframes
This does not mean price must move upward immediately. It means the broader technical environment strongly favors bullish continuation compared with bearish continuation.
---
## Bullish
Displayed when:
**Aggregate score is between +18 and +54.9**
The market has a bullish directional advantage, but the alignment is less powerful than an Expansion Bull regime.
This condition may appear during:
* Developing bullish trends
* Pullbacks inside larger bullish structures
* Mixed lower-timeframe momentum
* Bullish higher timeframes with temporary short-term weakness
---
## Balanced
Displayed when:
**Aggregate score is between −18 and +18**
Balanced does not necessarily mean that the market is inactive.
It means that the selected timeframes and technical components do not provide a sufficiently strong directional advantage.
Balanced conditions can occur during:
* Consolidation
* Range-bound price action
* Trend transitions
* Conflicting timeframes
* Low-momentum environments
* Pullbacks against a larger trend
Balanced conditions are often where directional systems may experience lower-quality signals.
---
## Bearish
Displayed when:
**Aggregate score is between −18 and −54.9**
The market has a bearish directional advantage, but full bearish expansion is not yet present.
---
## Expansion Bear
Displayed when:
**Aggregate score ≤ −55**
This represents strong bearish multi-timeframe alignment and directional pressure.
---
# How to Read the Dashboard
The dashboard provides one row for every valid selected timeframe.
## TF
Displays the analyzed timeframe.
Examples:
* 5
* 15
* 60
* 240
* D
* W
PulseWire timeframe notation is used.
---
## Weight
Shows how much influence the timeframe has on the aggregate score.
A timeframe with a weight of 3.0 contributes three times as much as a timeframe with a weight of 1.0.
The weight affects the final multi-timeframe result, but it does not change the timeframe’s individual score.
---
## Bias
Displays the directional classification of the timeframe.
* **▲ BULLISH:** Score is above the positive bias threshold
* **▼ BEARISH:** Score is below the negative bias threshold
* **◆ NEUTRAL:** Score remains between the two thresholds
The background color provides immediate visual identification:
* Green: bullish
* Red: bearish
* Amber: neutral
---
## Score
Displays the calculated score for that individual timeframe.
The approximate interpretation is:
* +80 to +100: exceptionally strong bullish alignment
* +55 to +79: strong bullish expansion
* +18 to +54: bullish advantage
* −17 to +17: neutral or conflicting
* −18 to −54: bearish advantage
* −55 to −79: strong bearish expansion
* −80 to −100: exceptionally strong bearish alignment
The score should be interpreted as a directional alignment measurement, not as a probability of a winning trade.
For example, a score of +70 does not mean there is a 70% probability that price will rise.
---
## Power
The Power meter visualizes the absolute size of the timeframe score.
Example:
**████████░░**
A fuller meter means the timeframe has a stronger directional score.
The meter measures strength, while its color shows direction:
* Green meter: bullish power
* Red meter: bearish power
* Amber meter: neutral or balanced condition
A score of +70 and a score of −70 display similar meter lengths, but with different directional colors.
---
## RSI
Displays the current RSI value calculated on that timeframe.
This allows the user to see whether the RSI component is:
* Above the bullish threshold
* Below the bearish threshold
* Inside the neutral zone
---
## ADX
Displays the ADX value and a simplified trend-quality classification.
Possible classifications:
* Low
* Medium
* Good
* High
These labels are calculated relative to the selected ADX reference value.
With the default reference of 25:
* Values well below 25 indicate weaker trend quality.
* Values around 25 indicate established directional conditions.
* Values above the reference indicate stronger trend quality.
ADX measures trend strength, not direction.
A high ADX can occur in both bullish and bearish markets.
---
## Alignment
The Alignment column compares several internal directional components.
### Full
Displayed when the following components all agree in the same non-neutral direction:
* EMA structure
* Price location
* EMA slope
* MACD histogram
* Supertrend
Full alignment represents the highest level of internal directional synchronization.
### Partial
Displayed when EMA structure and price location agree, but the remaining components are not fully synchronized.
### Mixed
Displayed when the internal components conflict.
A bullish timeframe with Mixed alignment may still have a positive score, but the move has less internal agreement than a Full bullish timeframe.
---
# Dashboard Summary
The Summary row combines all valid weighted timeframes.
It displays:
* Number of valid timeframes
* Aggregate bullish, bearish, or neutral state
* Aggregate score
* Aggregate Power meter
* Total bullish timeframe weight
* Total bearish timeframe weight
* Total neutral timeframe weight
The Bull W, Bear W, and Neutral W values represent the sum of timeframe weights classified in each category.
Example:
* Bull W: 7.5
* Bear W: 2.0
* Neutral W: 1.0
This provides more context than a simple count because higher-weight timeframes have greater importance.
---
# Dominance
The live regime label displays a Dominance percentage.
Dominance measures the percentage of total valid timeframe weight belonging to the largest bias group:
* Bullish
* Bearish
* Neutral
Example:
If bullish timeframes represent 70% of the total valid weight, Dominance will display approximately 70%.
Dominance is not the same as the aggregate score.
The aggregate score measures the average directional intensity of all timeframes.
Dominance measures how concentrated the timeframe classifications are in one category.
A market can therefore have:
* High bullish dominance but only a moderate bullish score
* Lower dominance but a strong score from a few heavily weighted timeframes
* High neutral dominance during consolidation
---
# Local Market Reading
The Engine section also displays the current chart timeframe separately.
It includes:
* Local bias
* Local score
* Local RSI
* Local ADX
* Local ADX-quality classification
This makes it possible to compare the current execution timeframe with the broader multi-timeframe environment.
Example:
* Aggregate regime: Expansion Bull
* Local timeframe: Neutral
This may indicate that the broader market remains bullish while the execution timeframe is currently consolidating or pulling back.
Another example:
* Aggregate regime: Bearish
* Local timeframe: Bullish
This may represent a short-term countertrend rally against a broader bearish environment.
---
# Chart Visuals
## Trend Ribbon
The chart displays the fast and slow EMAs from the current chart timeframe.
The area between them is filled to create a visual trend ribbon.
The ribbon color is based on the aggregate multi-timeframe regime:
* Green: bullish aggregate environment
* Red: bearish aggregate environment
* Amber: balanced environment
Important distinction:
The EMA values come from the current chart timeframe, while their color reflects the combined multi-timeframe result.
---
## Supertrend Aura
The current chart timeframe’s Supertrend line is displayed as a softer secondary trend layer.
Its color also follows the aggregate market regime.
This creates a visual connection between local price structure and the broader multi-timeframe bias.
---
## Chart Glow
When enabled, the chart background receives a subtle regime color:
* Green glow: bullish
* Red glow: bearish
* Amber glow: balanced
The glow is deliberately transparent so it can provide directional context without hiding price action.
---
## Candle Tint
When enabled, candle colors are tinted according to the aggregate regime.
The tint intensity is influenced by the local timeframe’s score strength.
This creates a combined visual effect:
* Direction comes from the aggregate multi-timeframe bias.
* Tint intensity is influenced by local confidence.
---
## Bias Shift Markers
The indicator marks changes in the aggregate bias classification.
### BIAS+
Appears when the aggregate state changes into bullish territory.
### BIAS−
Appears when the aggregate state changes into bearish territory.
### Neutral Marker
A small amber marker appears when the aggregate state returns to neutral.
These markers identify regime transitions. They are not intended to be used as standalone entry signals.
A bias shift can occur after part of a market move has already developed because the engine requires sufficient technical confirmation.
---
## Live Regime Label
The label near the most recent candle displays:
* Indicator name
* Current market regime
* Aggregate score
* Dominance percentage
This provides a compact real-time overview without requiring the user to inspect the full dashboard.
---
# Dark Mode and Light Mode
Bias Matrix Pro X includes two complete dashboard themes.
## Dark Mode
Designed for dark PulseWire charts.
It uses:
* Deep navy backgrounds
* High-contrast text
* Gold title elements
* Soft green, red, amber, and blue status panels
## Light Mode
Designed for white or light PulseWire layouts.
It uses:
* Light neutral backgrounds
* Dark readable text
* Softer transparent status colors
* Reduced visual harshness
The selected theme affects the dashboard and live regime label.
Users can also customize:
* Dashboard position
* Dashboard text size
* Dashboard visibility
* Chart glow
* Candle tint
* Trend ribbon
* Live regime label
---
# Confirmed Higher-Timeframe Mode
The setting **Use confirmed higher-TF values only** is enabled by default.
When enabled, higher-timeframe readings use the most recently completed candle from each requested higher timeframe.
This provides stable historical and real-time higher-timeframe values.
Example:
On a 5-minute chart, the 4-hour row will use the last fully completed 4-hour candle rather than the currently developing 4-hour candle.
Advantages:
* More stable multi-timeframe readings
* Reduced higher-timeframe repainting
* More reliable historical comparison
* Better suitability for rule-based filters
Trade-off:
* The higher-timeframe reading updates only after the higher-timeframe candle closes.
* It is intentionally one completed higher-timeframe candle behind the live developing candle.
The current chart timeframe still uses the active chart data and can change until the current chart candle closes.
---
## Unconfirmed Higher-Timeframe Mode
When confirmed higher-timeframe values are disabled, the indicator uses the currently developing higher-timeframe candle.
Advantages:
* Faster response to developing market changes
* Earlier recognition of possible regime shifts
Trade-offs:
* Higher-timeframe values can change before the candle closes.
* Historical readings after a chart reload may differ from what was visible during the live candle.
* Signals are less stable and should be treated as provisional.
For systematic or confirmation-based use, confirmed higher-timeframe mode is generally the more conservative setting.
---
# Lower-Timeframe Protection
The indicator intentionally blocks requested timeframes that are lower than the current chart timeframe.
Example:
* Current chart: 15 minutes
* Requested timeframe: 5 minutes
The 5-minute row will display:
**LTF blocked**
This is intentional.
A simple higher-timeframe request method does not provide a complete and reliable lower-timeframe evaluation when used from a larger chart timeframe.
To analyze the default 5-minute timeframe, the chart should therefore be set to 5 minutes or lower.
Recommended rule:
**Use a chart timeframe that is equal to or lower than the smallest selected dashboard timeframe.**
---
# Suggested Usage
Bias Matrix Pro X is designed primarily as a context and filtering tool.
## Trend-Following Example
A trader may choose to:
* Look for long setups only during Bullish or Expansion Bull regimes.
* Look for short setups only during Bearish or Expansion Bear regimes.
* Reduce activity during Balanced conditions.
* Require the execution timeframe to move back into alignment with the aggregate bias before entering.
---
## Pullback Example
Possible bullish sequence:
1. Aggregate regime is Bullish or Expansion Bull.
2. Higher timeframes remain bullish.
3. Local timeframe becomes Neutral or temporarily Bearish during a pullback.
4. Local momentum begins turning bullish again.
5. The trader applies a separate entry model.
The indicator does not identify the exact pullback entry. It provides the directional environment in which the trader can evaluate the setup.
---
## Breakout Example
Before taking a bullish breakout, a trader may check whether:
* Aggregate score is positive
* Dominance favors bullish timeframes
* Higher-weight timeframes are bullish
* ADX quality is Good or High
* Alignment is Full or Partial
* The local timeframe is not strongly opposing the breakout
---
## Countertrend Warning
If a trader identifies a long setup while the indicator displays:
* Expansion Bear
* Strong negative aggregate score
* High bearish dominance
* Bearish higher-timeframe alignment
The setup is occurring against the broader technical environment.
This does not automatically make the trade invalid, but it identifies the trade as countertrend and potentially higher risk.
---
# Recommended Starting Configuration
For intraday trading, the default configuration provides a broad hierarchy:
* 5-minute: execution context
* 15-minute: short-term structure
* 1-hour: intraday directional structure
* 4-hour: higher-timeframe trend
* Daily: major market regime
* Weekly: long-term context
Users should adjust the selected timeframes and weights to match their trading horizon.
### Scalping Example
* 1-minute chart
* 3-minute
* 5-minute
* 15-minute
* 30-minute
* 1-hour
* 4-hour
Higher weights can be assigned to the 15-minute, 1-hour, and 4-hour timeframes.
### Swing-Trading Example
* 1-hour or 4-hour chart
* 4-hour
* Daily
* Weekly
* Monthly
Lower requested timeframes should not be used below the active chart timeframe.
---
# Important Settings
## Bias Threshold
Controls how much positive or negative score is required before a timeframe is classified as directional.
Default:
* 18
Higher values:
* Produce fewer bullish and bearish classifications
* Increase the neutral range
* Require stronger alignment
Lower values:
* React faster
* Produce more directional classifications
* May create more frequent regime changes
---
## Strong Bias Threshold
Defines when Bullish or Bearish becomes an Expansion regime.
Default:
* 55
This setting affects the regime name and visual classification.
It does not change the basic bullish or bearish threshold.
---
## Component Weights
Every technical component can be weighted independently.
Increasing a component’s weight gives it more influence over each timeframe score.
Examples:
* Increasing EMA Structure favors slower trend confirmation.
* Increasing Price vs Fast EMA makes the system more reactive to local price changes.
* Increasing EMA Slope gives more importance to trend acceleration.
* Increasing RSI emphasizes momentum regime.
* Increasing MACD emphasizes momentum direction.
* Increasing Supertrend emphasizes volatility-adjusted trend direction.
* Increasing Full Alignment Bonus rewards synchronized conditions more strongly.
Weights should be modified carefully.
Extreme weighting can cause one component to dominate the engine and reduce the value of combining several independent measurements.
---
## Timeframe Weights
Timeframe weights determine influence over the final aggregate score.
They do not affect the internal score of the individual timeframe.
A higher weight means the timeframe has greater influence over:
* Aggregate score
* Aggregate bias
* Bullish, bearish, and neutral weight totals
* Dominance
---
# Practical Interpretation Guidelines
## Strongest Bullish Environment
Look for a combination such as:
* Expansion Bull regime
* Positive score above +55
* High bullish dominance
* Higher-weight timeframes bullish
* Good or High ADX quality
* Full alignment on several timeframes
* Local timeframe turning bullish after a pullback
---
## Strongest Bearish Environment
Look for:
* Expansion Bear regime
* Score below −55
* High bearish dominance
* Higher-weight timeframes bearish
* Good or High ADX quality
* Full bearish alignment
* Local timeframe turning bearish after a corrective rally
---
## Caution Environment
Exercise caution when:
* Aggregate regime is Balanced
* Dominance is low
* Higher and lower timeframes conflict
* Most rows display Mixed alignment
* ADX quality is Low
* The aggregate bias changes frequently
* The selected chart timeframe is too high for the configured lower timeframes
---
# Important Limitations
Bias Matrix Pro X is a technical analysis tool, not a complete trading system.
It does not include:
* Automatic entries
* Stop-loss placement
* Take-profit placement
* Position sizing
* Risk management
* Fundamental analysis
* News-event filtering
* Liquidity analysis
* Market-session filtering
* Volume-profile analysis
* Guaranteed non-lagging signals
The indicator combines several lagging and reactive technical measurements.
Because the engine requires confirmation, regime changes may occur after a market move has already started.
Strong bullish conditions can appear close to a temporary top.
Strong bearish conditions can appear close to a temporary bottom.
A high score describes technical alignment, not guaranteed future direction.
The indicator should therefore be combined with:
* A defined entry model
* Clear invalidation logic
* Position sizing
* Maximum-risk rules
* Session awareness
* Economic-news awareness
* Independent testing
---
# Repainting and Real-Time Behavior
With confirmed higher-timeframe mode enabled:
* Completed higher-timeframe readings remain stable.
* Historical higher-timeframe values are based on completed candles.
* The current chart timeframe continues to update while its active candle is open.
* A local score or aggregate score may still change before the current chart candle closes.
With confirmed higher-timeframe mode disabled:
* Developing higher-timeframe values can change during the active higher-timeframe candle.
* Bias states and chart visuals may update before candle confirmation.
* Historical behavior after reloading the chart may differ from what was observed intrabar.
Users who require stable confirmation should evaluate signals after the chart candle closes and keep confirmed higher-timeframe mode enabled.
---
# Final Notes
Bias Matrix Pro X was created to provide a structured visual answer to three questions:
1. **What is the directional condition of each important timeframe?**
2. **How strong and internally aligned is that condition?**
3. **What is the combined weighted market regime?**
The indicator is intentionally information-rich, but the main reading remains simple:
* Green favors bullish conditions.
* Red favors bearish conditions.
* Amber represents balance or conflict.
* Higher absolute scores represent stronger directional alignment.
* Higher dominance represents broader agreement between the selected timeframes.
* Full alignment represents stronger internal synchronization.
* ADX indicates the quality of the directional environment.
Use the indicator as a market-context framework, not as a standalone promise of future performance.
---
## Disclaimer
This indicator is provided for educational and informational purposes only.
It does not constitute financial advice, investment advice, or a recommendation to buy or sell any financial instrument.
Past performance and historical technical alignment do not guarantee future results.
Trading involves substantial risk, including the possible loss of capital. Every user is responsible for conducting independent research, testing the indicator on the relevant market and timeframe, and applying appropriate risk management.
Open-source script
In true PulseWire spirit, the creator of this script has made it open-source, so that traders can review and verify its functionality. Kudos to the author! While you can use it for free, remember that republishing the code is subject to our House Rules.
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by PulseWire. Read more in the Terms of Use.
Open-source script
In true PulseWire spirit, the creator of this script has made it open-source, so that traders can review and verify its functionality. Kudos to the author! While you can use it for free, remember that republishing the code is subject to our House Rules.
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by PulseWire. Read more in the Terms of Use.