4. Registros del proceso de transacción

4.1. Habilitar registro comercial

Establezca trade_log=True en qt.run(…, trade_log=True) para registrar cada operación durante el backtesting. Las configuraciones relacionadas (como la ruta para guardar el registro) dependen de qt.configure() o del entorno de ejecución.

4.2. Descripción del contenido del registro

El registro comercial normalmente incluye los siguientes campos (enumérelos y explíquelos brevemente); la salida real prevalecerá:

Campo

Significado

Hora/Fecha

Hora o fecha de ejecución.

Subyacente

Código de stock/contrato.

Dirección

Compra/Venta.

Precio

Precio de ejecución.

Cantidad

Cantidad ejecutada.

Cantidad

Monto ejecutado.

Tarifa

Comisiones, timbres, etc.

Nota

Otras notas (si las hubiera).

4.3. Ver y guardar

  • Ver: una vez finalizada la prueba retrospectiva, puede leer trade_log a través del objeto de resultado o la API (por ejemplo, como un DataFrame o una ruta de archivo).

  • Guardar: si el marco escribe registros en un archivo, la ruta está determinada por el elemento de configuración trade_log_file_path (admite rutas relativas/absolutas/directorio de inicio; se puede modificar en caliente a través de qt.configure()). Consulte la documentación de la API para obtener más detalles.

  • Rotación de registros (rotar): cuando trade_log_keep_days es un número entero positivo, qteasy realiza una limpieza del directorio trade_log_file_path actual en función de ese período de retención después de que se inicia el proceso y el módulo qteasy se importa con éxito: elimina trade_log_*.csv, trade_summary_*.csv y value_curve_*.csv anterior al período de retención (la marca de tiempo en el nombre del archivo o el tiempo m del archivo se utiliza para determinar la edad). No se limpiará automáticamente nuevamente antes de escribir nuevos CSV al final de cada prueba retrospectiva; Si una única sesión de larga duración genera muchos archivos, puede llamar a qt.rotate_trade_logs() para limpiarlos manualmente. El valor predeterminado trade_log_keep_days es 3; configúrelo en Ninguno o menor o igual a 0 para deshabilitar la eliminación automática. La rotación solo afecta a los archivos antiguos en el disco y no cambia los resultados de las pruebas retrospectivas ni ninguna API externa.

4.4. Relación con el resultado

  • trade_log corresponde al loop_result y oper_count del backtest: cada registro corresponde a una operación real, y oper_count pueden ser estadísticas agregadas.

  • Se utiliza para verificar la coherencia entre el proceso de backtest y las métricas de rendimiento.