MQL5 · Bases du langage
AccountInfoDouble en MQL5 : lire solde, équité, marge et type de compte
Lire solde, équité, marge, levier, type de compte et mode netting ou hedging avec AccountInfoDouble, AccountInfoInteger et AccountInfoString, et s’en servir pour protéger un Expert Advisor.
Les informations du compte de trading se lisent avec trois fonctions : AccountInfoDouble() pour les montants (solde, équité, profit flottant, marge utilisée, marge libre, niveau de marge), AccountInfoInteger() pour les entiers et booléens (numéro de compte, levier, type de compte, autorisations de trading, mode de marge) et AccountInfoString() pour les textes (devise, serveur, société, nom du titulaire). La signature documentée de la première est double AccountInfoDouble(ENUM_ACCOUNT_INFO_DOUBLE property_id). Ces lectures sont la base de toute gestion du risque intégrée à un Expert Advisor : dimensionner les positions, surveiller le drawdown, refuser de trader sur un compte réel par erreur ou adapter la logique au mode netting ou hedging.
Cette page fait partie de la rubrique Les bases du langage MQL5. Les propriétés des instruments se lisent de façon analogue avec SymbolInfoDouble et SymbolInfoInteger.
Les montants : AccountInfoDouble
| Identifiant | Contenu selon la documentation |
|---|---|
| ACCOUNT_BALANCE | Solde, en devise du compte |
| ACCOUNT_EQUITY | Équité (solde plus résultat latent), en devise du compte |
| ACCOUNT_PROFIT | Profit flottant courant |
| ACCOUNT_CREDIT | Crédit accordé |
| ACCOUNT_MARGIN | Marge utilisée |
| ACCOUNT_MARGIN_FREE | Marge libre |
| ACCOUNT_MARGIN_LEVEL | Niveau de marge, en pourcentage |
| ACCOUNT_MARGIN_SO_CALL | Seuil d’appel de marge, en pourcentage ou en montant selon le mode |
| ACCOUNT_MARGIN_SO_SO | Seuil de stop out, en pourcentage ou en montant selon le mode |
| ACCOUNT_MARGIN_INITIAL | Marge initiale réservée pour couvrir les ordres en attente |
| ACCOUNT_MARGIN_MAINTENANCE | Fonds minimaux réservés pour couvrir les positions ouvertes |
| ACCOUNT_COMMISSION_BLOCKED | Commissions actuellement bloquées |
La distinction entre solde et équité est centrale. Le solde ne bouge qu’à la clôture des positions ; l’équité intègre le résultat latent des positions ouvertes. Une protection fondée sur le solde ne voit pas une position qui perd 15 % tant qu’elle n’est pas fermée. Les coupe-circuits de drawdown doivent donc s’appuyer sur l’équité.
Les entiers et booléens : AccountInfoInteger
| Identifiant | Contenu |
|---|---|
| ACCOUNT_LOGIN | Numéro du compte (long) |
| ACCOUNT_TRADE_MODE | Type de compte : démo, concours ou réel |
| ACCOUNT_LEVERAGE | Levier du compte |
| ACCOUNT_LIMIT_ORDERS | Nombre maximal d’ordres en attente autorisés |
| ACCOUNT_MARGIN_SO_MODE | Unité des seuils : pourcentage ou montant |
| ACCOUNT_TRADE_ALLOWED | Trading autorisé sur le compte |
| ACCOUNT_TRADE_EXPERT | Trading autorisé pour les Expert Advisors |
| ACCOUNT_MARGIN_MODE | Mode de calcul de la marge |
| ACCOUNT_CURRENCY_DIGITS | Décimales de la devise du compte |
| ACCOUNT_HEDGE_ALLOWED | Positions opposées autorisées sur un même symbole |
AccountInfoInteger() renvoie un long ; pour une propriété énumérée, une conversion explicite est nécessaire, comme le fait l’exemple de la documentation : (ENUM_ACCOUNT_TRADE_MODE)AccountInfoInteger(ACCOUNT_TRADE_MODE).
Trois énumérations sont associées. ENUM_ACCOUNT_TRADE_MODE contient ACCOUNT_TRADE_MODE_DEMO, ACCOUNT_TRADE_MODE_CONTEST et ACCOUNT_TRADE_MODE_REAL. ENUM_ACCOUNT_MARGIN_MODE contient ACCOUNT_MARGIN_MODE_RETAIL_NETTING (une seule position par symbole), ACCOUNT_MARGIN_MODE_EXCHANGE (marchés boursiers) et ACCOUNT_MARGIN_MODE_RETAIL_HEDGING (plusieurs positions par symbole). ENUM_ACCOUNT_STOPOUT_MODE indique si les seuils sont exprimés en pourcentage (ACCOUNT_STOPOUT_MODE_PERCENT) ou en montant (ACCOUNT_STOPOUT_MODE_MONEY).
Le mode de marge change profondément la logique d’un EA : en netting, un nouvel achat sur un symbole déjà acheté augmente la position existante au lieu d’en créer une seconde. Le sujet est développé dans Comptes netting ou hedging.
Les textes : AccountInfoString
ACCOUNT_CURRENCY donne la devise du compte, indispensable pour afficher les montants et interpréter la valeur du tick. ACCOUNT_SERVER donne le nom du serveur, ACCOUNT_COMPANY la société qui gère le compte et ACCOUNT_NAME le nom du titulaire.
Exemple complet : contrôles de compte et coupe-circuit sur l’équité
//+------------------------------------------------------------------+
//| EA : controles du compte et arret si l'equite chute trop |
//+------------------------------------------------------------------+
input bool InpAutoriserReel = false; // Autoriser le fonctionnement sur compte reel
input double InpPerteMaxJourPct = 3.0; // Perte maximale du jour (% de l'equite de depart)
input double InpNiveauMargeMin = 300.0; // Niveau de marge minimal pour ouvrir (%)
double g_equiteDebutJour = 0.0;
datetime g_jourCourant = 0;
int OnInit()
{
ENUM_ACCOUNT_TRADE_MODE type = (ENUM_ACCOUNT_TRADE_MODE)AccountInfoInteger(ACCOUNT_TRADE_MODE);
if(type == ACCOUNT_TRADE_MODE_REAL && !InpAutoriserReel)
{
Print("Compte reel detecte : fonctionnement refuse (parametre InpAutoriserReel)");
return(INIT_FAILED);
}
if(!AccountInfoInteger(ACCOUNT_TRADE_ALLOWED) || !AccountInfoInteger(ACCOUNT_TRADE_EXPERT))
Print("Attention : le trading automatique n'est pas autorise sur ce compte");
ENUM_ACCOUNT_MARGIN_MODE marge = (ENUM_ACCOUNT_MARGIN_MODE)AccountInfoInteger(ACCOUNT_MARGIN_MODE);
PrintFormat("Compte %I64d chez %s (%s) | devise %s | levier 1:%I64d | %s",
AccountInfoInteger(ACCOUNT_LOGIN), AccountInfoString(ACCOUNT_COMPANY),
AccountInfoString(ACCOUNT_SERVER), AccountInfoString(ACCOUNT_CURRENCY),
AccountInfoInteger(ACCOUNT_LEVERAGE), EnumToString(marge));
return(INIT_SUCCEEDED);
}
//--- true si l'EA a le droit d'ouvrir une nouvelle position
bool OuvertureAutorisee()
{
// Nouvelle journee serveur : on memorise l'equite de depart
datetime jour = TimeCurrent() - (TimeCurrent() % 86400);
if(jour != g_jourCourant)
{
g_jourCourant = jour;
g_equiteDebutJour = AccountInfoDouble(ACCOUNT_EQUITY);
}
double equite = AccountInfoDouble(ACCOUNT_EQUITY);
if(g_equiteDebutJour > 0.0)
{
double pertePct = (g_equiteDebutJour - equite) / g_equiteDebutJour * 100.0;
if(pertePct >= InpPerteMaxJourPct)
return(false); // limite journaliere atteinte
}
// Niveau de marge : 0 lorsqu'aucune marge n'est utilisee
double niveau = AccountInfoDouble(ACCOUNT_MARGIN_LEVEL);
if(AccountInfoDouble(ACCOUNT_MARGIN) > 0.0 && niveau < InpNiveauMargeMin)
return(false);
return(true);
}
void OnTick()
{
if(!OuvertureAutorisee())
return;
// ... signal et ouverture de position
}
Ce squelette illustre trois usages typiques : un garde-fou qui empêche de lancer par erreur l’EA sur un compte réel, l’affichage d’une fiche du compte au démarrage, et une limite de perte journalière fondée sur l’équité. Dans un robot réel, l’équité de départ devrait être persistée (variable globale du terminal ou fichier), car une réinitialisation de l’EA en cours de journée la recalculerait. Cette amélioration est traitée dans Limite de perte journalière.
Vérifier la marge avant d’ouvrir
La marge libre (ACCOUNT_MARGIN_FREE) indique combien de fonds restent disponibles, mais pas combien une nouvelle position va en consommer. Pour le savoir, MQL5 fournit OrderCalcMargin(), qui calcule la marge requise pour un type d’ordre, un symbole, un volume et un prix donnés, et renvoie le résultat dans un paramètre par référence. Comparer cette marge requise à la marge libre avant l’envoi évite un refus pour fonds insuffisants, décrit dans 10019 Fonds insuffisants. Une marge de sécurité est recommandée : ouvrir une position qui consomme presque toute la marge libre rapproche dangereusement le compte du seuil d’appel de marge au moindre mouvement défavorable.
Le compte dans le Strategy Tester
En backtest, les fonctions de compte renvoient les valeurs d’un compte simulé : le dépôt initial, la devise et le levier sont ceux choisis dans les réglages du testeur, et le solde comme l’équité évoluent au fil des transactions simulées. Les contrôles fondés sur le type de compte (démo ou réel) ou sur le nom du serveur sont donc à tester aussi en démonstration. Pensez également à tester votre logique avec plusieurs niveaux de dépôt : un calcul de lot correct pour 10 000 unités peut produire un volume inférieur au minimum du symbole pour 500.
Cas d’usage en trading
- Dimensionnement des positions : le risque par trade s’exprime en pourcentage du solde ou de l’équité, converti ensuite en lot avec la valeur du tick du symbole. Le principe est exposé dans Risque par trade.
- Coupe-circuit de drawdown : arrêt des ouvertures, voire fermeture des positions, si l’équité passe sous un seuil.
- Contrôle de la marge : refuser une ouverture si la marge libre est insuffisante ou si le niveau de marge descend trop près du seuil d’appel de marge.
- Adaptation au mode de compte : logique différente en netting et en hedging, avertissement sur compte réel.
- Journalisation : numéro de compte, serveur et devise en tête du journal facilitent l’analyse a posteriori.
Pièges fréquents
- Surveiller le solde au lieu de l’équité : les pertes latentes passent inaperçues.
- Confondre devise du compte et devise du symbole : les montants renvoyés par
AccountInfoDouble()sont dans la devise du compte. - Lire ACCOUNT_MARGIN_LEVEL sans position : sans marge utilisée, la valeur n’est pas significative ; testez d’abord
ACCOUNT_MARGIN. - Ignorer l’unité des seuils :
ACCOUNT_MARGIN_SO_CALLetACCOUNT_MARGIN_SO_SOsont en pourcentage ou en montant selonACCOUNT_MARGIN_SO_MODE. - Supposer un mode de compte : un EA écrit pour le hedging peut se comporter de manière inattendue sur un compte netting.
FAQ
Quelle différence entre ACCOUNT_BALANCE et ACCOUNT_EQUITY ?
Le solde (ACCOUNT_BALANCE) ne change qu’à la clôture des positions. L’équité (ACCOUNT_EQUITY) inclut le résultat latent des positions ouvertes. Pour surveiller un drawdown en temps réel, utilisez l’équité.
Comment savoir si l’EA tourne sur un compte réel ?
Lisez AccountInfoInteger(ACCOUNT_TRADE_MODE) et comparez la valeur convertie en ENUM_ACCOUNT_TRADE_MODE à ACCOUNT_TRADE_MODE_REAL. Vous pouvez ainsi refuser l’initialisation tant qu’un paramètre ne l’autorise pas explicitement.
Comment savoir si le compte est en netting ou en hedging ?
Lisez AccountInfoInteger(ACCOUNT_MARGIN_MODE) : ACCOUNT_MARGIN_MODE_RETAIL_NETTING signifie une seule position par symbole, ACCOUNT_MARGIN_MODE_RETAIL_HEDGING autorise plusieurs positions, y compris opposées.
Dans quelle devise sont exprimés les montants ?
Dans la devise du compte, que renvoie AccountInfoString(ACCOUNT_CURRENCY). Le nombre de décimales à utiliser pour l’affichage est donné par ACCOUNT_CURRENCY_DIGITS.
- Types de données en MQL5
- Variables, constantes et portée
- Paramètres input et sinput
- Opérateurs et expressions
- Conditions if, else et switch
- Boucles for, while et do while
- Écrire ses propres fonctions
- Tableaux statiques et dynamiques
- ArraySetAsSeries et indexation des séries
- Manipuler les chaînes de caractères
- Dates, heures et fuseaux
- Structures (struct) et MqlRates, MqlTick
- Énumérations (enum) personnalisées
- #include, #define et #property
- Les fonctions événementielles
- Print, Comment, Alert : déboguer avec le journal
- NormalizeDouble et précision des prix
- SymbolInfoDouble, SymbolInfoInteger
- Bien utiliser MetaEditor
