Análise técnica (ta.*)

O namespace ta.* reúne as funções de análise técnica do NeuroScript. Todas operam sobre séries (como close) e retornam o valor calculado no candle atual.

Funções que retornam vários valores (tupla) usam desestruturação, ex.: [macd, sinal, histograma] = ta.macd(close, 12, 26, 9).

Médias e suavização

Função	Retorno	Descrição
`ta.sma(source, length)`	número	Média móvel simples.
`ta.ema(source, length)`	número	Média móvel exponencial (mais peso aos candles recentes).
`ta.wma(source, length)`	número	Média móvel ponderada (pesos lineares decrescentes).
`ta.vwma(source, length)`	número	Média móvel ponderada pelo volume.
`ta.rma(source, length)`	número	Média móvel de Wilder (suavização usada em RSI e ATR).
`ta.swma(source)`	número	Média ponderada simétrica de 4 candles.
`ta.alma(source, length, offset, sigma)`	número	Arnaud Legoux Moving Average — suavização com filtro gaussiano.
`ta.hma(source, length)`	número	Hull Moving Average — média suave com baixo atraso.
`ta.linreg(source, length, offset?)`	número	Valor projetado pela regressão linear (mínimos quadrados).
`ta.vwap(source)`	número	Preço médio ponderado pelo volume, ancorado na sessão.

Osciladores e momentum

Função	Retorno	Descrição
`ta.rsi(source, length)`	número	Índice de Força Relativa (0 a 100).
`ta.macd(source, fast, slow, signal)`	tupla	MACD — convergência/divergência de médias. Retorna [macd, sinal, histograma].
`ta.stoch(source, high, low, length)`	número	Oscilador Estocástico.
`ta.mom(source, length)`	número	Momentum — diferença de preço em relação a N candles atrás.
`ta.cci(source, length)`	número	Commodity Channel Index.
`ta.mfi(series, length)`	número	Money Flow Index — RSI ponderado pelo volume.
`ta.roc(source, length)`	número	Rate of Change — variação percentual em N candles.
`ta.wpr(length)`	número	Williams %R.
`ta.cmo(source, length)`	número	Chande Momentum Oscillator.
`ta.tsi(source, shortLength, longLength)`	número	True Strength Index.
`ta.cog(source, length)`	número	Center of Gravity.
`ta.rci(source, length)`	número	Rank Correlation Index.

Bandas, canais e volatilidade

Função	Retorno	Descrição
`ta.bb(source, length, mult)`	tupla	Bandas de Bollinger. Retorna [média, superior, inferior].
`ta.atr(length)`	número	Average True Range — volatilidade média do período.
`ta.stdev(source, length)`	número	Desvio padrão no período.
`ta.variance(source, length)`	número	Variância no período.
`ta.dmi(diLength, adxSmoothing)`	tupla	Índice Direcional. Retorna [+DI, -DI, ADX].
`ta.tr(handleNa?)`	número	True Range — amplitude real do candle.
`ta.dev(source, length)`	número	Desvio absoluto médio em relação à média.
`ta.supertrend(factor, atrPeriod)`	tupla	SuperTrend. Retorna [linha, direção] (direção < 0 indica alta).
`ta.sar(start, increment, max)`	número	Parabolic SAR — pontos de parada e reversão.
`ta.kc(source, length, mult, useTrueRange?)`	tupla	Canais de Keltner. Retorna [superior, base, inferior].
`ta.donchian(length)`	tupla	Canal de Donchian. Retorna [superior, base, inferior].
`ta.bbw(source, length, mult)`	número	Largura das Bandas de Bollinger.
`ta.kcw(source, length, mult, useTrueRange?)`	número	Largura dos Canais de Keltner.

Cruzamentos e detecção

