Skip to main content

ta.change#

Per-bar change: values[i] - values[i-1].

SYNTAX#

function ta.change(values: (number | null)[], i: number): number | null

ARGUMENTS#

  • values ((number | null)[]) — Series of input values.
  • i (number) — Current bar index. First valid output at i = 1.

RETURNS#

number | null — bar-over-bar delta.

REMARKS#

Use for momentum-style indicators or as input to crossover detection. For percentage change, divide by values[i-1].

EXAMPLE#

const closes = [];
function onBar(i, ctx) {
  closes[i] = candles[i].close;
  const dC = ta.change(closes, i);
  if (dC !== null) plot.histogram('delta', dC, { color: '#26a69a', negativeColor: '#ef5350' });
}

SEE ALSO#

ta.crossover, ta.crossunder