IDE: parâmetros, validação e histórico

Esta página cobre três coisas que tornam o IDE confortável e seguro: parâmetros ajustáveis com sliders, o diagnóstico ao vivo que avisa sobre erros enquanto você digita, e o histórico de versões automáticas que salva seu progresso. No final você encontrará também tudo que precisa saber sobre a caixa de segurança (sandbox) onde seu código é executado.

Parâmetros com Parameter()

Quando você declara um atributo de classe com `Parameter(...)`, o TradingNote o detecta automaticamente e cria um slider no painel direito do IDE. Assim você pode ajustar valores sem tocar no código, e esses mesmos parâmetros ficam prontos para serem varridos pelo otimizador quando chegar a hora.

class MiEstrategia(Strategy):
    rsi_period = Parameter(14, min_val=5, max_val=50, step=1, label="Periodo RSI")
    sl_atr     = Parameter(1.5, min_val=0.5, max_val=5.0, step=0.1, label="Stop Loss (ATR)")

Agrupar parâmetros

Você pode organizar os sliders em seções com um comentário especial imediatamente antes do grupo. O IDE reconhece a sintaxe `# ── Nome ──` e cria um cabeçalho visual que separa os parâmetros no painel.

class MiEstrategia(Strategy):
    # ── Entrada ──
    rsi_period = Parameter(14, min_val=5, max_val=50, step=1, label="Periodo RSI")
    # ── Salida ──
    sl_atr = Parameter(1.5, min_val=0.5, max_val=5.0, step=0.1, label="Stop (ATR)")
    tp_atr = Parameter(3.0, min_val=0.5, max_val=10.0, step=0.1, label="Target (ATR)")

Diagnóstico ao vivo

Enquanto você digita, a aba de Diagnóstico (painel inferior do IDE) marca problemas na hora, sem que você precise executar nada. Quando tudo está correto, aparece o estado verde «código limpo»; se houver algo errado, você verá contadores de erros e avisos com a linha exata.

• Imports ou funções proibidas (acesso fora do sandbox).
• Ausência da classe Strategy como classe base.
• Ausência do método obrigatório on_bar().
• Indentação inválida (mistura de espaços e tabs).
• Parênteses, aspas ou chaves sem fechar.

Histórico de versões

Você não precisa salvar manualmente. O IDE salva automaticamente a cada 1,5 segundos aproximadamente e, se houve mudanças, cria um snapshot automático a cada ~30 segundos. São mantidas até 100 versões por arquivo. Na aba Histórico você pode ver todas as versões anteriores com seu timestamp e restaurar qualquer uma com um único clique.

A caixa de segurança (sandbox)

Seu código é executado de forma isolada por segurança: sem acesso à internet, sem disco, sem bibliotecas do sistema operacional. Isso protege a plataforma e todos os outros usuários. A tabela abaixo resume o que é permitido e o que é bloqueado.

Projetos com vários arquivos

Você pode dividir sua estratégia em vários arquivos .py (por exemplo main.py e helpers.py) e pastas, e importar entre eles normalmente usando caminhos relativos. O ponto de entrada obrigatório é sempre main.py.

# helpers.py
def es_sesion_londres(hora_utc):
    return 7 <= hora_utc < 16

# main.py
from strategy_base import Strategy, Parameter
from helpers import es_sesion_londres

class MiEstrategia(Strategy):
    def on_bar(self):
        if not es_sesion_londres(self.current_bar.hour):
            return
        # ... lógica de trading

Publicar como algoritmo

Quando sua estratégia estiver pronta, pressione «Salvar como algoritmo». Lembre-se de que o IDE não executa o código: ao salvar, a estratégia passa para «Meus Algoritmos» como um novo algoritmo, e é aí que você faz o backtest, ajusta seus parâmetros para encontrar os melhores, valida estatisticamente (DSR, Walk-Forward, Multiverso) e, se passar, adiciona a um portfólio ou leva ao live trading.