AlertaScript: Escrevendo Seus Próprios Indicadores e Estratégias
9 min read
O AlertaScript é a linguagem de indicadores customizados do AlertaChart. Ela permite que você escreva seus próprios indicadores técnicos, overlays customizados e estratégias completas backtestáveis — tudo renderizado contra o mesmo gráfico ao vivo que você usa todos os dias.
O que você pode construir
- Overlays customizados: linhas, canais, bandas desenhadas sobre o painel de preço. - Sub-painéis customizados: osciladores, plots de razão, qualquer coisa que viva abaixo do gráfico. - Alertas a partir da saída do indicador: dispare um alerta do AlertaChart quando a condição do seu script se tornar verdadeira. - Backtests e relatórios de estratégia: um modo de estratégia produz win rate, profit factor, drawdown e gráficos de curva de equity via o painel Strategy Tester.
Você (ainda) não pode colocar ordens reais a partir do AlertaScript. O modo de estratégia é para análise e relatórios — trading ao vivo está no roadmap, mas não está sendo entregue hoje.
O editor
Abra o AlertaScript pela navegação superior. O editor é dividido em três colunas: árvore de arquivos à esquerda (seus scripts salvos), código no meio e um gráfico de preview ao vivo à direita. Save armazena o script na sua biblioteca (Pro), Run o executa contra o gráfico visível e renderiza o resultado, e Apply vincula o script como um indicador do gráfico para que ele viaje com você através de trocas de símbolo.
O que a linguagem suporta
- Séries embutidas: open, high, low, close, volume, time. - Matemática: math.abs, math.max, math.min, math.round, math.log, mais tudo do Math do JavaScript acessível pelo prefixo alerta. - Plotagem: plot, plotshape, plotcandle, bgcolor, hline. - Condicionais + estado: if/else, var para estado persistente, ta.crossover, ta.crossunder, ta.highest, ta.lowest, mais a maioria das funções de biblioteca TA. - Estratégias: strategy.entry, strategy.exit, strategy.close_all com um painel Strategy Tester que produz métricas.
O namespace alerta. adiciona built-ins específicos do AlertaChart: alerta.session, alerta.market_type, alerta.is_futures, alerta.funding_rate (apenas futures), alerta.open_interest (apenas futures).
Compartilhando scripts
O botão Share gera uma URL que carrega seu script no editor de outro usuário quando ele clica. Útil para templates da comunidade. Scripts são read-only quando carregados via link de compartilhamento até que o destinatário os clone para sua própria biblioteca.