Guia Rápido

Crie seu primeiro indicador técnico personalizado em menos de 5 minutos.

O que é um Script NeuroScript®?

Um script NeuroScript® é um programa que calcula e visualiza indicadores técnicos diretamente no gráfico de trading. Ele processa cada barra (vela) do gráfico sequencialmente, executando seus cálculos e gerando saídas visuais.

Características principais:

• Sintaxe familiar inspirada no Pine Script v6
• Execução bar-by-bar (vela por vela)
• 79 funções built-in + namespace de arrays em beta
• Integração nativa com o chart do Futura Broker via NeuroScriptExecutor

Estrutura Básica de um Script

Todo script NeuroScript® segue esta estrutura de 5 partes:

// 1. Declaração do indicador (obrigatório)
indicator("Nome do Indicador", overlay=true)

// 2. Parâmetros de entrada (opcional)
length = input.int(14, "Período", minval=1, maxval=200)

// 3. Cálculos e lógica
value = ta.sma(close, length)

// 4. Visualização (plot)
plot(value, "SMA", color=color.blue, linewidth=2)

// 5. Retorno do valor (opcional)
return value

Explicação linha por linha:

1. indicator(...) - Define propriedades do indicador

   • overlay=true: desenha sobre o gráfico de preços
   • overlay=false: cria painel separado (como RSI)

2. input.int(...) - Cria parâmetro configurável pelo usuário

   • Permite ajustar período sem editar código

3. ta.sma(...) - Calcula média móvel simples

   • close: preço de fechamento da vela
   • length: número de períodos

4. plot(...) - Desenha linha no gráfico

   • Define cor, espessura e nome

5. return - Retorna valor para uso futuro (opcional)

Seu Primeiro Indicador: SMA 20

Vamos criar uma média móvel simples de 20 períodos:

// Média Móvel Simples
indicator("SMA 20", overlay=true)

// Calcular SMA de 20 períodos
sma20 = ta.sma(close, 20)

// Desenhar linha azul
plot(sma20, "SMA", color=color.blue, linewidth=2)

return sma20

O que este script faz:

• Lê o preço de fechamento (close) de cada vela
• Calcula a média dos últimos 20 preços
• Desenha uma linha azul no gráfico

Segundo Exemplo: RSI com Níveis

Agora vamos criar um indicador mais avançado com múltiplas saídas visuais:

// RSI com níveis de sobrecompra/sobrevenda
indicator("RSI Levels", overlay=false)

// Parâmetros configuráveis
length = input.int(14, "Período RSI", minval=1, maxval=50)
overbought = input.int(70, "Sobrecompra", minval=50, maxval=100)
oversold = input.int(30, "Sobrevenda", minval=0, maxval=50)

// Calcular RSI
rsi = ta.rsi(close, length)

// Plotar linha do RSI
plot(rsi, "RSI", color=color.purple, linewidth=2)

// Linhas de referência
hline(overbought, "Overbought", color=color.red)
hline(50, "Meio", color=color.gray)
hline(oversold, "Oversold", color=color.green)

return rsi

Novidades neste exemplo:

• overlay=false - Cria painel separado abaixo do gráfico
• ta.rsi(...) - Calcula Relative Strength Index
• hline(...) - Desenha linhas horizontais de referência
• Múltiplos inputs - Usuário pode configurar 3 parâmetros

Terceiro Exemplo: SMA com Cor Dinâmica

Vamos adicionar lógica condicional para mudar a cor:

// SMA com cor baseada em tendência
indicator("Smart SMA", overlay=true)

length = input.int(20, "Período", minval=1, maxval=200)

// Calcular SMA
sma = ta.sma(close, length)

// Determinar tendência
uptrend = close > sma
trendColor = uptrend ? color.green : color.red

// Plot com cor dinâmica
plot(sma, "SMA", color=trendColor, linewidth=2)

return sma

Conceitos novos:

