Voir comment télécharger gratuitement des robots de trading
Retrouvez-nous sur Telegram !
Rejoignez notre page de fans
Un script intéressant ?
Poster un lien vers celui-ci -
laisser les autres l'évaluer
Vous avez aimé le script ? Essayez-le dans le terminal MetaTrader 5
Indicateurs

Symbol Spec Auditor - indicateur pour MetaTrader 5

Quoc Dat Quach
Quoc Dat Quach
Software engineer with 8 years in fintech and mobile, writing MQL4/MQL5 since 2017. I build Expert Advisors, indicators, trade and risk-management panels and utilities for MT4/MT5, and I trade forex and gold on MT5 myself.
| French English Русский 中文 Español Deutsch 日本語 Português 한국어 Italiano Türkçe
Vues:
46
Note:
(1)
Publié:
MQL5 Freelance Besoin d'un robot ou d'un indicateur basé sur ce code ? Commandez-le sur Freelance Aller sur Freelance

Symbol Spec Auditor affiche, dans un panneau du graphique, les éléments des spécifications contractuelles d'un symbole qui déterminent la taille de la position et le coût de la transaction : valeur du point, coût du spread, marge, swap, règles d'exécution et sessions. Les valeurs sont converties en montant par lot de 1,00 dans la devise du compte, et les paramètres du courtier qui enfreignent implicitement les règles relatives à la taille des lots sont signalés sous forme d’avertissements. Un simple clic permet d’exporter vers un fichier CSV le même audit pour chaque symbole de Market Watch.

symbol-spec-auditor-xauusd

XAUUSD H1 : le panneau complet à deux colonnes pour un symbole sans pièges

Le problème

Un code qui fonctionne chez un courtier se comporte souvent de manière inattendue chez un autre en raison d’un détail de spécification que personne n’a vérifié. La fenêtre des spécifications du symbole affiche toutes ces informations, mais celles-ci sont réparties sur plusieurs onglets et exprimées en unités brutes, ce qui fait qu’il est facile de passer à côté d’une différence entre deux courtiers ou deux types de compte. Un Expert Advisor qui calcule la taille des positions à partir d’une valeur de contrat ou d’un point supposée risque alors d’engager un montant erroné sans qu’aucune erreur n’apparaisse dans le journal. Cas typiques :

  • L'or avec un contrat de 1 oz au lieu de 100 oz, ou un symbole « mini » du Forex avec 10 000 unités. Une formule de lot qui suppose que le contrat habituel est erroné de 100 ou de 10 fois.
  • Un compte en cents, où le solde, la valeur du tick et la marge sont tous exprimés en cents.
  • Un niveau de stop ou de gel qui rejette les ordres SL/TP ou les modifications proches du cours.
  • Ordres quotidiens : le courtier supprime les ordres en attente, et parfois les SL/TP, à la fin de la journée de trading.
  • Une taille de tick différente du point, de sorte que les prix hors de la grille de ticks sont rejetés.
  • Un volume minimum ou un pas de volume qui impose un arrondi, un symbole en mode « clôture uniquement », ou une journée inhabituelle à triple swap.

Cet indicateur rassemble ces valeurs en un seul endroit, les convertit en montant en euros par lot de 1,00 et répertorie ce qui mérite un examen plus approfondi, chaque avertissement étant accompagné d’une ligne décrivant la conséquence. Il s’agit uniquement d’un outil de vérification : il ne passe aucun ordre, n’utilise aucune DLL et n’écrit aucun fichier, à l’exception de l’export CSV que vous demandez. Le panneau et le fichier CSV utilisent les mêmes calculs ; vous pouvez donc comparer ce que vous voyez sur un graphique avec l’ensemble du Market Watch.

Ce qu’affiche le panneau

