IDE: parámetros, validación e historial

Esta página cubre tres cosas que hacen del IDE algo cómodo y seguro: los parámetros ajustables con sliders, el diagnóstico en vivo que te avisa de errores mientras escribes, y el historial de versiones automáticas que guarda tu progreso. Al final encontrarás también todo lo que necesitas saber sobre la caja de seguridad (sandbox) en la que corre tu código.

Parámetros con Parameter()

Cuando declaras un atributo de clase con `Parameter(...)`, TradingNote lo detecta automáticamente y crea un slider en el panel derecho del IDE. De este modo puedes afinar valores sin tocar el código, y además esos mismos parámetros quedan listos para ser barridos por el optimizador cuando llegue el momento.

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

Puedes organizar los sliders en secciones con un comentario especial inmediatamente antes del grupo. El IDE reconoce la sintaxis `# ── Nombre ──` y crea una cabecera visual que separa los parámetros en el panel.

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 en vivo

Mientras escribes, la pestaña de Diagnóstico (panel inferior del IDE) marca problemas al instante, sin que tengas que ejecutar nada. Cuando todo está correcto aparece el estado verde «código limpio»; si hay algo incorrecto, verás contadores de errores y avisos con su línea exacta.

• Imports o funciones prohibidas (acceso fuera del sandbox).
• Falta de la clase Strategy como clase base.
• Falta del método obligatorio on_bar().
• Indentación inválida (mezcla de espacios y tabs).
• Paréntesis, comillas o llaves sin cerrar.

Historial de versiones

No tienes que guardar a mano. El IDE auto-guarda aproximadamente cada 1,5 segundos y, si hubo cambios, crea un snapshot automático cada ~30 segundos. Se conservan hasta 100 versiones por archivo. En la pestaña Historial puedes ver todas las versiones anteriores con su timestamp y restaurar cualquiera con un solo clic.

La caja de seguridad (sandbox)

Tu código corre aislado por seguridad: sin acceso a internet, sin disco, sin librerías del sistema operativo. Esto protege la plataforma y a todos los demás usuarios. La tabla siguiente resume qué está permitido y qué está bloqueado.

Proyectos con varios archivos

Puedes dividir tu estrategia en varios archivos .py (por ejemplo main.py y helpers.py) y carpetas, e importar entre ellos con normalidad usando rutas relativas. El punto de entrada obligatorio es siempre 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

Cuando tu estrategia esté lista, pulsa «Guardar como algoritmo». Recuerda que el IDE no ejecuta el código: al guardar, la estrategia pasa a «Mis Algoritmos» como un algoritmo más, y es ahí donde la backtesteas, ajustas sus parámetros para encontrar los mejores, la validas estadísticamente (DSR, Walk-Forward, Multiverso) y, si pasa, la añades a un portafolio o la llevas a live trading.