How Does the MACD Indicator Work? Pine Script v6 Deep Dive into Crossovers and Momentum Signals

The Moving Average Convergence Divergence (MACD) indicator is one of the most widely studied momentum oscillators in technical analysis, built entirely on the mathematical relationship between two exponential moving averages and their difference. This article dissects the MACD formula from first principles, explains every component with verified Pine Script v6 code, and demonstrates how to implement a fully functional MACD system without relying on the black-box ta.macd() built-in — so you understand exactly what is happening at every bar.

1. The Mathematics Behind MACD

MACD is defined by three computed series, each derived from price:

$$\text{MACD Line} = \text{EMA}_{\text{fast}}(\text{close}) - \text{EMA}_{\text{slow}}(\text{close})$$ $$\text{Signal Line} = \text{EMA}_{\text{signal}}(\text{MACD Line})$$ $$\text{Histogram} = \text{MACD Line} - \text{Signal Line}$$

The standard parameterization uses a 12-period fast EMA, a 26-period slow EMA, and a 9-period signal EMA. These are simple integer constants, which is critical in Pine Script v6 because ta.ema() requires a simple int length — not a series int.

EMA Recursion Formula

Each EMA is computed using the standard recursive formula:

$$\text{EMA}_t = \alpha \cdot P_t + (1 - \alpha) \cdot \text{EMA}_{t-1}$$

where the smoothing factor is:

$$\alpha = \frac{2}{N + 1}$$

For the fast EMA ($N=12$): $\alpha = 2/13 \approx 0.1538$. For the slow EMA ($N=26$): $\alpha = 2/27 \approx 0.0741$. For the signal EMA ($N=9$): $\alpha = 2/10 = 0.2$.

2. MACD Component Breakdown

Component	Formula	Default Period	Interpretation
Fast EMA	$\text{EMA}_{12}(\text{close})$	12	Reacts quickly to recent price changes
Slow EMA	$\text{EMA}_{26}(\text{close})$	26	Represents longer-term trend baseline
MACD Line	$\text{EMA}_{12} - \text{EMA}_{26}$	—	Measures momentum: positive = bullish, negative = bearish
Signal Line	$\text{EMA}_{9}(\text{MACD Line})$	9	Smoothed MACD; crossovers generate signals
Histogram	$\text{MACD} - \text{Signal}$	—	Visualizes the gap between MACD and Signal; zero-cross = crossover event

3. Crossover Signal Logic

A bullish crossover occurs when the MACD Line crosses above the Signal Line — mathematically, when the Histogram transitions from negative to positive. A bearish crossover occurs when the MACD Line crosses below the Signal Line — when the Histogram transitions from positive to negative.

graph TD A[Close Price Series] --> B[EMA Fast - Period 12] A --> C[EMA Slow - Period 26] B --> D[MACD Line = EMA12 minus EMA26] C --> D D --> E[Signal Line = EMA9 of MACD Line] D --> F[Histogram = MACD Line minus Signal Line] E --> F F --> G{Histogram Sign Change?} G -->|Negative to Positive| H[Bullish Crossover Signal] G -->|Positive to Negative| I[Bearish Crossover Signal] D --> J{MACD Line crosses Zero?} J -->|Crosses Above Zero| K[Fast EMA overtook Slow EMA - Bullish Trend Confirmation] J -->|Crosses Below Zero| L[Fast EMA fell below Slow EMA - Bearish Trend Confirmation]

The zero-line of the MACD Line itself also carries meaning: when the MACD Line crosses above zero, the fast EMA has overtaken the slow EMA, indicating that short-term momentum has turned bullish relative to the longer-term trend.

4. Pine Script v6 Implementation — Manual MACD from Scratch

The following implementation builds MACD manually using ta.ema() with const int lengths (satisfying the simple int requirement), then detects crossovers using ta.crossover() and ta.crossunder(). All parameters are exposed via input.int() and input.source().

🔽 [Click to expand] View Full Pine Script Code

//@version=6
indicator(
     title        = "MACD — Manual Implementation (v6)",
     shorttitle   = "MACD v6",
     overlay      = false
 )

// ─────────────────────────────────────────────
// INPUTS
// ─────────────────────────────────────────────
// input.source() returns series float — do NOT declare as input float
float src         = input.source(close,  "Source")

// input.int() returns input int, which satisfies simple int
// ta.ema() requires simple int for its length parameter
int fastLen       = input.int(12,  "Fast EMA Length",   minval = 1)
int slowLen       = input.int(26,  "Slow EMA Length",   minval = 1)
int signalLen     = input.int(9,   "Signal EMA Length", minval = 1)

