Manual de referencia de MQL5IntegraciónMetaTrader para Python

Módulo MetaTrader para la integración con Python

Python es un lenguaje de programación moderno y de alto nivel para el desarrollo de escenarios y aplicaciones. Contiene multitud de bibliotecas para el aprendizaje de máquinas, la automatización de procesos, y también el análisis y visualización de datos.

El paquete MetaTrader para Python ha sido pensado para obtener de forma rápida y sencilla información bursátil a través de la interacción entre procesadores directamente desde el terminal MetaTrader 5. Los datos obtenidos de esta forma se pueden utilizar en lo sucesivo para cálculos estadísticos y aprendizaje de máquinas.

Instalar el paquete en la línea de comandos:

pip install MetaTrader5

Actualizar el paquete en la línea de comandos:

pip install --upgrade MetaTrader5

Funciones para la integración de MetaTrader 5 y Python

Función	Acción
initialize	Establece una conexión con el terminal MetaTrader 5
login	Se conecta a la cuenta comercial con los parámetros indicados
shutdown	Cierra una conexión anteriormente establecida con el terminal MetaTrader 5
version	Retorna la versión del terminal MetaTrader 5
last_error	Retorna la información sobre el último error
account_info	Obtiene la información sobre la cuenta comercial actual
terminal_Info	Obtiene el estado y los parámetros del terminal MetaTrader 5 conectado
symbols_total	Obtiene el número total de instrumentos financieros en el terminal MetaTrader 5
symbols_get	Obtiene todos los instrumentos financieros del terminal MetaTrader 5
symbol_info	Obtiene la información sobre el instrumento financiero indicado
symbol_info_tick	Obtiene el último tick del instrumento financiero indicado
symbol_select	Selecciona un símbolo en la ventana MarketWatch o quita un símbolo de esta ventana
market_book_add	Realiza la suscripción del terminal MetaTrader 5 para recibir eventos sobre los cambios en la profundidad de mercado
market_book_get	Retorna desde BookInfo la tupla que contiene las entradas de la profundidad de mercado del símbolo indicado
market_book_release	Cancela la suscripción del terminal MetaTrader 5 para recibir eventos sobre los cambios en la profundidad de mercado
copy_rates_from	Obtiene las barras del terminal MetaTrader 5, a partir de la fecha indicada
copy_rates_from_pos	Obtiene las barras del terminal MetaTrader 5, a partir del índice establecido
copyrates_range	Obtiene las barras en el intervalo de fechas indicado del terminal MetaTrader 5
copy_ticks_from	Obtiene los ticks del terminal MetaTrader 5, a partir de la fecha indicada
copy_ticks_range	Obtiene los ticks en el intervalo de fechas indicado del terminal MetaTrader 5
orders_total	Obtiene el número de órdenes activas.
orders_get	Obtiene la órdenes activas con posibilidad de filtrado según un símbolo o ticket
order_calc_margin	Retorna el tamaño del margen en la divisa de la cuenta para realizar la operación comercial indicada
order_calc_profit	Retorna el tamaño del beneficio en la divisa de la cuenta para la operación comercial indicada
order_check	Comprueba si los fondos son suficientes para realizar la operación comercial requerida
order_send	Envía desde el terminal al servidor comercial una solicitud de ejecución de una operación comercial.
positions_total	Obtiene el número de posiciones abiertas
positions_get	Obtiene las posiciones abiertas con posibilidad de filtrado según un símbolo o ticket
history_orders_total	Obtiene el número de órdenes en la historia comercial en el intervalo indicado
history_orders_get	Obtiene las órdenes de la historia comercial con posibilidad de filtrado según un ticket o posición
history_deals_total	Obtiene el número de transacciones en la historia comercial en el intervalo indicado
history_deals_get	Obtiene las transacciones de la historia comercial con posibilidad de filtrado según un ticket o posición

Ejemplo de conexión de Python a MetaTrader 5

Descargue la última versión Python 3.8 de la página https://www.python.org/downloads/windows
Al instalar Python, marque la casilla de verificación "Add Python 3.8 to PATH%", para que sea posible iniciar scripts en Python desde la línea de comandos.
Instale el módulo MetaTrader5 desde la línea de comandos