Função	Retorno	Descrição
`ta.crossover(a, b)`	bool	Verdadeiro quando a primeira série cruza a segunda para cima.
`ta.crossunder(a, b)`	bool	Verdadeiro quando a primeira série cruza a segunda para baixo.
`ta.change(source, length?)`	número	Variação em relação a N candles atrás.
`ta.highest(source, length)`	número	Maior valor da série no período.
`ta.lowest(source, length)`	número	Menor valor da série no período.
`ta.valuewhen(condition, source, occurrence)`	número	Valor da série na N-ésima vez em que a condição foi verdadeira.
`ta.barssince(condition)`	número	Número de candles desde a última vez que a condição foi verdadeira.
`ta.highestbars(source, length)`	número	Quantos candles atrás está o maior valor do período.
`ta.lowestbars(source, length)`	número	Quantos candles atrás está o menor valor do período.
`ta.pivothigh(source, leftBars, rightBars)`	número	Detecta um topo (pivot) com N candles à esquerda e à direita.
`ta.pivotlow(source, leftBars, rightBars)`	número	Detecta um fundo (pivot) com N candles à esquerda e à direita.
`ta.falling(source, length)`	bool	Verdadeiro se a série cai há N candles seguidos.
`ta.rising(source, length)`	bool	Verdadeiro se a série sobe há N candles seguidos.
`ta.cross(a, b)`	bool	Verdadeiro quando há cruzamento em qualquer direção.

Estatística e ranking

Função	Retorno	Descrição
`ta.cum(source)`	número	Soma acumulada da série.
`ta.percentrank(source, length)`	número	Posição percentual do valor atual frente ao período.
`ta.correlation(source1, source2, length)`	número	Correlação entre duas séries no período.
`ta.median(source, length)`	número	Mediana da série no período.
`ta.range(source, length)`	número	Amplitude (máximo menos mínimo) no período.
`ta.max(source)`	número	Maior valor da série desde o início do gráfico.
`ta.min(source)`	número	Menor valor da série desde o início do gráfico.
`ta.mode(source, length)`	número	Moda (valor mais frequente) da série no período.
`ta.percentile_linear_interpolation(source, length, percentage)`	número	Percentil do período por interpolação linear.
`ta.percentile_nearest_rank(source, length, percentage)`	número	Percentil do período pelo método do rank mais próximo.

Volume

Função	Retorno	Descrição
`ta.obv()`	número	On-Balance Volume.
`ta.accdist()`	número	Linha de Acumulação/Distribuição.
`ta.iii()`	número	Intraday Intensity Index.
`ta.nvi()`	número	Negative Volume Index.
`ta.pvi()`	número	Positive Volume Index.
`ta.pvt()`	número	Price Volume Trend.
`ta.wad()`	número	Williams Accumulation/Distribution.
`ta.wvad()`	número	Williams Variable Accumulation/Distribution.

Níveis

Função	Retorno	Descrição
`ta.pivot_point_levels(type, anchor, developing?)`	array	Níveis de pivot (P, R1, S1, R2, S2, ...). Retorna um array.

Exemplos

RSI com níveis

//@version=6
indicator("RSI", overlay=false)

length = input.int(14, "Período", minval=1)
rsi = ta.rsi(close, length)

cor = rsi >= 70 ? color.red : rsi <= 30 ? color.green : color.blue
plot(rsi, "RSI", color=cor, linewidth=2)
hline(70, "Sobrecompra", color=color.red, linestyle=2)
hline(30, "Sobrevenda", color=color.green, linestyle=2)

Bandas de Bollinger (tupla)

//@version=6
indicator("Bollinger", overlay=true)

length = input.int(20, "Período")
mult = input.float(2.0, "Desvios")

[media, superior, inferior] = ta.bb(close, length, mult)
plot(media, "Média", color=color.orange)
plot(superior, "Superior", color=color.blue)
plot(inferior, "Inferior", color=color.blue)

SuperTrend com sinais

//@version=6
indicator("SuperTrend", overlay=true)

fator = input.float(3.0, "Fator", minval=0.5)
periodo = input.int(10, "ATR", minval=1)

[st, direcao] = ta.supertrend(fator, periodo)
alta = direcao < 0
plot(st, "SuperTrend", color=alta ? color.green : color.red, linewidth=3)

compra = (direcao < 0 and direcao[1] > 0) ? low : na
plot(compra, "Compra", color=color.green, style="triangleup", linewidth=5)

Nesta página