Pine Script v6: Um Guia de Introdução para Desenvolvedores de Indicadores (2026)

O que é Pine Script, resumidamente

Pine Script é a linguagem específica de domínio da TradingView para escrever indicadores técnicos e estratégias customizadas que rodam dentro do motor de gráficos da TradingView. Não é uma linguagem de programação de propósito geral — cada script roda uma vez por barra através do histórico do gráfico, com estado gerenciado implicitamente através da série de barras. Se você nunca usou antes, o modelo mental leva cerca de um dia; as pegadinhas levam cerca de um ano.

Versão 6, lançada em 2025, é a versão de produção atual. Versões 4 e 5 ainda funcionam, mas não são mais o padrão para novos scripts.

Configuração inicial — seu primeiro script v6

Todo Pine Script começa com uma diretiva de versão na linha 1. Para criar um indicador v6:

//@version=6
indicator("My First v6 Indicator", overlay=true)

// Plot the close price as a line on the chart
plot(close, color=color.new(color.aqua, 0), linewidth=2)

Salve isto no Pine Editor do TradingView e adicione ao gráfico. Você verá o preço de fechamento plotado como uma linha ciano. Três coisas a notar: o //@version=6 diretiva é obrigatória e deve ser a primeira linha não vazia; indicator() é a declaração que define se o seu script é um indicador (overlay ou painel) ou uma estratégia (com operações simuladas); e overlay=true significa que o script é desenhado em cima do gráfico de preços em vez de em um painel separado abaixo.

O que mudou da versão v5 para v6

1. Sistema de tipos mais rigoroso

A maior mudança isolada. v6 impõe verificação de tipo que v5 ignorava ou tratava silenciosamente. O caso mais comum: v5 permitia que você passasse um series int onde um simple int era esperado e o rebaixava silenciosamente. v6 lançará um erro em tempo de compilação.

Consequência prática: quando você migra um script v5 e ele de repente não compila, o erro é quase sempre uma incompatibilidade de tipo em um argumento de função. A solução geralmente é envolver o valor em int(), float(), ou use a função built-in apropriada para converter tipos explicitamente.

2. Execução mais rápida

v6 introduziu otimizações de compilador que melhoram materialmente a velocidade de execução para a maioria dos scripts. As melhorias são mais visíveis em scripts com uso intenso de request.security() uso (análise multi-timeframe), manipulação de arrays ou operações com matrizes. Scripts simples de plotagem e cor não verão diferença significativa.

3. Melhorado request.security() comportamento

A função para solicitar dados de um timeframe diferente obteve manipulação de argumentos mais limpa e melhor proteção contra a armadilha histórica de "viés de antecipação". O erro clássico v4/v5 — usar lookahead=barmerge.lookahead_on sem entender as consequências — agora dispara um aviso mais claro quando o script é publicado.

4. Novas funções built-in

Várias funções utilitárias que anteriormente exigiam implementação manual agora estão integradas. Adições notáveis: formatação de string melhorada, melhor fatiamento de matriz e métodos de conveniência no tipo array que reduzem código repetitivo.

Os padrões que importam para indicadores SMC

Se você está escrevendo indicadores de Smart Money Concepts (order blocks, FVGs, detecção de BOS, liquidity sweeps), três padrões de Pine Script aparecem constantemente. Domine esses e você consegue construir a maior parte do que existe em suítes comerciais de SMC.

Padrão 1: detectando topos e fundos de swing

A base de todo indicador de estrutura de mercado. Use ta.pivothigh() e ta.pivotlow() com uma janela de barras esquerda/direita:

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

length = input.int(5, "Pivot Length", minval=1)

ph = ta.pivothigh(high, length, length)
pl = ta.pivotlow(low, length, length)

// Plot circles at confirmed swing points
plotshape(not na(ph), location=location.abovebar,
          style=shape.circle, color=color.red, size=size.tiny)
plotshape(not na(pl), location=location.belowbar,
          style=shape.circle, color=color.green, size=size.tiny)

Nota: pivôs são confirmados length barras após sua formação. Esta é uma confirmação sem repintura — uma vez impressa, o pivô não se move. O trade-off é a latência: você só sabe que o pivô existe 5 barras depois (com length=5).

Padrão 2: desenhando zonas (caixas para order blocks e FVGs)

Use o box.new() integrado para desenhar retângulos. As caixas podem ser atualizadas, estendidas para a direita conforme novas barras são impressas, ou deletadas quando invalidadas:

//@version=6
indicator("Bullish FVG Detector", overlay=true, max_boxes_count=500)

// Bullish FVG: low of current bar > high of bar 2 ago
fvg_top = low
fvg_bot = high[2]
isFVG = fvg_top > fvg_bot

if isFVG
    box.new(left=bar_index[2], top=fvg_top, right=bar_index, bottom=fvg_bot,
            bgcolor=color.new(color.green, 80),
            border_color=color.new(color.green, 50))

Duas coisas pegam desenvolvedores iniciantes aqui. Primeiro, max_boxes_count padrão é 50 — aumente-o para qualquer indicador que desenhe zonas ao longo de históricos longos. Segundo, as caixas são desenhadas em tempo de compilação por barra; se você desenhar uma caixa em cada barra sem lógica condicional, esgotará o limite rapidamente.

Padrão 3: rastreando estado entre barras (o var palavra-chave)

O Pine Script roda seu código uma vez por barra, mas você frequentemente precisa de estado que persiste. O var declara uma variável que é inicializada uma vez e persiste através das execuções de barra:

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

// Persistent state: track the last confirmed swing high
var float lastSwingHigh = na

// Update when a new pivot high is confirmed
ph = ta.pivothigh(high, 5, 5)
if not na(ph)
    lastSwingHigh := ph

// Detect BOS: close above the last swing high
isBOS = not na(lastSwingHigh) and close > lastSwingHigh

if isBOS
    label.new(bar_index, high, "BOS",
              color=color.new(color.green, 0), textcolor=color.white)

Sem var, a variável seria resetada a cada barra. Com var, o valor persiste. Este é o padrão fundamental para qualquer indicador que precisa de memória de eventos passados — todo detector de BOS, detector de MSS, rastreador de mitigação e sistema de envelhecimento de order blocks usa este padrão por trás.

Armadilhas comuns que pegam desenvolvedores iniciantes

Publicando no TradingView

Quando seu script funcionar, você pode publicá-lo na Biblioteca Pública da TradingView — seja como código aberto (qualquer pessoa pode ler e copiar o código) ou apenas por convite (você controla o acesso). Ambas as opções alcançam a base de usuários da TradingView; publicações de código aberto são revisadas de acordo com as Regras da Casa e classificadas no pipeline de Escolhas dos Editores se a qualidade for alta.

Três Regras da Casa que pegam novos autores com mais frequência: não inclua links promocionais externos em títulos ou descrições de scripts, não use técnicas de repintagem sem divulgá-las, e não referencie sua marca dentro da saída do gráfico (sem logos, sem rótulos de marca d'água). As duas primeiras são técnicas; a terceira é focada em aplicação e pega publicadores comerciais regularmente.

Perguntas frequentes