FreeOpen sourcePine Script v6
Keep the familiar MACD line, Signal line and Histogram while organizing Histogram sign and expansion, contraction or equilibrium into five descriptive phases. Add rolling relative magnitude, reactivation after subdued conditions, cross-cycle peak retention and MACD path efficiency in one research pane.
A current-chart momentum research indicator built from raw MACD, its smoothed Signal and their Histogram. Noise-aware magnitude change and an adaptive equilibrium boundary classify Positive Expansion, Positive Contraction, Negative Expansion, Negative Contraction and Near Equilibrium. It does not select trades, forecast price, estimate win rate or manage risk.
MACD and Signal lines, a state-colored Histogram, adaptive equilibrium band, phase-colored zero rail, optional background tint, line-separation fill, event markers, and Compact or Detailed readout. Detailed mode adds acceleration, phase age, cross-cycle age and peak retention, path efficiency and confirmed/live bar state.
Crosses, zero events, phases, magnitude, efficiency and cycle retention are calculated from raw MACD. Display can remain in native units or normalize all three components by one percent of the slow average or ATR without rewriting analytical history. A noise deadband and separate equilibrium entry/exit boundaries reduce small-change and boundary flapping.
Histogram sign combines with noise-filtered absolute-magnitude expansion or contraction. Values inside the adaptive boundary become Near Equilibrium. Colors describe calculation state, not trade direction.
Absolute Histogram receives a 0–100 Percent Rank, Range Rank or default 65/35 Hybrid Rank, then Subdued, Typical and Extended labels. These are not probabilities, confidence or overbought/oversold calls.
Retention compares current absolute Histogram with the largest value since the latest MACD/Signal cross. Efficiency divides net MACD displacement by total travel to describe a direct or rotational path.
Add the public script to a separate pane, then identify the MACD line, Signal line, Histogram, zero guide, yellow dots and readout under the defaults. Change one analytical or display input at a time.
Open the public MACD Momentum Phase & Acceleration Observatory page and add it to a TradingView chart. No SG Group account is required.
Overlapping lines, bands, backgrounds or tables can be duplicate drawings of the same kind of information. Never treat visual overlap by itself as stronger evidence or signal agreement. A standard MACD, derivative MACD, Histogram, crossover arrows, zero guide, background or fixed panel can duplicate this study’s lines, five-color Histogram, glow layers, separation fill, equilibrium band, yellow dots and readout. Glow and depth layers repeat the same values for styling and are not independent evidence.
Go beyond a line cross. Read zero location, the five-state phase, relative magnitude, duration and cross-cycle retention in sequence.
Use Location for raw MACD above or below zero, then Phase for sign plus expansion, contraction or equilibrium. Do not turn green or magenta into an entry direction.
Magnitude is relative to rolling history. A yellow dot only records that magnitude re-emerged after a sustained Subdued sequence; determine sign and phase separately.
Read acceleration, phase age, cross-cycle retention and path efficiency as related views of the same MACD series. Do not add them as independent confirmations.
Histogram is above zero while absolute magnitude expands / contracts beyond the noise logic.
Histogram is below zero while absolute magnitude expands / contracts beyond the noise logic.
Absolute raw Histogram is inside the adaptive equilibrium boundary; this is not a price-equilibrium claim.
Low, ordinary or high relative Histogram magnitude inside the rolling history; not probability or overbought/oversold.
Relative magnitude reached the reactivation threshold after a sustained Subdued sequence; non-directional by itself.
Bars since the latest MACD/Signal cross / current absolute Histogram as a percentage of that cycle’s peak.
MACD net displacement versus total travel / whether the bar is closed or still forming; not profitability or reliability.
The labels below match the published script’s English Inputs panel. Defaults reflect the public source at the time of review and may change in a later TradingView update.
On small screens, each input is reformatted as a readable stacked card.
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Source | Close | Selects the price series used by the fast and slow moving averages. |
Fast Length | 12 (1–1000) | Sets the fast moving-average length. It must remain lower than Slow Length. |
Fast Average Type | EMA / SMA / RMA / WMA / HMA (default: EMA) | Chooses EMA, SMA, RMA, WMA or HMA for the fast average. |
Slow Length | 26 (2–2000) | Sets the slow moving-average length. It must remain higher than Fast Length. |
Slow Average Type | EMA / SMA / RMA / WMA / HMA (default: EMA) | Chooses EMA, SMA, RMA, WMA or HMA for the slow average. |
Signal Length | 9 (1–1000) | Sets the smoothing length used to produce the Signal line from raw MACD. |
Signal Average Type | EMA / SMA / RMA / WMA / HMA (default: EMA) | Chooses EMA, SMA, RMA, WMA or HMA for the Signal line. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Display Mode | Raw MACD / Percent of Slow Average / ATR Units (default: Raw MACD) | Chooses native MACD units, percent of the slow average, or ATR units. Analytical events continue to use the raw series. |
ATR Length for ATR Units | 14 (1–1000; active for ATR Units) | Sets the ATR length used only when Display Mode is ATR Units. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Histogram Acceleration Smoothing | 3 (1–100) | Smooths one-bar Histogram change. Display acceleration follows the selected unit while phase classification uses raw MACD structure. |
Phase Noise Length | 8 (2–500) | Estimates ordinary one-bar movement in absolute Histogram magnitude for the adaptive phase deadband. |
Phase Noise Multiplier | 0.25 (0–5; step 0.05) | Scales the phase deadband. Higher values require a clearer magnitude change before motion state can switch. |
Adaptive Equilibrium Length | 34 (2–2000) | Sets the lookback used to estimate recent mean absolute Histogram magnitude. |
Equilibrium Band Multiplier | 0.28 (0–5; step 0.01) | Scales the adaptive entry boundary for Near Equilibrium. |
Equilibrium Exit Hysteresis | 1.25 (1–5; step 0.05) | Widens the exit boundary after Near Equilibrium begins, reducing rapid boundary flapping. |
Magnitude Rank Lookback | 120 (10–5000) | Sets the rolling history for the 0–100 relative Histogram magnitude score. |
Magnitude Score Method | Hybrid Rank / Percent Rank / Range Rank (default: Hybrid Rank) | Chooses observation Percent Rank, rolling Range Rank, or the default 65/35 Hybrid Rank. |
Subdued Magnitude Threshold | 20 (0–99; step 1) | Sets the upper score boundary for the descriptive Subdued state. |
Magnitude Reactivation Threshold | 35 (1–100; step 1) | Sets the score that records reactivation after a sustained Subdued sequence. |
Extended Magnitude Threshold | 80 (1–100; step 1) | Sets the lower score boundary for the descriptive Extended state. |
Minimum Subdued Bars | 3 (1–100) | Sets how many consecutive Subdued bars are required before reactivation can be armed. |
MACD Path Efficiency Length | 20 (2–1000) | Sets the lookback for net MACD displacement divided by total MACD travel, expressed from 0 to 100. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Show Histogram | On | Shows or hides the state-colored MACD Histogram. |
Show Histogram Depth Layer | On | Adds the wider translucent Histogram depth layer; it is not a second analytical series. |
Fade Lower-Magnitude Histogram Bars | On | Fades Histogram bars with lower relative-magnitude scores. |
Show MACD Line | On | Shows or hides the MACD line. |
Show Signal Line | On | Shows or hides the Signal line. |
Show Line Glow | On | Adds translucent glow beneath the visible MACD and Signal lines. |
Fill Between MACD and Signal | On | Fills the separation between MACD and Signal for visual context. |
Show Adaptive Equilibrium Band | On | Shows the adaptive upper/lower Near Equilibrium boundary and its fill. |
Show Momentum Phase Rail at Zero | On | Colors a thick rail at zero by the current five-state momentum phase. |
Show Phase Background Tint | Off | Adds an optional pane-background tint for the current phase. |
Background Transparency | 94 (75–100; active with phase background) | Sets phase-background transparency; higher values are more transparent. |
Line Fill Transparency | 88 (50–100; active with line fill) | Sets transparency for the fill between MACD and Signal. |
Histogram Depth Transparency | 78 (0–100; active with depth layer) | Sets transparency for the wider Histogram depth layer. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Signal-Line Cross Markers | On | Shows factual MACD/Signal cross arrows at the pane edges. |
Acceleration Turn Markers | Off | Shows optional diamonds where raw Histogram acceleration crosses zero. |
MACD Zero-Cross Markers | Off | Shows optional circles when raw MACD crosses zero. |
Magnitude Reactivation Markers | On | Shows a yellow pane-top dot when relative Histogram magnitude reactivates after a sustained Subdued sequence. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Readout Mode | Off / Compact / Detailed (default: Compact) | Chooses Off, Compact or Detailed context readout. |
Readout Position | Top Left / Top Center / Top Right / Middle Left / Middle Right / Bottom Left / Bottom Center / Bottom Right (default: Top Right) | Chooses the readout position. Move it when another indicator occupies the same area. |
Readout Text Size | Tiny / Small / Normal / Large / Huge (default: Normal) | Sets the body-text size in the context readout. |
Header Text Size | Tiny / Small / Normal / Large / Huge (default: Normal) | Sets the context-readout header size. |
Readout Background | RGB 16, 20, 30 | Sets the readout body background color. |
Readout Header Background | RGB 35, 42, 58 | Sets the readout header background color. |
Readout Border | RGB 75, 88, 112 | Sets the readout frame and border color. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
MACD Line | Ice white (RGB 245, 247, 250) | Sets the MACD-line color. |
Signal Line | Electric blue (RGB 41, 121, 255) | Sets the Signal-line color. |
Positive Expansion | Bright green (RGB 0, 230, 118) | Sets the color for positive Histogram magnitude expansion. |
Positive Contraction | Teal (RGB 0, 191, 165) | Sets the color for positive Histogram magnitude contraction. |
Negative Expansion | Magenta (RGB 255, 45, 122) | Sets the color for negative Histogram magnitude expansion. |
Negative Contraction | Orange (RGB 255, 145, 0) | Sets the color for negative Histogram magnitude contraction. |
Equilibrium | Vivid purple (RGB 213, 0, 249) | Sets the color for the adaptive Near Equilibrium phase. |
Zero Guide | Blue grey (RGB 120, 144, 156) | Sets the zero-guide color. |
Magnitude Reactivation Marker | Yellow (RGB 255, 234, 0) | Sets the non-directional Magnitude Reactivation marker color. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Confirmed Bars Only | On | Restricts markers, alerts and committed state updates to confirmed bars; live plots and readout can still change on the open bar. |
Enable Signal-Line Cross Alerts | On | Enables alerts for MACD crossing above or below Signal. |
Enable MACD Zero-Cross Alerts | Off | Enables alerts for MACD crossing above or below zero. |
Enable Acceleration Turn Alerts | On | Enables alerts when raw Histogram acceleration crosses zero. |
Enable Magnitude Reactivation Alert | On | Enables the non-directional Magnitude Reactivation alert. |
Enable Momentum Phase Alerts | Off | Enables alerts for transitions into each of the five momentum phases. |
Alerts report MACD/Signal crosses, MACD zero crosses, Histogram-acceleration turns, Magnitude Reactivation and five-state phase transitions. They are not trade instructions or forecasts.
This tool is for analysis and visualization. It is not investment advice, a trade recommendation, a forecast, or a promise of profit or accuracy. Results depend on inputs, symbol, timeframe, and data feed. You remain responsible for every trading decision.
MACD is derived from moving averages. Phase, magnitude, acceleration, retention and efficiency describe current and historical calculations; they do not forecast price.
Rolling rank changes as old observations leave its window. Noise, equilibrium, reactivation and Extended classifications depend on the selected lengths and thresholds.
Confirmed Bars Only gates markers, alerts and committed state updates. Lines, Histogram, phase and readout can still change with live price before the bar closes.
The script does not request another symbol or timeframe, use lookahead, access future data or apply a future offset. Short timeframes, gaps and illiquid markets can create rapid state changes.
MACD, Signal, Histogram, phase, magnitude, reactivation, acceleration, retention and efficiency are related outputs from the same MACD series. Do not count them as independent trade signals or convert them into an entry, exit, target, stop, size or win-rate estimate.
Clarify the difference from standard MACD, display units, the yellow dot and confirmed versus live behavior.
Yes. It is a free, open-source indicator published by SG Group on TradingView. Review TradingView’s terms and the conditions attached to the public script before reuse or redistribution.
Start with the published defaults and observe the drawings and state changes first. Then change one input at a time for the symbol, timeframe and data feed so you can identify what caused each visual change.
Yes, but similar lines, bands, backgrounds and tables can overlap and obscure their source. Isolate each indicator first and hide duplicate components. Visual overlap alone is not stronger evidence or signal agreement.
No. It is analysis and visualization context consistent with the public description. It does not provide entries, exits, targets, stops, price forecasts, or promises of profit, win rate or accuracy.
No. It only records that relative absolute-Histogram magnitude re-emerged after a sustained Subdued sequence. Read direction separately from Histogram sign and phase; it is not an entry or price forecast.
This guide is grounded in SG Group’s live catalogue, the script’s published TradingView description, and the user-facing inputs in its open source. Labels and defaults can change after a script update.
