Cómo Importar Operaciones de NinjaTrader a Fillbook

Los dos métodos compatibles

La sincronización en vivo (un add-on de NinjaScript que instalas dentro de NinjaTrader) es el método hacia adelante — solo reporta operaciones desde el momento en que está activo, no tu historial pasado. La exportación CSV es el método de respaldo histórico — así llevas a Fillbook las operaciones de antes de que el add-on estuviera activo. La mayoría de los traders usan ambos: CSV una vez para el historial, luego el add-on para todo lo que sigue.

Método 1: Sincronización en vivo (add-on de NinjaScript)

Esto instala un pequeño add-on directamente dentro de tu plataforma NinjaTrader 8. Escucha eventos de ejecución en tus propias cuentas y envía cada uno a Fillbook en el momento en que ocurre — no puede colocar, modificar ni cancelar órdenes, y nunca toca tu inicio de sesión de bróker.

1. En Fillbook, ve a Importar → Sincronización automática de NinjaTrader y genera un token de sincronización.
2. Descarga el archivo del add-on (FillbookSync.cs) y ábrelo en un editor de texto. Pega tu token en la única línea de configuración en la parte superior — el endpoint de Fillbook ya está completado.
3. En NinjaTrader 8: Tools → Import → NinjaScript Add-On… y selecciona el archivo editado. NinjaTrader lo compila automáticamente.
4. Reinicia NinjaTrader (o usa Tools → Edit NinjaScript → Compile). El add-on entonces se ejecuta silenciosamente en segundo plano — sin ventana que abrir, sin botón que pulsar por cada operación.

Dicho claramente: este add-on está escrito contra las APIs documentadas de add-on de NinjaTrader 8, pero no ha sido verificado de forma independiente contra una instalación real de NinjaTrader al redactar esta guía. Si el compilador de NinjaScript reporta un error al importar, típicamente es una corrección de una línea (los nombres de propiedades/eventos han cambiado ligeramente en ocasiones entre versiones de NinjaTrader) — el propio comentario de código fuente de Fillbook en el archivo dice lo mismo.

Método 2: Exportación manual de CSV (para historial anterior al add-on, o si prefieres no instalarlo)

El Control Center de NinjaTrader puede exportar tu historial de operaciones directamente como un CSV que el importador de Fillbook lee con mapeo automático de columnas.

1. En el Control Center de NinjaTrader, abre la pestaña Performance.
2. Haz clic derecho en la cuadrícula de resultados y elige "To Excel (CSV)".
3. En Fillbook, ve a Importar → CSV, elige NinjaTrader de la lista de plataformas (o mapea las columnas manualmente si el mapeo autodetectado necesita corrección), y confirma.

Campos y formatos requeridos

El importador de Fillbook necesita, como mínimo, una fecha, símbolo, dirección, cantidad, precio de entrada y precio de salida en cada fila; la comisión/tarifas y una fecha de cierre son opcionales pero mejoran la precisión. La exportación de la pestaña Performance de NinjaTrader usa "Market pos." para la dirección y "Entry price"/"Exit price" por nombre — el mapeo de columnas de Fillbook reconoce estos encabezados automáticamente, pero siempre verifica la pantalla de mapeo antes de confirmar, ya que una versión de NinjaTrader o un diseño de cuadrícula personalizado puede renombrar una columna.

Zonas horarias

El add-on en vivo envía la marca de tiempo de cada operación usando el reloj de tu propia sesión de NinjaTrader, en formato ISO 8601 — en la práctica, cualquier zona horaria en la que esté configurado el sistema operativo de tu computadora de trading. Confirma que esa zona horaria coincide con la que realmente pretendes antes de confiar en la analítica por hora del día, ya que una PC configurada con la zona horaria incorrecta reportaría mal cada operación por ese mismo desfase. Una exportación CSV lleva el formato de marca de tiempo que muestra la cuadrícula de NinjaTrader, que sigue la misma configuración de zona horaria del sistema.

Comisiones

El add-on en vivo reporta el valor de comisión de cada ejecución directamente desde el propio campo Execution.Commission de NinjaTrader, por operación. La columna de comisión de una exportación CSV (si tu diseño de la pestaña Performance incluye una) se mapea al campo de tarifas de Fillbook de la misma manera. En cualquiera de los dos caminos, verifica un puñado de operaciones importadas contra tu propio estado de cuenta la primera vez — una comisión de futuros es fácil de mapear incorrectamente a la columna equivocada si el diseño de exportación de un bróker difiere del predeterminado de NinjaTrader.

Manejo de duplicados

Fillbook identifica cada operación importada por sus propios datos de ejecución, así que volver a ejecutar la misma exportación CSV dos veces actualiza en lugar de duplicar las mismas operaciones — es seguro volver a exportar e importar si no estás seguro de qué ya está en Fillbook. El add-on en vivo solo reporta operaciones genuinamente nuevas a medida que ocurren, así que no reenvía el historial al reiniciar. El único caso a vigilar: ejecutar la importación CSV para un rango de fechas que se superpone con un período que el add-on en vivo ya cubría en vivo puede, dependiendo de cómo coincidan exactamente los datos de ejecución de cada operación, requerir ocasionalmente una revisión manual en tu tabla de Operaciones en lugar de una garantía automática en cualquier sentido — en caso de duda, usa CSV para períodos estrictamente anteriores a cuando activaste el add-on.

Reconciliar cantidades importadas y P&L

Después de una importación, compara la cantidad de operaciones y el P&L neto de Fillbook para el rango de fechas importado contra la propia pestaña Performance de NinjaTrader para el mismo rango. Una cantidad no coincidente normalmente significa que un filtro (rango de fechas, cuenta o instrumento) difiere entre las dos vistas en lugar de una operación perdida; un P&L no coincidente casi siempre se remonta a una comisión o tarifa que no se mapeó a la columna correcta — revisa la pantalla de mapeo de columnas del Asistente de Importación para ese campo específico antes de asumir un error de cálculo.

Fallos comunes y recuperación

Si nada se sincroniza con el add-on en vivo, primero confirma que realmente reemplazaste el token de marcador de posición en la línea de configuración — el add-on intencionalmente no hace nada hasta que eso esté hecho. Si el compilador de NinjaTrader rechaza el archivo, copia el texto exacto del error; casi siempre es un desajuste menor de nombre de API entre versiones de NinjaTrader, no una incompatibilidad fundamental. Si una importación CSV reporta menos filas escritas de las que contiene el archivo, revisa el resumen del Asistente de Importación para filas omitidas — un campo requerido en blanco o ilegible (una celda de encabezado combinada, un símbolo de moneda inesperado) hace que se omita una fila en lugar de importarla con un valor adivinado.