// ─────────────────────────────────────────────
// CORE CALCULATIONS
// All ta.ema() calls are at GLOBAL SCOPE — mandatory for
// history-dependent functions to accumulate their internal buffers
// correctly on every bar.
// ─────────────────────────────────────────────

// Fast and slow EMAs of the source price
float emaFast     = ta.ema(src, fastLen)
float emaSlow     = ta.ema(src, slowLen)

// MACD Line: difference between fast and slow EMA
// Positive → fast EMA above slow EMA → bullish momentum
// Negative → fast EMA below slow EMA → bearish momentum
float macdLine    = emaFast - emaSlow

// Signal Line: EMA of the MACD Line itself
// ta.ema() requires simple int — signalLen is input int ≤ simple ✓
float signalLine  = ta.ema(macdLine, signalLen)

// Histogram: gap between MACD Line and Signal Line
// Zero-cross of histogram = crossover event
float histogram   = macdLine - signalLine

// ─────────────────────────────────────────────
// CROSSOVER DETECTION
// ta.crossover(a, b)  → true when a crosses above b (prev a <= b, curr a > b)
// ta.crossunder(a, b) → true when a crosses below b (prev a >= b, curr a < b)
// ─────────────────────────────────────────────
bool bullishCross = ta.crossover(macdLine,  signalLine)  // MACD crosses above Signal
bool bearishCross = ta.crossunder(macdLine, signalLine)  // MACD crosses below Signal
bool zeroLineBull = ta.crossover(macdLine,  0.0)         // MACD crosses above zero
bool zeroLineBear = ta.crossunder(macdLine, 0.0)         // MACD crosses below zero

// ─────────────────────────────────────────────
// HISTOGRAM COLOR LOGIC
// Color encodes both direction and momentum change:
//   Rising positive  → bright green  (momentum accelerating bullish)
//   Falling positive → dim green     (momentum decelerating bullish)
//   Falling negative → bright red    (momentum accelerating bearish)
//   Rising negative  → dim red       (momentum decelerating bearish)
// ─────────────────────────────────────────────
color histColor =
     histogram >= 0
     ? (histogram >= histogram[1] ? color.new(color.green, 0) : color.new(color.green, 50))
     : (histogram <= histogram[1] ? color.new(color.red,   0) : color.new(color.red,   50))

// ─────────────────────────────────────────────
// PLOTS
// ─────────────────────────────────────────────

// Histogram as columns — the most visually informative MACD element
plot(
     histogram,
     title  = "Histogram",
     style  = plot.style_columns,
     color  = histColor
 )

// MACD Line
plot(
     macdLine,
     title     = "MACD Line",
     color     = color.new(color.blue, 0),
     linewidth = 2
 )

// Signal Line
plot(
     signalLine,
     title     = "Signal Line",
     color     = color.new(color.orange, 0),
     linewidth = 1
 )

// Zero reference line
hline(0, "Zero Line", color = color.new(color.gray, 50), linestyle = hline.style_dashed)

// ─────────────────────────────────────────────
// CROSSOVER MARKERS
// plotshape() draws symbols directly on the MACD pane
// ─────────────────────────────────────────────
plotshape(
     bullishCross,
     title    = "Bullish Cross",
     style    = shape.triangleup,
     location = location.bottom,
     color    = color.new(color.green, 0),
     size     = size.small
 )

plotshape(
     bearishCross,
     title    = "Bearish Cross",
     style    = shape.triangledown,
     location = location.top,
     color    = color.new(color.red, 0),
     size     = size.small
 )

// ─────────────────────────────────────────────
// ALERTS
// ─────────────────────────────────────────────
alertcondition(bullishCross, "MACD Bullish Crossover", "MACD Line crossed above Signal Line")
alertcondition(bearishCross, "MACD Bearish Crossover", "MACD Line crossed below Signal Line")
alertcondition(zeroLineBull, "MACD Zero-Line Bullish", "MACD Line crossed above zero")
alertcondition(zeroLineBear, "MACD Zero-Line Bearish", "MACD Line crossed below zero")

5. Why `ta.ema()` Requires `simple int` — A Critical v6 Constraint

In Pine Script v6, ta.ema() requires its length parameter to be of type simple int. This means the length must be known at script initialization and cannot change bar-by-bar. The type qualifier hierarchy from weakest to strongest is:

