MQL4 · Ordres
MarketInfo en MQL4 : lire les propriétés d’un symbole
Spread, stop level, valeur du tick, volumes minimum et maximum, swap, marge : toutes les constantes MODE_ de MarketInfo en MQL4, avec un script de diagnostic et l’équivalent SymbolInfo.
MarketInfo() renvoie une propriété d’un symbole en MQL4 : prix, nombre de décimales, spread, distance minimale des stops, valeur du tick, volumes autorisés, marge requise. Sa signature est double MarketInfo(string symbol, int type), où type est une constante MODE_... : par exemple MarketInfo("EURUSD", MODE_SPREAD) renvoie le spread courant en points et MarketInfo(Symbol(), MODE_MINLOT) le volume minimal. Elle renvoie toujours un double, qu’il faut convertir en entier pour les propriétés entières comme MODE_DIGITS ou MODE_STOPLEVEL. C’est la fonction à utiliser dès qu’un EA a besoin d’informations sur un symbole autre que celui de son graphique, ou de propriétés que les variables prédéfinies ne fournissent pas.
Cette page présente les constantes disponibles, regroupées par usage, et montre comment les exploiter dans un EA. Elle fait partie de la rubrique Gérer les ordres en MQL4.
Les constantes de MarketInfo
La documentation officielle du MQL4 liste les identifiants suivants.
Prix et cotation
| Constante | Valeur | Contenu |
|---|---|---|
MODE_LOW | 1 | Plus bas du jour |
MODE_HIGH | 2 | Plus haut du jour |
MODE_TIME | 5 | Heure de la dernière cotation reçue |
MODE_BID | 9 | Dernier prix Bid |
MODE_ASK | 10 | Dernier prix Ask |
MODE_POINT | 11 | Taille du point dans la devise de cotation |
MODE_DIGITS | 12 | Nombre de décimales du prix |
MODE_SPREAD | 13 | Spread en points |
Contraintes de trading
| Constante | Valeur | Contenu |
|---|---|---|
MODE_STOPLEVEL | 14 | Distance minimale des stops, en points |
MODE_FREEZELEVEL | 33 | Distance de gel des ordres, en points |
MODE_TRADEALLOWED | 22 | Trading autorisé sur le symbole |
MODE_CLOSEBY_ALLOWED | 34 | Fermeture d’ordres opposés par OrderCloseBy() autorisée |
MODE_STARTING | 20 | Date de début de cotation (contrats à terme) |
MODE_EXPIRATION | 21 | Date d’expiration (contrats à terme) |
Volume, valeur et marge
| Constante | Valeur | Contenu |
|---|---|---|
MODE_LOTSIZE | 15 | Taille d’un lot dans la devise de base |
MODE_TICKVALUE | 16 | Valeur d’un tick dans la devise du compte |
MODE_TICKSIZE | 17 | Taille d’un tick |
MODE_MINLOT | 23 | Volume minimal |
MODE_LOTSTEP | 24 | Pas de variation du volume |
MODE_MAXLOT | 25 | Volume maximal |
MODE_MARGININIT | 29 | Marge initiale pour 1 lot |
MODE_MARGINMAINTENANCE | 30 | Marge de maintien pour 1 lot |
MODE_MARGINHEDGED | 31 | Marge pour des positions couvertes, pour 1 lot |
MODE_MARGINREQUIRED | 32 | Marge libre nécessaire pour acheter 1 lot |
Swap et modes de calcul
| Constante | Valeur | Contenu |
|---|---|---|
MODE_SWAPLONG | 18 | Swap des positions acheteuses |
MODE_SWAPSHORT | 19 | Swap des positions vendeuses |
MODE_SWAPTYPE | 26 | Méthode de calcul du swap |
MODE_PROFITCALCMODE | 27 | Mode de calcul du profit |
MODE_MARGINCALCMODE | 28 | Mode de calcul de la marge |
Un script de diagnostic d’un symbole
Le script suivant affiche dans le journal les propriétés utiles à la conception d’un EA. Lancez-le sur chaque symbole que vous comptez trader, chez chaque courtier : les valeurs changent d’un serveur à l’autre.
#property strict
#property script_show_inputs
input string InpSymbole = ""; // Symbole (vide = graphique courant)
void OnStart()
{
string s = (InpSymbole == "") ? Symbol() : InpSymbole;
// s'assurer que le symbole est disponible dans le terminal
if(!SymbolSelect(s, true))
{
PrintFormat("Symbole %s introuvable", s);
return;
}
int digits = (int)MarketInfo(s, MODE_DIGITS);
PrintFormat("=== %s ===", s);
PrintFormat("Bid %s / Ask %s, spread %d points",
DoubleToString(MarketInfo(s, MODE_BID), digits),
DoubleToString(MarketInfo(s, MODE_ASK), digits),
(int)MarketInfo(s, MODE_SPREAD));
PrintFormat("Point %s, décimales %d",
DoubleToString(MarketInfo(s, MODE_POINT), digits), digits);
PrintFormat("Stop level %d points, freeze level %d points",
(int)MarketInfo(s, MODE_STOPLEVEL), (int)MarketInfo(s, MODE_FREEZELEVEL));
PrintFormat("Volume min %.2f, max %.2f, pas %.2f",
MarketInfo(s, MODE_MINLOT), MarketInfo(s, MODE_MAXLOT),
MarketInfo(s, MODE_LOTSTEP));
PrintFormat("Tick : taille %s, valeur %.5f (devise du compte)",
DoubleToString(MarketInfo(s, MODE_TICKSIZE), digits),
MarketInfo(s, MODE_TICKVALUE));
PrintFormat("Taille du contrat %.0f, marge requise pour 1 lot %.2f",
MarketInfo(s, MODE_LOTSIZE), MarketInfo(s, MODE_MARGINREQUIRED));
PrintFormat("Swap achat %.2f, swap vente %.2f",
MarketInfo(s, MODE_SWAPLONG), MarketInfo(s, MODE_SWAPSHORT));
PrintFormat("Trading autorisé : %s",
(MarketInfo(s, MODE_TRADEALLOWED) != 0) ? "oui" : "non");
}
La directive #property script_show_inputs affiche la fenêtre de paramètres au lancement, ce qui permet de saisir un autre symbole que celui du graphique. SymbolSelect(s, true) ajoute le symbole à la fenêtre Market Watch si nécessaire : un symbole absent de cette liste peut renvoyer des valeurs nulles.
Les usages dans un EA
- Calcul du volume selon le risque :
MODE_TICKVALUE,MODE_TICKSIZE,MODE_MINLOT,MODE_LOTSTEP,MODE_MAXLOT. La formule est détaillée dans Taille de lot selon le risque. - Validation des stops :
MODE_STOPLEVELetMODE_FREEZELEVEL, dont les règles d’application sont décrites dans StopLevel et FreezeLevel. - Filtre de spread :
MODE_SPREADcompare le spread courant à un maximum toléré. - EA multi-symboles :
MODE_BID,MODE_ASK,MODE_POINTetMODE_DIGITSremplacent les variables prédéfiniesBid,Ask,PointetDigits, qui ne valent que pour le graphique courant (voir Variables prédéfinies). - Filtre de swap :
MODE_SWAPLONGetMODE_SWAPSHORTpour éviter de conserver une position la nuit quand le swap est fortement négatif.
Exemple d’utilisation : un filtre d’entrée complet
Dans un EA, MarketInfo() intervient surtout au moment de décider si l’entrée est possible. Une fonction de contrôle typique enchaîne quatre vérifications, chacune reposant sur une constante différente. D’abord, MODE_TRADEALLOWED doit être non nul : un symbole peut être visible dans Market Watch tout en étant fermé au trading, par exemple hors des horaires de cotation d’un indice. Ensuite, MODE_SPREAD doit rester sous le maximum fixé en paramètre, pour éviter d’entrer pendant un élargissement passager. Puis la distance de votre stop doit dépasser MODE_STOPLEVEL, faute de quoi l’ordre sera refusé. Enfin, le volume calculé doit être compris entre MODE_MINLOT et MODE_MAXLOT et être un multiple de MODE_LOTSTEP.
Regrouper ces contrôles dans une seule fonction, appelée juste avant OrderSend(), présente deux avantages. Le code d’entrée reste lisible, et chaque refus peut être journalisé avec sa cause précise : « spread trop large », « stop trop court », « volume sous le minimum ». Au lieu d’un refus du serveur à décoder, vous obtenez une explication immédiate dans l’onglet Experts. Sur un EA multi-symboles, la même fonction s’applique à chaque symbole en lui passant son nom, sans dépendre des variables prédéfinies du graphique.
Un dernier conseil : conservez dans le journal, au démarrage de l’EA, une ligne récapitulant ces propriétés pour le symbole tradé. En cas de comportement différent entre deux courtiers ou entre démonstration et réel, la comparaison de ces lignes suffit souvent à trouver l’explication, comme un pas de volume de 0.1 au lieu de 0.01 ou un stop level beaucoup plus élevé.
MarketInfo ou SymbolInfo ?
Le MQL4 moderne dispose aussi des fonctions SymbolInfoDouble(), SymbolInfoInteger() et SymbolInfoString(), héritées du MQL5. Elles donnent accès à des propriétés absentes de MarketInfo(), comme le mode d’exécution du symbole (SYMBOL_TRADE_EXEMODE), et renvoient des valeurs typées. Les deux familles coexistent sans problème. Pour un code destiné à être porté vers MQL5, privilégier SymbolInfo...() dès maintenant réduit le travail de conversion, puisque MarketInfo() n’existe pas en MQL5.
| MarketInfo | Équivalent SymbolInfo |
|---|---|
MODE_BID | SymbolInfoDouble(s, SYMBOL_BID) |
MODE_STOPLEVEL | SymbolInfoInteger(s, SYMBOL_TRADE_STOPS_LEVEL) |
MODE_FREEZELEVEL | SymbolInfoInteger(s, SYMBOL_TRADE_FREEZE_LEVEL) |
MODE_MINLOT | SymbolInfoDouble(s, SYMBOL_VOLUME_MIN) |
MODE_LOTSTEP | SymbolInfoDouble(s, SYMBOL_VOLUME_STEP) |
MODE_TICKVALUE | SymbolInfoDouble(s, SYMBOL_TRADE_TICK_VALUE) |
La correspondance complète figure dans MarketInfo vers SymbolInfo.
Pièges fréquents
- Oublier la conversion de type.
int sl = MarketInfo(s, MODE_STOPLEVEL);produit un avertissement de conversion ; écrivez(int)MarketInfo(...). - Interroger un symbole mal nommé. Avec un suffixe chez le courtier (« EURUSD.r »),
MarketInfo("EURUSD", ...)renvoie 0 etGetLastError()signale un symbole inconnu. Lisez le nom exact dans Market Watch ou passez-le en paramètre. - Calculer une seule fois dans OnInit. Le spread, le stop level et la valeur du tick peuvent changer en cours de séance. Relisez-les au moment de l’utilisation.
- Faire confiance aveuglément au testeur. Dans le testeur, certaines valeurs (spread, valeur du tick sur les symboles croisés) proviennent des réglages du test et peuvent différer du réel.
- Prendre
MODE_SPREADpour une moyenne. C’est le spread courant, qui varie à chaque tick.
Les propriétés qui changent en cours de séance
Toutes les valeurs renvoyées par MarketInfo() ne sont pas figées. Les prix, le spread et l’heure de la dernière cotation évoluent à chaque tick ; la valeur du tick suit le taux de change lorsque la devise de profit du symbole diffère de celle du compte ; le stop level et le freeze level peuvent être relevés par le courtier en période agitée ; les swaps sont révisés périodiquement. À l’inverse, le nombre de décimales, la taille du contrat et les bornes de volume changent rarement. La règle pratique qui en découle : lisez au moment de l’utilisation toutes les propriétés de la première catégorie, et n’hésitez pas à relire aussi les autres plutôt que de les figer dans OnInit(), l’appel étant peu coûteux.
FAQ
Comment obtenir le spread d’un symbole en MQL4 ?
MarketInfo(symbole, MODE_SPREAD) renvoie le spread courant en points. Pour le graphique courant, (Ask - Bid) / Point donne le même résultat.
Pourquoi MarketInfo renvoie-t-il 0 ?
Le plus souvent, le nom du symbole est incorrect ou le symbole n’est pas présent dans Market Watch. Vérifiez le nom exact, appelez SymbolSelect(symbole, true) puis réessayez.
MarketInfo existe-t-il en MQL5 ?
Non. En MQL5, on utilise SymbolInfoDouble(), SymbolInfoInteger() et SymbolInfoString(), qui existent aussi en MQL4.
Que signifie MODE_STOPLEVEL égal à 0 ?
Selon la documentation d’OrderSend(), soit le courtier n’impose pas de distance minimale, soit il contrôle les niveaux de façon dynamique ; dans ce second cas, un refus pour stops invalides reste possible.
