Référence MQL5IntégrationMetaTrader pour Python

Module MetaTrader pour l'intégration avec Python

Python est un langage de programmation de haut niveau moderne pour développer des scripts et des applications. Il contient plusieurs bibliothèques pour le machine learning, l'automatisation des processus, ainsi que l'analyse et la visualisation des données.

Le package MetaTrader pour Python est conçu pour obtenir facilement et rapidement des données boursières via une communication interprocesseur directement à partir du terminal MetaTrader 5. Les données reçues de cette manière peuvent être utilisées pour des calculs statistiques et le machine learning.

Installation du package à partir de la ligne de commande :

pip install MetaTrader5

Mise à jour du package à partir de la ligne de commande :

pip install --upgrade MetaTrader5

Fonctions d'intégration de MetaTrader 5 et Python

Fonction	Action
initialize	Établit une connexion avec le terminal MetaTrader 5
login	Connexion à un compte de trading en utilisant les paramètres spécifiés
shutdown	Ferme la connexion précédemment établie avec le terminal MetaTrader 5
version	Retourne la version du terminal MetaTrader 5
last_error	Retourne les données de la dernière erreur
account_info	Retourne des informations sur le compte de trading actuel
terminal_Info	Retourne l'état et les paramètres du terminal MetaTrader 5 connecté
symbols_total	Retourne le nombre total d'instruments financiers dans le terminal MetaTrader 5
symbols_get	Retourne tous les instruments financiers du terminal MetaTrader 5
symbol_info	Retourne les données sur l'instrument financier spécifié
symbol_info_tick	Sélectionne un symbole dans le MarketWatch
symbol_select	Sélectionne un symbole dans la fenêtre MarketWatch ou supprime un symbole de la fenêtre
market_book_add	Abonne le terminal MetaTrader 5 aux événements de changements du Market Depth pour un symbole spécifié
market_book_get	Renvoie un tuple de BookInfo contenant des entrées du Market Depth pour le symbole spécifié
market_book_release	Annule l'abonnement du terminal MetaTrader 5 aux événements de changement de Market Depth pour un symbole spécifié
copy_rates_from	Retourne les barres du terminal MetaTrader 5 à partir de la date spécifiée
copy_rates_from_pos	Retourne les barres du terminal MetaTrader 5 à partir de l'index spécifié
copyrates_range	Retourne les barres du terminal MetaTrader 5 dans la plage de dates spécifiée
copy_ticks_from	Retourne les ticks du terminal MetaTrader 5 à partir de la date spécifiée
copy_ticks_range	Retourne les ticks du terminal MetaTrader 5 pour la plage de dates spécifiée
orders_total	Retourne le nombre d'ordre actifs.
orders_get	Retourne les ordres actifs avec la possibilité de filtrer par symbole ou ticket
order_calc_margin	Retourne la marge dans la devise du compte pour effectuer une opération de trading spécifiée
order_calc_profit	Retourne le profit dans la devise du compte pour une opération de trading spécifiée
order_check	Vérifie la suffisance des fonds pour effectuer une opération de trading désirée
order_send	Envoie une requête pour effectuer une opération de trading.
positions_total	Retourne le nombre de positions ouvertes
positions_get	Retourne les positions ouvertes avec la possibilité de filtrer par symbole ou ticket
history_orders_total	Retourne le nombre d'ordres dans l'historique de trading dans l'intervalle spécifié
history_orders_get	Retourne les ordres de l'historique de trading avec la possibilité de filtrer par ticket ou par position
history_deals_total	Retourne le nombre de transactions dans l'historique de trading dans l'intervalle spécifié
history_deals_get	Retourne les transactions de l'historique de trading avec la possibilité de filtrer par ticket ou par position

Exemple de connexion de Python à MetaTrader 5

Téléchargez la dernière version de Python 3.8 depuis https://www.python.org/downloads/windows
Lors de l'installation de Python, cochez "Ajouter Python 3.8 au PATH%" pour pouvoir exécuter des scripts Python à partir de la ligne de commande.
Installez le module MetaTrader 5 à partir de la ligne de commande

pip install MetaTrader5

Ajoutez les packages matplotlib et pandas

pip install matplotlib
pip install pandas

Lancez le script de test

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

# connexion à MetaTrader 5
if not mt5.initialize():
print("initialize() a échoué")
mt5.shutdown()

# demande l'état et les paramètres de connexion
print(mt5.terminal_info())
# récupère les données sur la version MetaTrader 5
print(mt5.version())

# demande 1000 ticks à EURAUD
euraud_ticks = mt5.copy_ticks_from("EURAUD", datetime(2020,1,28,13), 1000, mt5.COPY_TICKS_ALL)
# demande les ticks de AUDUSD du 2019.04.01 13:00 au 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)

# récupère les barres de différents symboles de différentes manières
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))

# ferme la connexion à 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)

#DESSIN
# crée le DataFrame à partir des données obtenues
ticks_frame = pd.DataFrame(euraud_ticks)
# convertit le temps en secondes au format datetime
ticks_frame['time']=pd.to_datetime(ticks_frame['time'], unit='s')
# affiche les ticks sur le graphique
plt.plot(ticks_frame['time'], ticks_frame['ask'], 'r-', label='ask')
plt.plot(ticks_frame['time'], ticks_frame['bid'], 'b-', label='bid')

# affiche les légendes
plt.legend(loc='upper left')

# ajoute l'en-tête
plt.title('EURAUD ticks')

# affiche le graphique
plt.show()

Récupère les données et le graphique

[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)

Intégration

initialize