Le panneau décrit le symbole du graphique. Il est actualisé une fois par seconde et reconstruit lorsque vous modifiez le symbole ou la période, de sorte que le changement de symbole du graphique permet de vérifier les symboles les uns après les autres. Une valeur qui ne peut être déterminée est affichée comme « n/a » accompagnée de la raison, et une ligne dont la valeur déclenche un avertissement est affichée dans la couleur d’avertissement. Les lignes sont regroupées en sections :

  • Identité : symbole, description, chemin d’accès, mode de calcul, devise de base, devise des bénéfices et de la marge, devise du compte, effet de levier du compte et mode de marge.
  • Prix et contrat : nombre de chiffres, point, taille du tick, valeur du tick (profit et perte), taille du contrat et date d’expiration pour les symboles à échéance, tels que les contrats à terme.
  • Montant par lot de 1,00 : valeur d’un point calculée à partir de la valeur du tick, vérifiée par rapport à la taille du contrat × le point × le taux de conversion ; valeur d’une variation de prix de 1,00 ; spread actuel en points et en montant ; ATR(14) de la période du graphique et spread exprimé en pourcentage de celui-ci.
  • Volume : minimum, pas, maximum et limite.
  • Marge pour 1,00 lot : marge d’achat et de vente, taux de marge initiale, valeur notionnelle et effet de levier effectif (valeur notionnelle divisée par la marge) à côté de l’effet de levier du compte. Lorsqu’une valeur ne peut être calculée, le panneau en indique la raison, par exemple « aucune cotation », « taux de marge égal à 0 », « effet de levier du compte égal à 0 » ou « taux de conversion manquant ».
  • Swap pour 1,00 lot : mode de swap, valeurs pour les positions longues et courtes, montant par nuit dans la devise du compte (modes « points », « devise » et « intérêts ») et le jour de triple swap. Un jour autre que du dimanche au samedi est indiqué comme « non défini ».
  • Exécution : mode de trading, mode d’exécution, politiques de remplissage (FOK, IOC, BOC, Return), types d’ordres autorisés, modes d’expiration, mode GTC (durée de validité des ordres en attente et des SL/TP), ainsi que les niveaux de stop et de gel en points et en prix.
  • Sessions : sessions de trading du jour selon l’heure du serveur.

Avertissements

Le bloc « Avertissements » situé au bas du panneau répertorie les paramètres nécessitant une attention particulière, les plus graves en premier. Chaque avertissement précise la valeur concernée et sa conséquence pour le code de trading. Si aucun avertissement ne s’applique, le panneau affiche « Aucun problème détecté ». Les vérifications s’appuient sur des valeurs de référence courantes ; un avertissement n’est donc pas toujours le signe d’une erreur du courtier : il signale un paramètre que votre code doit lire dans la spécification au lieu de le supposer.

  • Taille du contrat inhabituelle pour la classe d’actifs : forex 100 000, or 100, argent 5 000.
  • La valeur du tick ou la taille du tick est égale à 0, ou bien la valeur en points dérivée de la valeur du tick et celle dérivée de la taille du contrat diffèrent de plus de 1 %.
  • Devise du compte en cents (USC, EUC et similaires).
  • Mode de trading autre que « complet » : désactivé, « long uniquement », « short uniquement » ou « clôture uniquement ».
  • Contrat arrivant à échéance, avec sa date d’échéance.
  • Pas de cours acheteur/vendeur actuel.
  • Incrément différent de la valeur du point.
  • Niveau de stop ou niveau de gel supérieur à 0.
  • Ordres quotidiens (mode GTC). L'option « Quotidien » supprime les ordres SL/TP et les ordres en attente à la fin de la journée de négociation ; l'option « Quotidien hors ordres stop » supprime les ordres en attente et conserve les ordres SL/TP.
  • Volume minimum supérieur à 0,01 ou incrément de volume supérieur à 0,01, uniquement sur les symboles Forex et CFD. Les instruments boursiers se négocient souvent par lots entiers, ils ne sont donc pas signalés.
  • Spread supérieur au pourcentage choisi de l’ATR(14) sur la période du graphique.
  • Triple swap un jour autre que le mercredi, pour le Forex et les métaux uniquement. Le jeudi est accepté pour l’USD face au CAD, à la TRY, au RUB et au PHP, qui sont réglés un jour plus tôt. Les indices, les cryptomonnaies et autres CFD font souvent l’objet d’un roulement le vendredi ; pour ceux-ci, le jour est indiqué mais n’est pas signalé.

avertissements-de-l'auditeur-de-spécifications-de-symboles

US500 M1 (CFD) : volume minimum de 0,14 lot et spread de 28 points, soit 17,6 % de l’ATR M1

Exportation CSV

Le bouton « Exporter au format CSV », ou l’option de démarrage, génère le fichier MQL5\Files\SymbolSpecAudit_<serveur>_<aaaaammjj_hhmm>.csv, avec une ligne par symbole de Market Watch. Ses 55 colonnes contiennent toutes les valeurs ci-dessus, y compris le mode GTC et la date d’expiration du contrat, ainsi qu’une colonne « Avertissements » (séparée par « | ») et une colonne « Remarques » indiquant la raison pour laquelle une valeur est manquante. Deux exportations provenant de deux courtiers ou de deux types de comptes peuvent être comparées ligne par ligne.

Le fichier est au format UTF-8 avec BOM, séparé par des virgules, avec une mise entre guillemets standard pour les champs contenant des virgules ou des guillemets. Les nombres utilisent un point comme séparateur décimal et aucun séparateur de milliers. Dans les paramètres régionaux où le séparateur de liste est un point-virgule, ouvrez le fichier via la boîte de dialogue d’importation du tableur. Le chemin d’accès complet du fichier s’affiche dans l’onglet « Experts ».