• Operador ternário ? : - "Se preço > SMA, verde, senão vermelho"
• Variável booleana - uptrend é true ou false
• Cor condicional - Linha muda de cor conforme tendência

Executar no Futura Broker

Para testar seus scripts na plataforma:

1. Acesse o Trade Room

   • URL: http://localhost:5000/traderoom (desenvolvimento)
   • Ou acesse a plataforma em produção

2. Abra o Editor NeuroScript

   • Clique no ícone "Indicadores" no rodapé do gráfico
   • Selecione "NeuroScript" no menu

3. Cole e Execute

   • Cole o código no editor
   • Clique em "Executar Script" ou pressione Ctrl+Enter
   • O indicador aparecerá instantaneamente no gráfico

4. Ajuste Parâmetros

   • Use os inputs para experimentar valores diferentes
   • Veja mudanças em tempo real

Variáveis Built-in Disponíveis

Estas variáveis estão sempre disponíveis em qualquer script:

Funções TA Mais Usadas

Médias Móveis

• ta.sma(source, length) - Média Móvel Simples
• ta.ema(source, length) - Média Móvel Exponencial
• ta.wma(source, length) - Média Móvel Ponderada
• ta.rma(source, length) - Média Móvel de Wilder (RMA)

Osciladores

• ta.rsi(source, length) - Relative Strength Index
• ta.macd(source, fast, slow, signal) - MACD
• ta.stoch(length, smoothK, smoothD) - Estocástico
• ta.cci(source, length) - Commodity Channel Index

Volatilidade

• ta.atr(length) - Average True Range
• ta.stdev(source, length) - Desvio Padrão
• ta.bb(source, length, mult) - Bollinger Bands

Auxiliares

• ta.highest(source, length) - Maior valor em N períodos
• ta.lowest(source, length) - Menor valor em N períodos
• ta.crossover(a, b) - True quando A cruza acima de B
• ta.crossunder(a, b) - True quando A cruza abaixo de B

Cores Disponíveis

// Cores básicas
color.aqua    color.black   color.blue    color.fuchsia
color.gray    color.green   color.lime    color.maroon
color.navy    color.olive   color.orange  color.purple
color.red     color.silver  color.teal    color.white
color.yellow

Limitações Atuais

O NeuroScript® v0.2.2 é um MVP funcional e apresenta algumas restrições conhecidas:

Ainda em andamento

• Security Layer (sandbox isolado em Web Worker)
• strategy() e recursos de backtesting
• plotshape() e objetos gráficos adicionais
• Multi-timeframe / multi-symbol data access
• Inputs avançados (listas, múltiplas fontes)

Disponível no beta atual

• 79 funções estáveis (math, ta, plot, input, tempo, cores)
• Arrays numéricos (array.*) em beta controlado
• Operadores aritméticos/lógicos e condicionais (if, ternário)
• Variáveis persistentes (var) e contexto stateful
• plot(), fill(), hline() com primitives de alto desempenho
• Inputs configuráveis (input.int, input.float, input.bool, input.string, input.color)

Agora que você criou seus primeiros indicadores:

1. Explore Exemplos - 15 scripts prontos para aprender padrões
2. Standard Library - Referência completa das APIs suportadas
3. Guia de Linguagem - Sintaxe detalhada e modelo de execução
4. Guias Avançados - Quando priorizar performance, persistência e boas práticas

Dicas para Começar

Comece simples:

• Modifique os exemplos existentes antes de criar do zero
• Teste uma função por vez
• Use plot() para debugar valores intermediários

Boas práticas:

• Sempre use indicator() no início
• Nomeie variáveis de forma descritiva
• Adicione comentários para lógica complexa
• Defina minval/maxval nos inputs

Performance:

• Evite cálculos redundantes
• Reutilize variáveis calculadas
• O runtime executa ~5ms por barra (muito rápido!)

---

Bem-vindo ao NeuroScript®! Você agora tem as ferramentas para criar indicadores técnicos personalizados ilimitados. Experimente, aprenda e compartilhe suas criações com a comunidade Futura Broker.