pip install MetaTrader5

Añada los paquetes matplotlib y pandas

pip install matplotlib
pip install pandas

Inicie el script de prueba

from datetime import datetime
import matplotlib.pyplot as plt
import pandas as pd
from pandas.plotting import register_matplotlib_converters
register_matplotlib_converters()
import MetaTrader5 as mt5

# conectamos con MetaTrader 5
if not mt5.initialize():
print("initialize() failed")
mt5.shutdown()

# solicitamos el estado y los parámetros de conexión
print(mt5.terminal_info())
# obtenemos la información sobre la versión de MetaTrader 5
print(mt5.version())

# solicitamos 1000 ticks de EURAUD
euraud_ticks = mt5.copy_ticks_from("EURAUD", datetime(2020,1,28,13), 1000, mt5.COPY_TICKS_ALL)
# solicitamos los ticks de AUDUSD en el intervalo 2019.04.01 13:00 - 2019.04.02 13:00
audusd_ticks = mt5.copy_ticks_range("AUDUSD", datetime(2020,1,27,13), datetime(2020,1,28,13), mt5.COPY_TICKS_ALL)

# obtenemos con distintos métodos las barras de diferentes instrumentos
eurusd_rates = mt5.copy_rates_from("EURUSD", mt5.TIMEFRAME_M1, datetime(2020,1,28,13), 1000)
eurgbp_rates = mt5.copy_rates_from_pos("EURGBP", mt5.TIMEFRAME_M1, 0, 1000)
eurcad_rates = mt5.copy_rates_range("EURCAD", mt5.TIMEFRAME_M1, datetime(2020,1,27,13), datetime(2020,1,28,13))

# finalizamos la conexión con MetaTrader 5
mt5.shutdown()

#DATA
print('euraud_ticks(', len(euraud_ticks), ')')
for val in euraud_ticks[:10]: print(val)

print('audusd_ticks(', len(audusd_ticks), ')')
for val in audusd_ticks[:10]: print(val)

print('eurusd_rates(', len(eurusd_rates), ')')
for val in eurusd_rates[:10]: print(val)

print('eurgbp_rates(', len(eurgbp_rates), ')')
for val in eurgbp_rates[:10]: print(val)

print('eurcad_rates(', len(eurcad_rates), ')')
for val in eurcad_rates[:10]: print(val)

#PLOT
# creamos un DataFrame de los datos obtenidos
ticks_frame = pd.DataFrame(euraud_ticks)
# dibujamos los ticks en el gráfico
plt.plot(ticks_frame['time'], ticks_frame['ask'], 'r-', label='ask')
plt.plot(ticks_frame['time'], ticks_frame['bid'], 'b-', label='bid')

# mostramos los rótulos
plt.legend(loc='upper left')

# añadimos los encabezados
plt.title('EURAUD ticks')

# mostramos el gráfico
plt.show()

Obtenga los datos y el gráfico

[2, 'MetaQuotes-Demo', '16167573']
[500, 2325, '19 Feb 2020']

