MQL4 · Bases
Variables prédéfinies MQL4 : Bid, Ask, Point, Digits et Bars
Bid, Ask, Point, Digits, Bars, _Symbol : ce que contient chaque variable prédéfinie du MQL4, pourquoi elle ne vaut que pour le graphique courant et comment convertir points et pips.
En MQL4, les variables prédéfinies sont des variables fournies par le terminal que vous lisez sans les déclarer : Bid et Ask (derniers prix connus du symbole du graphique), Point (valeur d’un point de cotation), Digits (nombre de décimales), Bars (nombre de bougies du graphique), ainsi que leurs variantes préfixées _Symbol, _Period, _Point, _Digits et _LastError. Elles sont mises à jour par le terminal au début de chaque appel de votre programme et décrivent uniquement le symbole et l’unité de temps du graphique sur lequel l’EA est attaché.
Cette page passe en revue chaque variable, explique quand sa valeur devient obsolète et montre comment convertir proprement points et pips. Elle appartient à la rubrique Les bases du MQL4.
La liste des variables prédéfinies
| Variable | Type | Contenu |
|---|---|---|
Bid | double | Dernier prix acheteur connu du symbole courant (prix de vente pour vous) |
Ask | double | Dernier prix vendeur connu du symbole courant (prix d’achat pour vous) |
Point, _Point | double | Taille d’un point du symbole courant dans la devise de cotation |
Digits, _Digits | int | Nombre de décimales du prix du symbole courant |
Bars | int | Nombre de bougies présentes sur le graphique courant |
_Symbol | string | Nom du symbole du graphique |
_Period | int | Unité de temps du graphique, en minutes |
_LastError | int | Code de la dernière erreur, celui que renvoie GetLastError() |
_StopFlag | bool | Indique qu’une demande d’arrêt du programme a été reçue |
_UninitReason | int | Code de la raison de désinitialisation |
_RandomSeed | int | État courant du générateur de nombres pseudo-aléatoires |
Open[], High[], Low[], Close[], Time[], Volume[] | tableaux | Historique des bougies du graphique |
Les tableaux de séries sont traités dans une page dédiée, [Tableaux de séries (Close[], Time[])](/mql4/bases/tableaux-de-series/). Ici, nous nous concentrons sur les variables simples.
Les fonctions Symbol(), Period() et IsStopped() renvoient respectivement les mêmes informations que _Symbol, _Period et _StopFlag. Utilisez la forme que vous préférez, mais restez cohérent dans un même projet.
Bid et Ask : quel prix pour quelle opération
La règle découle de la façon dont le courtier cote : vous achetez au prix Ask et vendez au prix Bid. Une position acheteuse s’ouvre donc à Ask et se ferme à Bid ; une position vendeuse s’ouvre à Bid et se ferme à Ask. L’écart entre les deux est le spread, que vous pouvez calculer avec (Ask - Bid) / Point pour l’obtenir en points.
Conséquence directe pour les stops : le stop loss d’un achat est déclenché par le Bid, celui d’une vente par le Ask. Un stop loss de vente placé trop près du prix peut donc être touché par un simple élargissement du spread, sans que le graphique (tracé en Bid) ne montre le moindre mouvement.
Point, Digits et la question des pips
Point est le plus petit incrément de prix du symbole : 0.00001 sur un EURUSD coté avec 5 décimales, 0.001 sur un USDJPY à 3 décimales, souvent 0.01 sur l’or. Digits donne le nombre de décimales correspondant.
Le piège classique tient au mot « pip ». Historiquement, les paires majeures étaient cotées à 4 décimales (2 pour les paires en yen) et un pip valait un point. Aujourd’hui, la plupart des courtiers cotent avec une décimale supplémentaire : un pip vaut alors 10 points. Un EA qui exprime ses distances en pips doit faire la conversion, sinon un stop prévu à 30 pips se retrouve à 30 points, soit 3 pips.
//+------------------------------------------------------------------+
//| AfficherInfosSymbole.mq4 : script de lecture des variables |
//+------------------------------------------------------------------+
#property strict
void OnStart()
{
// taille d'un pip : 10 points sur les cotations à 3 ou 5 décimales
double pip = (Digits == 3 || Digits == 5) ? Point * 10 : Point;
double spreadPoints = (Ask - Bid) / Point;
PrintFormat("Symbole %s, unité de temps %d min", _Symbol, _Period);
PrintFormat("Bid %s Ask %s", DoubleToString(Bid, Digits), DoubleToString(Ask, Digits));
PrintFormat("Point %s, Digits %d, pip %s", DoubleToString(Point, Digits), Digits, DoubleToString(pip, Digits));
PrintFormat("Spread : %.0f points, soit %.1f pips", spreadPoints, (Ask - Bid) / pip);
PrintFormat("Bougies sur le graphique : %d", Bars);
}
La règle « 3 ou 5 décimales » fonctionne pour les paires de devises. Pour les métaux, les indices ou les cryptomonnaies, la notion de pip n’a pas de définition universelle : raisonnez directement en points, ou en prix, et documentez vos paramètres en conséquence.
Une photographie prise au début de l’exécution
Les variables prédéfinies ne changent pas pendant que votre fonction s’exécute. Le terminal les met à jour avant d’appeler OnTick(), puis votre code travaille sur cette photographie. Tant que la fonction est rapide, la différence avec le marché est négligeable. Elle devient gênante dans deux situations :
- après une attente, par exemple un
Sleep()dans une boucle de nouvelles tentatives après un échec d’envoi d’ordre ; - après un calcul long, quand l’EA parcourt un historique important ou de nombreux ordres.
Dans ces cas, les prix stockés dans Bid et Ask sont périmés et un ordre envoyé avec eux sera refusé (prix invalide ou requote). La fonction RefreshRates recharge ces valeurs ; elle a sa propre page car son usage obéit à des règles précises.
Le piège du symbole courant
Bid, Ask, Point et Digits décrivent le symbole du graphique, jamais un autre. Un EA attaché à EURUSD qui veut ouvrir un ordre sur GBPUSD ne doit pas utiliser Ask : il enverrait le prix de l’EURUSD. Pour un autre symbole, on passe par MarketInfo() ou SymbolInfoDouble() :
string sym = "GBPUSD";
double ask = MarketInfo(sym, MODE_ASK); // prix d'achat du GBPUSD
double point = MarketInfo(sym, MODE_POINT); // point du GBPUSD
int dig = (int)MarketInfo(sym, MODE_DIGITS); // décimales du GBPUSD
double bid = SymbolInfoDouble(sym, SYMBOL_BID); // forme équivalente
La page MarketInfo détaille toutes les propriétés accessibles de cette façon (stop level, valeur du tick, volumes minimum et maximum).
Pièges pratiques et bonnes habitudes
- Normaliser les prix calculés. Un prix obtenu par addition (
Ask + 200 * Point) peut porter des décimales parasites. Passez-le dansNormalizeDouble(prix, Digits)avant de l’envoyer au serveur. - Comparer des doubles avec prudence.
Bid == prixCibleest presque toujours faux à cause de la représentation binaire. Comparez un écart à une demi-valeur de point. - Ne pas recopier les prix dans des globales. Une variable globale initialisée avec
Bidfige un prix du chargement. LisezBidetAskau moment où vous en avez besoin. - Vérifier
Barsavant de lire l’historique. Juste après l’ouverture d’un graphique, l’historique peut être court ; lireClose[200]avec 150 bougies provoque un dépassement de tableau. - Tester
IsStopped()dans les boucles longues. Lorsque l’utilisateur retire l’EA,_StopFlagpasse à vrai : une boucle qui l’ignore retarde l’arrêt du programme.
Cas d’usage : un filtre de spread avant l’entrée
Les variables prédéfinies suffisent à écrire l’un des filtres les plus utiles d’un robot : refuser d’entrer quand le spread est anormalement large. Autour des annonces économiques, à l’ouverture de la session asiatique ou en fin de semaine, l’écart entre Bid et Ask peut être multiplié par cinq ou dix. Un EA qui ignore ce paramètre ouvre alors des positions qui démarrent avec un handicap important et dont le stop loss, mesuré depuis le mauvais prix, est plus proche qu’attendu.
La mise en œuvre tient en trois lignes : calculer (Ask - Bid) / Point, comparer le résultat à un paramètre d’entrée InpSpreadMax exprimé en points, et sortir de la fonction si la limite est dépassée. Affichez la valeur refusée dans le journal avec Print() : vous saurez ainsi, après coup, combien de signaux le filtre a écartés et à quelles heures. Fixez la limite après avoir observé le spread habituel de votre courtier sur le symbole, pas avec une valeur copiée d’un autre compte : selon le type de compte et l’instrument, le spread normal varie fortement.
Et en MQL5 ?
MQL5 ne possède ni Bid ni Ask prédéfinis. On lit les prix avec SymbolInfoDouble(_Symbol, SYMBOL_BID) ou avec SymbolInfoTick(), qui remplit une structure MqlTick en un seul appel. _Point, _Digits, _Symbol et _Period existent en revanche sous le même nom, ce qui explique pourquoi beaucoup de développeurs utilisent les formes préfixées dès le MQL4 pour faciliter un portage futur. La rubrique Migration de MQL4 vers MQL5 recense ces correspondances.
FAQ
Pourquoi Bid et Ask ne changent-ils pas dans ma boucle ?
Parce qu’ils sont figés au début de l’exécution de la fonction. Pour obtenir les dernières cotations sans attendre le tick suivant, appelez RefreshRates(), puis relisez Bid et Ask.
Point et _Point sont-ils différents ?
Non, ils renvoient la même valeur. La forme préfixée _Point a l’avantage d’exister aussi en MQL5, tout comme _Digits et _Symbol.
Comment savoir si mon courtier cote en 4 ou 5 décimales ?
Lisez Digits. Une valeur de 5 (ou 3 pour les paires en yen) indique une cotation avec décimale supplémentaire, où un pip vaut 10 points. Le script ci-dessus l’affiche directement dans le journal.
Peut-on utiliser Ask dans un indicateur ?
Oui, les variables prédéfinies sont accessibles dans les indicateurs, scripts et EA. Dans un indicateur, gardez à l’esprit que l’historique se calcule avec les prix des bougies, pas avec le Ask courant.
