Convierte el historial de MT5 en un informe.
Operaciones reales. Depósitos separados. Exportación de resultados.
Descargar el ejemplo de Python · ZIP ↓
Guía paso a paso
- 0:00
Convierte el historial de MT5 en un informe.
En este tutorial aprenderás a consultar el historial de operaciones de MT5, calcular el resultado contabilizado y exportar un informe claro con Python.
- 0:14
Conéctate para consultar el historial.
Abre mt5.mrpc.pro y selecciona ConnectEx. Introduce el usuario, la contraseña y el servidor de tu cuenta demo. Usa TRIAL o tu clave API. Deja vacío el campo opcional id. En esta grabación usamos una contraseña de inversor con acceso de solo lectura. La consola conserva el identificador del terminal recibido.
- 0:41
Comprueba la moneda de la cuenta.
Ejecuta AccountSummary. Es una cuenta demo en dólares estadounidenses. Su saldo es de noventa y nueve mil novecientos noventa y nueve dólares con noventa y seis centavos. Presenta los beneficios y los costes en la moneda de la cuenta.
- 1:02
Selecciona un período ya terminado.
Selecciona DealsHistory. Rellena inputFromUtc e inputToUtc con marcas de tiempo terminadas en Z. Deja vacíos los campos equivalentes de hora del bróker. Aquí consultamos desde el uno de octubre hasta el inicio del veintiocho de octubre. Mantén ese intervalo al pedir las siguientes páginas.
- 1:28
Consulta todas las páginas.
Después de HTTP Status Code 200, comprueba primero error. Esta respuesta no contiene un error de la API. Con pageSize igual a dos, la primera página solo incluye dos de trece operaciones. Copia nextPageToken en pageToken sin cambiar los filtros. Continúa hasta que nextPageToken esté vacío.
- 1:54
Órdenes, ejecuciones y posiciones.
Una orden es una instrucción de negociación; un deal registra una ejecución. AllHistoryOrders muestra las órdenes. En DealsHistory, order enlaza con el ticket de la orden y positionId agrupa las ejecuciones relacionadas. Esta posición tiene una entrada de cero coma cero dos lotes y dos salidas de cero coma cero uno.
- 2:21
Suma los importes con su signo.
Para cada ejecución, suma profit, commission, swap y fee tal como los devuelve la API. Respeta los signos: no vuelvas a restar una comisión que ya es negativa. Esta salida ganó dos centavos y no tuvo costes. Incluye también las entradas, porque el bróker puede cobrar comisión al abrir.
- 2:46
Separa los movimientos de fondos.
El primer registro es un depósito demo de cien mil dólares. Su tipo es BALANCE y no tiene orden ni posición. No es un beneficio de negociación. El informe separa los deals Buy y Sell de los demás tipos. Revisa cargos independientes, créditos y ajustes en el archivo other-deals.
- 3:12
Comprueba el alcance del informe.
Están presentes los trece registros. Los doce deals de negociación suman menos cuatro centavos. Comisión, swap y fee son cero en este ejemplo. El depósito va aparte. Son importes contabilizados en esas fechas, no beneficios no realizados. Una posición abierta antes puede tener costes fuera del intervalo.
- 3:39
Exporta los mismos datos con Python.
El script llama al mismo endpoint DealsHistory, recorre las páginas y comprueba el número final de registros. Utiliza aritmética decimal y agrupa los importes por positionId. Guarda la clave API y el id del terminal en variables de entorno privadas. El script nunca abre ni cierra operaciones.
- 4:04
Abre los tres archivos del informe.
Ejecuta el script con las fechas UTC fijadas. Genera trade-deals.csv, other-deals.csv y summary.json. La exportación de ejemplo se comprobó con este historial capturado. Si aparece un error de la API o faltan páginas, el script se detiene en lugar de presentar un total incompleto.
- 4:30
Desconecta al terminar.
Por último, ejecuta Disconnect en la consola para liberar el terminal. Nuestra sesión ya está desconectada. Has consultado el historial, separado los fondos del resultado de negociación y exportado un informe que puedes revisar y reutilizar.