Gestion des panneaux

  • N'importe quel coin du graphique, une ou deux colonnes (par défaut : automatique) et un mode compact réservés aux avertissements.
  • Un bouton de réduction qui reste activé même en cas de changement de symbole ou de période.
  • Par défaut, les couleurs s’adaptent au graphique : un panneau clair sur un fond de graphique clair et un panneau foncé sur un fond foncé. Chaque couleur peut également être définie manuellement.
  • La mise en page est calculée à partir des métriques réelles de la police, ce qui garantit un alignement parfait avec les autres polices et sur les écrans à haute résolution (DPI). Les avertissements longs sont renvoyés à la ligne à la largeur du panneau.
  • Seules les étiquettes dont le texte ou la position a changé sont mises à jour, ce qui évite tout scintillement du panneau.
  • Au démarrage, les objets du panneau laissés sur le graphique par une instance précédente (par exemple à partir d’un modèle enregistré) sont supprimés.

spécification-des-symboles-auditeur-avertissements-uniquement

EURUSD M1, mode « avertissements uniquement » : le spread de 6 points représente 35,9 % de l’ATR M1

Données d'entrée

Entrée Valeur par défaut Description
Coin du panneau Coin supérieur gauche Coin du graphique auquel le panneau est ancré.
Décalage X (en pixels avec un facteur d'échelle de l'écran de 100 %) 10 Distance horizontale par rapport au coin. Mise à l'échelle automatique sur les écrans à haute résolution (DPI).
Décalage Y (en pixels, avec un redimensionnement de l'écran à 100 %) 30 Distance verticale par rapport au coin. Mise à l'échelle automatique sur les écrans à haute résolution (DPI).
Mise en page Auto Le mode « Auto » utilise une colonne lorsque le panneau s'adapte à la hauteur du graphique, sinon deux colonnes. Les options « Une colonne » et « Deux colonnes » forcent la mise en page.
Nom de la police Consolas Une police à espacement fixe permet de garder les colonnes bien ordonnées ; n'importe quelle police installée convient.
Taille de police 9 De 4 à 24 ; les autres valeurs sont limitées à cette plage.
Afficher uniquement les avertissements false Panneau compact comprenant le titre, les avertissements et le bouton « Exporter au format CSV ».
Texte (Aucun = automatique) Aucun Couleur du texte. L'option « Aucun » utilise la couleur d'arrière-plan du graphique.
En-têtes (Aucun = automatique) Aucun Couleur des titres de section.
Avertissements (Aucun = automatique) Aucun Couleur des avertissements et des lignes situées derrière eux.
OK / pas de pièges (Aucun = automatique) Aucun Couleur de la ligne « Aucun piège détecté ».
Arrière-plan (Aucun = automatique) Aucun Arrière-plan du panneau. Les libellés des touches, les bordures et les boutons sont créés par fusion des couleurs du texte et de l'arrière-plan.
Avertir si l'écart dépasse % de l'ATR(14) (0 = désactivé) 15,0 Seuil de déclenchement de l'alerte de spread. La valeur 0 désactive l'alerte.
Exporter tous les symboles de Market Watch au format CSV au démarrage false Enregistre le fichier CSV une seule fois au démarrage de l'indicateur, et non à chaque changement de symbole ou de période.

Mode d'emploi

  1. Ajoutez l'indicateur à n'importe quel graphique. Il ne trace aucune courbe et peut fonctionner en parallèle d'un Expert Advisor.
  2. Lisez d'abord la section « Avertissements » ; les lignes situées au-dessus contiennent les numéros correspondant à chaque avertissement.
  3. Changez de symbole sur le graphique pour analyser d'autres symboles, ou cliquez sur « Exporter au format CSV » pour analyser tous les symboles de la fenêtre « Market Watch » en une seule fois.
  4. Utilisez le bouton « - » pour réduire le panneau à sa barre de titre.

Une utilisation courante consiste à lancer l’exportation sur un nouveau courtier ou un nouveau type de compte avant d’y transférer un Expert Advisor, puis à comparer les tailles de contrat, les valeurs de tick, les paliers de volume, les niveaux de stop, les modes GTC et les jours de swap avec le compte sur lequel l’Expert Advisor a été développé. Ce sont les différences dans ces colonnes qui modifient le plus souvent le risque par transaction ou le coût d’une stratégie sans qu’aucune erreur visible ne soit détectée.

Remarques et limitations

  • La marge et la vérification croisée de la valeur par point utilisent des formules. MetaTrader 5 n’autorise pas les indicateurs à appeler OrderCalcMargin ou OrderCalcProfit (ces appels échouent avec l’erreur 4014), c’est pourquoi l’indicateur applique les formules fournies par la documentation MQL5 pour chaque mode de calcul : une marge initiale fixe lorsque le courtier en définit une, le taux de marge initiale issu de SymbolInfoMarginRate, et la conversion dans la devise du compte au cours vendeur pour les achats et au cours acheteur pour les ventes. Sur les symboles Forex, Forex sans effet de levier, CFD et CFD avec effet de levier, les résultats correspondaient à ceux d’OrderCalcMargin, appelé depuis un Expert Advisor aux mêmes cours, à un cent près (arrondi).
  • La marge est indiquée comme « n/a » pour les symboles d’obligations et de garanties, pour les contrats à terme sans marge initiale, ainsi que pour les symboles d’indices CFD dont les devises diffèrent de celle du compte. Les paliers de marge dépendants du volume et les règles appliquées uniquement sur le serveur de trading ne sont pas pris en compte.
  • Pour les contrats à terme et les obligations, la valeur du tick du courtier correspond à la spécification ; la vérification croisée de la valeur du point est donc indiquée comme « n/a » dans ces cas-là.
  • Le calcul du swap pour les modes d’intérêt utilise le montant notionnel et une année de 360 jours. Pour les modes de réouverture, il n’existe pas de montant fixe ; la valeur affichée est donc « n/a ».
  • La conversion de devises utilise uniquement les symboles de Market Watch disposant de cotations en temps réel, directement ou via l’USD. En l’absence de cotation, les montants concernés s’affichent comme « n/a » ou le montant notionnel est affiché sans conversion. Ajoutez la paire de conversion à Market Watch pour les remplir.
  • MetaTrader 5 ajoute un symbole de conversion à Market Watch lorsque la valeur du tick d’un symbole dont la devise de profit est étrangère est lue. L’indicateur lit donc la valeur du tick uniquement lorsqu’un symbole coté dans Market Watch relie déjà la devise des bénéfices et la devise du compte, et il n’énumère jamais les symboles en dehors de Market Watch ; sinon, la valeur du tick s’affiche comme « n/a » avec la paire manquante, par exemple « aucun symbole KRW/USD coté dans Market Watch ». Lors des tests, aucun symbole n’a jamais été ajouté. Le terminal choisit toutefois son propre symbole de conversion ; ainsi, chez un courtier dont le symbole de conversion porte un nom différent de celui figurant dans « Market Watch », un symbole peut tout de même être ajouté.
  • Les comptes en cents sont reconnus par le code de devise du compte (USC, EUC, GBC et similaires) et convertis en 1/100e de la devise principale, soit 1 USD = 100 USC. Ce chemin a été vérifié avec une devise de compte simulée, et non sur un véritable compte en cents. Un compte en cents dont la devise est déclarée comme étant l’USD n’est pas détecté par cette vérification.
  • Les tailles de contrat habituelles et les jours de triple swap sont des valeurs de référence. Un courtier peut légitimement utiliser d’autres tailles (symboles micro ou en cents) ou un autre jour de rollover ; l’avertissement est là pour que votre code lise la spécification au lieu de la supposer.
  • L’ATR correspond à l’ATR(14) de la dernière barre clôturée de la période du graphique. Pour les autres symboles du fichier CSV, il est calculé à partir de l’historique de leurs barres ; juste après le démarrage, cet historique peut encore être en cours de chargement, auquel cas la colonne « Notes » l’indique et une deuxième exportation le complète.
  • Le panneau est actualisé par un temporisateur d’une seconde, et non à chaque tick. L’état replié est conservé dans une variable globale temporaire du terminal nommée SymbolSpecAuditor_<identifiant du graphique>, qui est supprimée lorsque l’indicateur est retiré ou que le graphique est fermé. Utilisez une instance par graphique.
  • Les captures d’écran ont été réalisées sur un compte démo et un écran de 192 DPI avec une taille de police de 4 (6 en mode « avertissements uniquement »), afin que le panneau s’adapte à une image de 750 pixels. La taille par défaut de 9 donne un panneau plus grand.

Traduit de l’anglais par MetaQuotes Ltd.
Code original : https://www.mql5.com/en/code/77806

Spread Profile by Hour Spread Profile by Hour

Affiche le spread réel pour chaque heure de fonctionnement du serveur, mesuré à partir de l'historique des ticks fourni par votre courtier : médiane et 90e centile par heure, coût facultatif exprimé en pourcentage de votre ordre stop et par lot, et exportation au format CSV.

Daily Loss Guard Daily Loss Guard

Closes all trades when your daily loss reaches your limit.

Session Range and Spread Session Range and Spread

Draws Asia, London and New York session high/low boxes with each session's range in pips or price, plus a live spread and open-sessions panel.

Currency Exposure and Leverage Monitor Currency Exposure and Leverage Monitor

Splits all open positions into currencies and shows the net exposure per currency in account money, the effective leverage of the account and how much a 1% currency move would change your equity.