$$\text{const} \rightarrow \text{input} \rightarrow \text{simple} \rightarrow \text{series}$$

An input int (returned by input.int()) satisfies a simple int parameter because input is narrower than simple in the widening direction. A series int — for example, the result of int(math.round(ta.atr(14))) — would cause a compile error when passed to ta.ema().

Length Source	Qualifier	ta.ema() Compatible?	ta.sma() Compatible?
`int len = 12`	const int	✅ Yes	✅ Yes
`input.int(12)`	input int	✅ Yes	✅ Yes
`int(math.round(ta.atr(14)))`	series int	❌ Compile Error	✅ Yes

6. Signal Interpretation: What Each MACD Event Means Mathematically

6.1 MACD Line Crossover (Signal Line Cross)

When macdLine crosses above signalLine, the histogram transitions from negative to positive. This means the rate of change of the fast EMA relative to the slow EMA has accelerated enough to exceed its own 9-period smoothed average — a momentum acceleration event, not merely a directional change.

6.2 Zero-Line Cross

When the MACD Line crosses zero, the fast EMA ($\text{EMA}_{12}$) has crossed the slow EMA ($\text{EMA}_{26}$). This is a trend confirmation event: the short-term average has overtaken the long-term average. Zero-line crosses lag signal-line crosses because the signal line is itself a smoothed version of the MACD Line.

6.3 Histogram Divergence

When price makes a new high but the histogram makes a lower high, the momentum behind the price move is weakening. This is a bearish divergence. Mathematically:

$$\text{price}[t] > \text{price}[t-k] \quad \text{but} \quad \text{histogram}[t] < \text{histogram}[t-k]$$

The converse defines bullish divergence. Note that divergence detection requires human or algorithmic identification of swing highs/lows and is not encoded in the script above.

7. EMA Execution Model — Why Global Scope Is Mandatory

In Pine Script v6, ta.ema() maintains an internal recursive state buffer. This buffer only accumulates on bars where the function is actually executed. If ta.ema() is placed inside a conditional block (e.g., if barstate.isconfirmed), it will only execute on some bars, causing its internal history to be incomplete and its output to be incorrect or na.

This is why all three ta.ema() calls in the implementation above — emaFast, emaSlow, and signalLine — are declared at the top level of the script, outside any conditional block. This guarantees execution on every bar and correct recursive accumulation.

8. Comparing Built-in vs. Manual MACD

Pine Script v6 provides ta.macd() as a built-in that returns a tuple of [macdLine, signalLine, histogram]. The manual implementation above is mathematically equivalent. The advantage of the manual approach is full transparency: you can substitute any smoothing function (e.g., ta.rma() or ta.sma()) for the EMA steps, or apply the MACD logic to a custom source series such as volume-weighted price.

Approach	Transparency	Customizability	Code Length
`ta.macd()` built-in	Black box	Fixed EMA only	1 line
Manual (this article)	Full formula visibility	Any smoothing function	~10 lines

9. Conclusion

MACD is a pure EMA-difference system: The MACD Line is $\text{EMA}_{12} - \text{EMA}_{26}$; the Signal Line is $\text{EMA}_9$ of that difference; the Histogram is their gap. All three components are deterministic and reproducible from the recursive EMA formula $\text{EMA}_t = \alpha P_t + (1-\alpha)\text{EMA}_{t-1}$.
Pine Script v6 type constraints are non-negotiable: ta.ema() requires simple int for its length parameter. Using input.int() satisfies this constraint. Using a series int (e.g., a dynamically computed length) causes a compile error. All stateful ta.* functions must execute at global scope on every bar to maintain correct internal history.
Crossover signals are histogram zero-crosses: A bullish signal-line crossover is mathematically identical to the histogram transitioning from negative to positive. Zero-line crosses of the MACD Line itself confirm that the fast EMA has overtaken the slow EMA — a lagging but higher-confidence trend signal.

Ideas for Script Advancement

Multi-Timeframe MACD Confluence: Use request.security() with close[1] and barmerge.lookahead_on to fetch the confirmed MACD histogram from a higher timeframe (e.g., daily) and overlay it as a background color on an intraday chart, creating a non-repainting HTF bias filter.
Adaptive MACD with Dynamic SMA Lengths: Replace the fast and slow EMA with ta.sma() (which accepts series int lengths) and drive the lengths from a volatility measure such as a normalized ATR, creating an adaptive MACD that widens its lookback during high-volatility regimes and tightens it during low-volatility periods.

Search This Blog

The Wealth Lab