euraud_ticks( 1000 )
(1580209200, 1.63412, 1.63437, 0., 0, 1580209200067, 130, 0.)
(1580209200, 1.63416, 1.63437, 0., 0, 1580209200785, 130, 0.)
(1580209201, 1.63415, 1.63437, 0., 0, 1580209201980, 130, 0.)
(1580209202, 1.63419, 1.63445, 0., 0, 1580209202192, 134, 0.)
(1580209203, 1.6342, 1.63445, 0., 0, 1580209203004, 130, 0.)
(1580209203, 1.63419, 1.63445, 0., 0, 1580209203487, 130, 0.)
(1580209203, 1.6342, 1.63445, 0., 0, 1580209203694, 130, 0.)
(1580209203, 1.63419, 1.63445, 0., 0, 1580209203990, 130, 0.)
(1580209204, 1.63421, 1.63445, 0., 0, 1580209204194, 130, 0.)
(1580209204, 1.63425, 1.63445, 0., 0, 1580209204392, 130, 0.)
audusd_ticks( 40449 )
(1580122800, 0.67858, 0.67868, 0., 0, 1580122800244, 130, 0.)
(1580122800, 0.67858, 0.67867, 0., 0, 1580122800429, 4, 0.)
(1580122800, 0.67858, 0.67865, 0., 0, 1580122800817, 4, 0.)
(1580122801, 0.67858, 0.67866, 0., 0, 1580122801618, 4, 0.)
(1580122802, 0.67858, 0.67865, 0., 0, 1580122802928, 4, 0.)
(1580122809, 0.67855, 0.67865, 0., 0, 1580122809526, 130, 0.)
(1580122809, 0.67855, 0.67864, 0., 0, 1580122809699, 4, 0.)
(1580122813, 0.67855, 0.67863, 0., 0, 1580122813576, 4, 0.)
(1580122815, 0.67856, 0.67863, 0., 0, 1580122815190, 130, 0.)
(1580122815, 0.67855, 0.67863, 0., 0, 1580122815479, 130, 0.)
eurusd_rates( 1000 )
(1580149260, 1.10132, 1.10151, 1.10131, 1.10149, 44, 1, 0)
(1580149320, 1.10149, 1.10161, 1.10143, 1.10154, 42, 1, 0)
(1580149380, 1.10154, 1.10176, 1.10154, 1.10174, 40, 2, 0)
(1580149440, 1.10174, 1.10189, 1.10168, 1.10187, 47, 1, 0)
(1580149500, 1.10185, 1.10191, 1.1018, 1.10182, 53, 1, 0)
(1580149560, 1.10182, 1.10184, 1.10176, 1.10183, 25, 3, 0)
(1580149620, 1.10183, 1.10187, 1.10177, 1.10187, 49, 2, 0)
(1580149680, 1.10187, 1.1019, 1.1018, 1.10187, 53, 1, 0)
(1580149740, 1.10187, 1.10202, 1.10187, 1.10198, 28, 2, 0)
(1580149800, 1.10198, 1.10198, 1.10183, 1.10188, 39, 2, 0)
eurgbp_rates( 1000 )
(1582236360, 0.83767, 0.83767, 0.83764, 0.83765, 23, 9, 0)
(1582236420, 0.83765, 0.83765, 0.83764, 0.83765, 15, 8, 0)
(1582236480, 0.83765, 0.83766, 0.83762, 0.83765, 19, 7, 0)
(1582236540, 0.83765, 0.83768, 0.83758, 0.83763, 39, 6, 0)
(1582236600, 0.83763, 0.83768, 0.83763, 0.83767, 21, 6, 0)
(1582236660, 0.83767, 0.83775, 0.83765, 0.83769, 63, 5, 0)
(1582236720, 0.83769, 0.8377, 0.83758, 0.83764, 40, 7, 0)
(1582236780, 0.83766, 0.83769, 0.8376, 0.83766, 37, 6, 0)
(1582236840, 0.83766, 0.83772, 0.83763, 0.83772, 22, 6, 0)
(1582236900, 0.83772, 0.83773, 0.83768, 0.8377, 36, 5, 0)
eurcad_rates( 1441 )
(1580122800, 1.45321, 1.45329, 1.4526, 1.4528, 146, 15, 0)
(1580122860, 1.4528, 1.45315, 1.45274, 1.45301, 93, 15, 0)
(1580122920, 1.453, 1.45304, 1.45264, 1.45264, 82, 15, 0)
(1580122980, 1.45263, 1.45279, 1.45231, 1.45277, 109, 15, 0)
(1580123040, 1.45275, 1.4528, 1.45259, 1.45271, 53, 14, 0)
(1580123100, 1.45273, 1.45285, 1.45269, 1.4528, 62, 16, 0)
(1580123160, 1.4528, 1.45284, 1.45267, 1.45282, 64, 14, 0)
(1580123220, 1.45282, 1.45299, 1.45261, 1.45272, 48, 14, 0)
(1580123280, 1.45272, 1.45275, 1.45255, 1.45275, 74, 14, 0)
(1580123340, 1.45275, 1.4528, 1.4526, 1.4528, 94, 13, 0)

Integración

initialize