Pine Script v6 é a versão atual da linguagem do TradingView para indicadores e estratégias personalizados; todo script começa com a diretiva //@version=6 seguida de uma declaração indicator(). Em comparação com a v5, ela impõe um sistema de tipos mais rígido, roda mais rápido, trata request.security() com mais segurança e adiciona novas funções nativas, então a maioria dos erros de migração são incompatibilidades de tipo corrigidas com conversões int() ou float().
O que é Pine Script?
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.
A versão 6, lançada em novembro de 2024, é a versão de produção atual. As versões 4 e 5 ainda funcionam, mas não são mais o padrão para novos scripts.
Como escrever 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) // Plota o preço de fechamento como uma linha no gráfico 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 pontos a observar: a diretiva //@version=6 é 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 sobre o gráfico de preços, e não em um painel separado abaixo.
O que mudou da v5 para a v6
1. Sistema de tipos mais rigoroso
A maior mudança de todas. A v6 impõe uma verificação de tipos que a v5 ignorava ou tratava silenciosamente. O caso mais comum: a v5 deixava você passar um series int onde se esperava um simple int e o rebaixava silenciosamente. A v6 gera 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() ou float(), ou usar a função nativa apropriada para converter os tipos explicitamente.
2. Execução mais rápida
A v6 trouxe otimizações do compilador que melhoram de forma significativa a velocidade de execução da maioria dos scripts. As melhorias ficam mais visíveis em scripts com uso intenso de request.security() (análise multi-timeframe), manipulação de arrays ou operações com matrizes. Scripts simples de plot e cor não vão notar uma diferença relevante.
3. Comportamento aprimorado de request.security()
A função para solicitar dados de outro timeframe ganhou um tratamento de argumentos mais limpo e melhor proteção contra a clássica armadilha do "lookahead bias". O erro clássico da v4/v5 — usar lookahead=barmerge.lookahead_on sem entender as consequências — agora gera um aviso mais claro quando o script é publicado.
4. Novas funções nativas
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.
Quais padrões de Pine Script 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 o tempo todo. Domine-os e você conseguirá construir a maior parte do que existe nas suítes comerciais de SMC.
Padrão 1: como detectar swing highs e swing lows?
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) // Plota círculos nos pontos de swing confirmados 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)
Observação: os pivôs são confirmados length barras depois de se formarem. Essa é uma confirmação sem repintura — uma vez exibido, o pivô não se move. A contrapartida é a latência: você só sabe que o pivô existe 5 barras depois (com length=5).
Padrão 2: como desenhar caixas para order blocks e FVGs?
Use a função nativa box.new() para desenhar retângulos. As caixas podem ser atualizadas, estendidas para a direita conforme novas barras se formam, ou excluídas quando invalidadas:
//@version=6 indicator("Bullish FVG Detector", overlay=true, max_boxes_count=500) // FVG de alta: mínima da barra atual > máxima de 2 barras atrás 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 tem padrão 50 — aumente esse valor em 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, vai esgotar o limite rapidamente.
Padrão 3: acompanhando estado entre barras (a palavra-chave var)
O Pine Script executa seu código uma vez por barra, mas muitas vezes você precisa de um estado que persista. A palavra-chave var declara uma variável que é inicializada uma única vez e persiste entre as execuções de cada barra:
//@version=6 indicator("BOS Tracker", overlay=true) // Estado persistente: acompanha a última máxima de swing confirmada var float lastSwingHigh = na // Atualiza quando uma nova máxima de pivô é confirmada ph = ta.pivothigh(high, 5, 5) if not na(ph) lastSwingHigh := ph // Detecta BOS: fechamento acima da última máxima de swing 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 redefinida a cada barra. Com var, o valor persiste. Esse é o padrão fundamental para qualquer indicador que precise 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 esse padrão por baixo dos panos.
Quais armadilhas pegam quem desenvolve em Pine Script pela primeira vez?
lookahead=barmerge.lookahead_on em chamadas de request.security() ou usar construções que olham para o futuro, como ta.pivothigh(), sem considerar o atraso de confirmação da barra. Se os sinais do seu indicador parecem perfeitos nos dados históricos, suspeite primeiro de repintura.
format.mintick nos labels de preço. Uma precisão decimal fixa no código quebra quando o script é aplicado a instrumentos com tamanhos de tick diferentes (BTC vs EURUSD vs ES). Use str.tostring(price, format.mintick) para qualquer preço exibido em labels ou alertas.
max_lines_count, max_boxes_count etc. na declaração indicator() quando precisar de mais.
= para a primeira atribuição e := para reatribuição. x = 5 em dois lugares cria duas variáveis com escopos distintos. x := 5 reatribui uma variável existente. Confunda os dois e você vai passar uma hora depurando valores que não se atualizam.
Blocos de construção do Pine Script v6 em resumo
| Tarefa | Função nativa | O que faz | Atenção a |
|---|---|---|---|
| Máximas e mínimas de swing | ta.pivothigh() / ta.pivotlow() | Confirma pivôs usando uma janela de barras à esquerda/direita | Só confirma 'length' barras após o pivô |
| Zonas de order block e FVG | box.new() | Desenha retângulos que você pode estender ou apagar | Padrão de 50 caixas; aumente max_boxes_count (máx. 500) |
| Estado entre barras | Palavra-chave var | Inicializa uma vez e mantém o valor | Reatribua com :=, não com = |
| Dados de timeframe maior | request.security() | Solicita dados de outro timeframe | lookahead_on pode vazar dados futuros e repintar |
| Rótulos de preço | str.tostring(price, format.mintick) | Formata os preços conforme o tick size do ativo | Casas decimais fixas quebram entre instrumentos |
◆Todo script deve começar com a diretiva //@version=6 na primeira linha não vazia.
Como publicar um script no TradingView?
Quando o seu script estiver funcionando, você pode publicá-lo na Public Library do TradingView — como código aberto (qualquer pessoa pode ler e copiar o código) ou somente por convite (você controla o acesso). As duas opções alcançam a base de usuários do TradingView; publicações de código aberto são revisadas com base nas House Rules e entram na seleção do Editors' Picks se a qualidade for alta.
Três House Rules que mais pegam autores iniciantes: não inclua links promocionais externos nos títulos ou descrições dos scripts, não use técnicas de repintura sem informá-las e não faça referência à sua marca na saída do gráfico (nada de logos, nada de rótulos de marca d'água). As duas primeiras são técnicas; a terceira é focada em fiscalização e derruba publicadores comerciais com frequência.
Perguntas frequentes
Preciso migrar meus scripts v5 para v6?
Scripts v5 existentes continuam rodando no TradingView indefinidamente — não há descontinuação forçada. A migração é recomendada apenas quando você precisa de um recurso específico do v6 (sistema de tipos melhorado, melhor desempenho, novos built-ins) ou quando está começando um script do zero. Para indicadores publicados, o custo da migração raramente vale o benefício a menos que você esteja mantendo ativamente o script.
Qual é a maior mudança disruptiva no Pine Script v6?
O sistema de tipos fortalecido. v6 impõe verificação de tipo mais rigorosa — conversões implícitas que funcionavam silenciosamente em v5 agora gerarão erros. O problema de migração mais comum são incompatibilidades de tipo series-vs-simple em argumentos de função que anteriormente não eram detectados.
Pine Script v6 é mais rápido que v5?
Sim, em média. O compilador da v6 faz uma otimização mais agressiva e tem um runtime de execução mais rápido para a maioria dos padrões comuns. A melhoria é mais perceptível em scripts com manipulação pesada de arrays ou muitas chamadas de request.security.
Posso usar v5 e v6 no mesmo script?
Não. A versão é declarada no topo do script (//@version=6 ou //@version=5) e se aplica ao script inteiro. Você não pode misturar versões dentro de um único indicador ou estratégia.
Onde posso publicar indicadores Pine Script v6?
A Biblioteca Pública do TradingView aceita scripts v5 e v6. Scripts open-source são revisados por moderadores do TradingView conforme as Regras da Casa — as mesmas regras se aplicam independentemente da versão. Scripts closed-source (somente por convite) têm menos sobrecarga de revisão, mas não podem ser promovidos na Biblioteca Pública.
Veja indicadores v6 de produção em ação
O Neural Confluence Engine gratuito do Quantum Algo e todo o pacote Zeno são escritos em Pine Script v6. O script gratuito é open-source — clone-o, estude-o, modifique-o como referência de aprendizado.
Ver no TradingView →