MQL4 · Migration MQL5
MarketInfo vers SymbolInfo : la table de correspondance MQL4 → MQL5
MarketInfo et les variables Bid et Ask n’existent pas en MQL5. Voici la correspondance de chaque identifiant MODE_ avec SymbolInfoDouble, SymbolInfoInteger ou OrderCalcMargin, et un code de portage.
MarketInfo(symbole, identifiant) est en MQL4 la fonction à tout faire pour lire une propriété d’un symbole : prix courants, nombre de décimales, distance minimale des stops, volume minimal, valeur du tick, marge requise. Elle n’existe pas en MQL5, pas plus que les variables prédéfinies Bid et Ask. Elle est remplacée par trois fonctions typées : SymbolInfoDouble pour les propriétés réelles, SymbolInfoInteger pour les propriétés entières et SymbolInfoString pour les chaînes, complétées par SymbolInfoTick pour les prix courants.
Bonne nouvelle : c’est le remplacement le plus mécanique de toute la migration, et il peut se faire dès MQL4, car SymbolInfoDouble, SymbolInfoInteger et SymbolInfoTick y existent aussi. Cette page donne la table de correspondance complète des identifiants MODE_... documentés en MQL4 et un code de portage.
Une différence de typage
MarketInfo renvoie toujours un double, même pour des propriétés entières comme le nombre de décimales ou la distance des stops. En MQL4, on écrit donc souvent (int)MarketInfo(sym, MODE_DIGITS). En MQL5, chaque propriété a son type : le nombre de décimales se lit avec SymbolInfoInteger(sym, SYMBOL_DIGITS), qui renvoie un long, et la distance des stops avec SymbolInfoInteger(sym, SYMBOL_TRADE_STOPS_LEVEL). Confondre les deux fonctions ne produit pas toujours une erreur de compilation, mais renvoie une valeur fausse : vérifiez la fonction associée à chaque identifiant.
La table de correspondance
MQL4 (MarketInfo) | MQL5 | Fonction MQL5 |
|---|---|---|
MODE_BID | SYMBOL_BID | SymbolInfoDouble (ou SymbolInfoTick) |
MODE_ASK | SYMBOL_ASK | SymbolInfoDouble (ou SymbolInfoTick) |
MODE_POINT | SYMBOL_POINT | SymbolInfoDouble |
MODE_DIGITS | SYMBOL_DIGITS | SymbolInfoInteger |
MODE_SPREAD | SYMBOL_SPREAD | SymbolInfoInteger |
MODE_STOPLEVEL | SYMBOL_TRADE_STOPS_LEVEL | SymbolInfoInteger |
MODE_FREEZELEVEL | SYMBOL_TRADE_FREEZE_LEVEL | SymbolInfoInteger |
MODE_LOTSIZE | SYMBOL_TRADE_CONTRACT_SIZE | SymbolInfoDouble |
MODE_TICKVALUE | SYMBOL_TRADE_TICK_VALUE | SymbolInfoDouble |
MODE_TICKSIZE | SYMBOL_TRADE_TICK_SIZE | SymbolInfoDouble |
MODE_SWAPLONG | SYMBOL_SWAP_LONG | SymbolInfoDouble |
MODE_SWAPSHORT | SYMBOL_SWAP_SHORT | SymbolInfoDouble |
MODE_SWAPTYPE | SYMBOL_SWAP_MODE | SymbolInfoInteger |
MODE_MINLOT | SYMBOL_VOLUME_MIN | SymbolInfoDouble |
MODE_LOTSTEP | SYMBOL_VOLUME_STEP | SymbolInfoDouble |
MODE_MAXLOT | SYMBOL_VOLUME_MAX | SymbolInfoDouble |
MODE_TRADEALLOWED | SYMBOL_TRADE_MODE | SymbolInfoInteger (énumération) |
MODE_TIME | SYMBOL_TIME | SymbolInfoInteger |
MODE_HIGH / MODE_LOW | SYMBOL_BIDHIGH / SYMBOL_BIDLOW | SymbolInfoDouble |
MODE_STARTING / MODE_EXPIRATION | SYMBOL_START_TIME / SYMBOL_EXPIRATION_TIME | SymbolInfoInteger |
MODE_PROFITCALCMODE / MODE_MARGINCALCMODE | SYMBOL_TRADE_CALC_MODE | SymbolInfoInteger (énumération) |
MODE_MARGININIT | SYMBOL_MARGIN_INITIAL | SymbolInfoDouble |
MODE_MARGINMAINTENANCE | SYMBOL_MARGIN_MAINTENANCE | SymbolInfoDouble |
MODE_MARGINHEDGED | SYMBOL_MARGIN_HEDGED | SymbolInfoDouble |
MODE_MARGINREQUIRED | pas d’identifiant direct | OrderCalcMargin |
MODE_CLOSEBY_ALLOWED | indicateur SYMBOL_ORDER_CLOSEBY dans SYMBOL_ORDER_MODE | SymbolInfoInteger |
Trois lignes demandent une attention particulière.
MODE_TRADEALLOWED renvoyait une valeur assimilable à vrai ou faux. SYMBOL_TRADE_MODE renvoie une énumération plus riche : trading désactivé, achats seuls, ventes seuls, clôture seule ou trading complet. Un test de type if(MarketInfo(sym, MODE_TRADEALLOWED)) doit devenir une comparaison avec la valeur SYMBOL_TRADE_MODE_FULL, ou un traitement explicite de chaque cas.
MODE_MARGINREQUIRED n’a pas d’identifiant équivalent. En MQL5, la marge nécessaire se calcule avec OrderCalcMargin(type, symbole, volume, prix, marge), qui remplit la variable marge et renvoie true en cas de succès. C’est plus précis, puisque le calcul tient compte du type d’ordre, du volume et du prix.
MODE_HIGH et MODE_LOW donnaient le plus haut et le plus bas du jour. Les propriétés SYMBOL_BIDHIGH et SYMBOL_BIDLOW donnent le plus haut et le plus bas du Bid sur la journée ; si votre code s’appuie sur la bougie quotidienne, iHigh(sym, PERIOD_D1, 0) et iLow(sym, PERIOD_D1, 0) sont une alternative disponible dans les deux langages.
Bid et Ask : SymbolInfoTick
Pour les prix courants, SymbolInfoTick(symbole, tick) remplit une structure MqlTick avec l’heure, le Bid, le Ask, le dernier prix et le volume du dernier tick. C’est la méthode recommandée lorsqu’on a besoin de Bid et Ask ensemble, car les deux valeurs proviennent du même tick. Elle remplace aussi RefreshRates() : en MQL5, chaque appel lit les données courantes, il n’y a pas de copie locale à rafraîchir.
Exemple de portage
La fonction ci-dessous calcule la distance minimale des stops et la marge d’un lot. Le premier bloc montre le code MQL4 d’origine ; le second, la version MQL5, dont la première fonction n’utilise que des fonctions communes aux deux langages.
//+------------------------------------------------------------------+
//| MQL4 d'origine |
//+------------------------------------------------------------------+
double MinStopDistanceMql4(const string sym)
{
return MarketInfo(sym, MODE_STOPLEVEL) * MarketInfo(sym, MODE_POINT);
}
double MarginPerLotMql4(const string sym)
{
return MarketInfo(sym, MODE_MARGINREQUIRED);
}
//+------------------------------------------------------------------+
//| Version MQL5 (la première fonction compile aussi en MQL4) |
//+------------------------------------------------------------------+
double MinStopDistance(const string sym)
{
long level = SymbolInfoInteger(sym, SYMBOL_TRADE_STOPS_LEVEL);
double point = SymbolInfoDouble(sym, SYMBOL_POINT);
return level * point;
}
//--- marge pour un lot à l'achat, au prix Ask courant (MQL5)
double MarginPerLot(const string sym)
{
MqlTick tick;
if(!SymbolInfoTick(sym, tick))
return 0.0;
double margin = 0.0;
if(!OrderCalcMargin(ORDER_TYPE_BUY, sym, 1.0, tick.ask, margin))
{
Print("OrderCalcMargin : erreur ", GetLastError());
return 0.0;
}
return margin;
}
//--- prix courants : remplace Bid, Ask et RefreshRates()
bool CurrentPrices(const string sym, double &bid, double &ask)
{
MqlTick tick;
if(!SymbolInfoTick(sym, tick))
return false;
bid = tick.bid;
ask = tick.ask;
return true;
}
Cas d’usage : la taille de position selon le risque
Le calcul de la taille de position est l’endroit où MarketInfo est le plus utilisé dans un EA MQL4, et donc celui où le portage demande le plus de soin. Il combine typiquement la valeur du tick (MODE_TICKVALUE), la taille du tick (MODE_TICKSIZE), le volume minimal, le pas et le volume maximal (MODE_MINLOT, MODE_LOTSTEP, MODE_MAXLOT), parfois la marge requise. Chacune de ces lectures a son équivalent dans la table ci-dessus, et la formule elle-même ne change pas : perte maximale acceptée divisée par la perte par lot sur la distance du stop, puis arrondi au pas.
Le point de vigilance est la cohérence des unités. La valeur du tick est exprimée dans la devise du compte pour un lot et un mouvement d’une taille de tick : la distance du stop doit donc être convertie en nombre de ticks, et non en nombre de points, lorsque les deux diffèrent. Cette règle était déjà vraie en MQL4, mais les migrations sont souvent l’occasion de découvrir qu’un ancien calcul fonctionnait par chance sur les paires de devises, où tick et point coïncident, et devient faux sur un indice ou un métal. Profitez du portage pour tester le calcul sur chaque type d’instrument que l’EA est susceptible de trader.
Les fonctions de compte
Le même principe s’applique aux informations du compte. AccountBalance(), AccountEquity() et AccountFreeMargin() deviennent respectivement AccountInfoDouble(ACCOUNT_BALANCE), AccountInfoDouble(ACCOUNT_EQUITY) et AccountInfoDouble(ACCOUNT_MARGIN_FREE). Le levier se lit avec AccountInfoInteger(ACCOUNT_LEVERAGE). Ces fonctions AccountInfo... existent aussi en MQL4 moderne : comme pour les propriétés du symbole, le remplacement peut être fait et testé avant la migration.
Méthode conseillée
- Recherchez toutes les occurrences de
MarketInfo,Bid,AsketRefreshRatesdans votre code MQL4. - Remplacez-les par
SymbolInfoDouble,SymbolInfoIntegeretSymbolInfoTick, dans la version MQL4, saufMODE_MARGINREQUIRED. - Compilez, lancez le backtest de référence et vérifiez qu’il est identique.
- Lors du portage, il ne restera plus qu’à traiter la marge avec
OrderCalcMarginet à supprimer les appels àRefreshRates.
Les usages de MarketInfo en MQL4 sont décrits dans MarketInfo, et les fonctions MQL5 dans SymbolInfoDouble, SymbolInfoInteger. Pour les autres chantiers de la migration, revenez à la rubrique Migrer de MQL4 vers MQL5, et pour l’accès aux séries, à [Remplacer Close[] et Time[]](/mql4/migration-mql5/tableaux-de-series-mql5/).
Pièges fréquents
- Mauvaise fonction pour le type : lire
SYMBOL_DIGITSavecSymbolInfoDoublene fonctionne pas ;SYMBOL_DIGITSest une propriété entière. - Symbole non sélectionné : pour lire les propriétés d’un symbole absent de la fenêtre Market Watch, il peut être nécessaire de l’ajouter avec
SymbolSelect(symbole, true). - Valeur nulle au démarrage : certaines propriétés, comme la valeur du tick, peuvent valoir 0 avant l’arrivée des premières cotations. Testez-les avant de les utiliser dans une division.
- Énumérations :
SYMBOL_TRADE_MODE,SYMBOL_SWAP_MODEetSYMBOL_TRADE_CALC_MODErenvoient des valeurs d’énumération dont la signification ne correspond pas forcément aux codes numériques de MQL4. Comparez toujours aux constantes nommées.
Questions fréquentes
Quel est l’équivalent de MarketInfo en MQL5 ?
SymbolInfoDouble pour les propriétés réelles (prix, point, volumes, valeur du tick), SymbolInfoInteger pour les propriétés entières (décimales, distance des stops, mode de trading) et SymbolInfoString pour les chaînes.
Comment obtenir Bid et Ask en MQL5 ?
Avec SymbolInfoTick(_Symbol, tick), qui remplit une structure MqlTick contenant tick.bid et tick.ask, ou avec SymbolInfoDouble(_Symbol, SYMBOL_BID) et SymbolInfoDouble(_Symbol, SYMBOL_ASK).
Que devient MODE_MARGINREQUIRED ?
Il n’a pas d’identifiant équivalent. Utilisez OrderCalcMargin, qui calcule la marge pour un type d’ordre, un volume et un prix donnés.
Peut-on utiliser SymbolInfoDouble dans un code MQL4 ?
Oui. SymbolInfoDouble, SymbolInfoInteger et SymbolInfoTick existent en MQL4 depuis la refonte du langage. Les utiliser dès la version MQL4 permet de tester ce remplacement avant la migration proprement dite.
Faut-il encore appeler RefreshRates en MQL5 ?
Non, la fonction n’existe pas en MQL5. Les fonctions SymbolInfoTick et SymbolInfoDouble lisent les données courantes à chaque appel.
