Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Codes d’erreur

Erreur 10030 Invalid filling en MQL5 : choisir FOK, IOC ou Return

Le retcode 10030 signale une politique de remplissage refusée par le symbole. Lire SYMBOL_FILLING_MODE et le mode d’exécution pour choisir FOK, IOC ou Return en MQL5.

Mis à jour le 23 octobre 2026Lecture : 6 minPar Alix, OptiBot Trading

Le code 10030 (TRADE_RETCODE_INVALID_FILL, libellé officiel « Invalid order filling type ») signifie que la politique de remplissage indiquée dans le champ type_filling de votre requête n’est pas autorisée pour ce symbole chez votre courtier. C’est l’erreur typique de l’EA qui fonctionne parfaitement chez un courtier et échoue dès le premier ordre chez un autre : chaque serveur n’accepte qu’une partie des politiques FOK, IOC et Return, et cela peut varier d’un symbole à l’autre. La solution consiste à lire les politiques autorisées dans les propriétés du symbole et à choisir dynamiquement celle qui convient, au lieu d’en coder une en dur.

Cette page explique les règles de compatibilité et donne une fonction de sélection automatique. Elle fait partie de la rubrique Codes d’erreur et de retour MQL5. Pour le fonctionnement détaillé de chaque politique, voyez Modes de remplissage (FOK, IOC, Return).

Les politiques de remplissage en bref

L’énumération ENUM_ORDER_TYPE_FILLING définit les valeurs possibles du champ type_filling :

ConstanteComportement
ORDER_FILLING_FOKFill or Kill : l’ordre est exécuté uniquement dans son volume total, sinon il est annulé
ORDER_FILLING_IOCImmediate or Cancel : le volume disponible est exécuté, le reste est annulé
ORDER_FILLING_BOCBook or Cancel : l’ordre ne peut être placé que dans le carnet ; il est annulé s’il serait exécuté immédiatement (ordres limites et stop-limit uniquement)
ORDER_FILLING_RETURNEn cas d’exécution partielle, le volume restant reste actif au lieu d’être annulé

Ces politiques n’ont de sens que si le marché peut ne pas absorber tout le volume demandé. Pour un ordre d’un lot sur une paire majeure, la différence pratique est souvent nulle ; mais le serveur, lui, exige une valeur compatible.

Ce que le symbole autorise

La propriété SYMBOL_FILLING_MODE, lue avec SymbolInfoInteger(), est une combinaison de drapeaux :

DrapeauValeurSignification
SYMBOL_FILLING_FOK1La politique FOK est autorisée
SYMBOL_FILLING_IOC2La politique IOC est autorisée
SYMBOL_FILLING_BOC4La politique BOC est autorisée

Il n’existe pas de drapeau pour Return : sa disponibilité dépend du mode d’exécution du symbole (SYMBOL_TRADE_EXEMODE). Selon la documentation :

  • en exécution instantanée, à la demande et bourse, Return est toujours autorisé ;
  • en exécution au marché, Return est désactivé, quels que soient les réglages du symbole ;
  • pour les ordres en attente, Return doit être utilisé quel que soit le mode d’exécution, puisqu’ils ne sont pas exécutés au moment de l’envoi ;
  • si aucun type de remplissage n’est indiqué dans la requête, Return est utilisé automatiquement.

Ce dernier point explique un piège fréquent : un EA qui ne renseigne pas type_filling se voit appliquer Return. Sur un symbole en exécution au marché, où Return est désactivé, c’est précisément ce qui provoque le 10030, alors que le développeur pense n’avoir « rien choisi ». Affectez toujours ce champ explicitement, en fonction du symbole.

Choisir automatiquement la bonne politique

//+------------------------------------------------------------------+
//| Renvoie une politique de remplissage acceptée pour un ordre      |
//| au marché sur le symbole donné                                   |
//+------------------------------------------------------------------+
ENUM_ORDER_TYPE_FILLING MarketFilling(const string symbol)
  {
   long filling = SymbolInfoInteger(symbol, SYMBOL_FILLING_MODE);
   ENUM_SYMBOL_TRADE_EXECUTION exec =
      (ENUM_SYMBOL_TRADE_EXECUTION)SymbolInfoInteger(symbol, SYMBOL_TRADE_EXEMODE);

   // Ordre de préférence : FOK (tout ou rien), puis IOC, puis Return
   if((filling & SYMBOL_FILLING_FOK) == SYMBOL_FILLING_FOK)
      return ORDER_FILLING_FOK;
   if((filling & SYMBOL_FILLING_IOC) == SYMBOL_FILLING_IOC)
      return ORDER_FILLING_IOC;
   if(exec != SYMBOL_TRADE_EXECUTION_MARKET)
      return ORDER_FILLING_RETURN;           // Return autorisé hors exécution au marché

   PrintFormat("%s : aucune politique compatible détectée (filling=%I64d)", symbol, filling);
   return ORDER_FILLING_IOC;                 // valeur de repli, l'envoi sera vérifié
  }

//+------------------------------------------------------------------+
//| Exemple d'envoi au marché avec la politique adaptée              |
//+------------------------------------------------------------------+
bool SellMarket(const double lots)
  {
   MqlTradeRequest req = {};
   MqlTradeResult  res = {};
   req.action       = TRADE_ACTION_DEAL;
   req.symbol       = _Symbol;
   req.volume       = lots;
   req.type         = ORDER_TYPE_SELL;
   req.price        = SymbolInfoDouble(_Symbol, SYMBOL_BID);
   req.deviation    = 10;
   req.type_filling = MarketFilling(_Symbol);   // jamais en dur

   if(!OrderSend(req, res) || res.retcode != TRADE_RETCODE_DONE)
     {
      PrintFormat("Vente refusée : retcode %u, filling %s",
                  res.retcode, EnumToString(req.type_filling));
      return false;
     }
   return true;
  }

L’ordre de préférence est un choix. FOK garantit que vous obtenez exactement le volume prévu, ce qui simplifie la gestion du risque. IOC peut laisser une exécution partielle, qu’il faut alors gérer. Return, enfin, laisse le reliquat actif, ce qui convient mieux aux marchés boursiers. Adaptez cet ordre à votre stratégie.

Avec la classe CTrade

CTrade propose SetTypeFilling() pour fixer une politique et SetTypeFillingBySymbol() pour la déterminer à partir des propriétés d’un symbole. Appeler trade.SetTypeFillingBySymbol(_Symbol) dans OnInit() règle la plupart des 10030 en une ligne. Dans un EA multi-symboles, rappelez-la avant chaque envoi sur un symbole différent, puisque la politique est mémorisée dans l’objet CTrade. La classe est présentée dans La classe CTrade.

Diagnostiquer un 10030

Trois informations suffisent : la valeur de type_filling envoyée (affichée avec EnumToString()), la valeur brute de SYMBOL_FILLING_MODE et le mode d’exécution du symbole. Si vous envoyez Return sur un symbole en exécution au marché, ou FOK sur un symbole dont le drapeau FOK est absent, la cause est trouvée.

Gardez également à l’esprit que les propriétés d’un symbole peuvent changer : un courtier peut modifier sa politique de remplissage ou son mode d’exécution lors d’une évolution de son offre. C’est une raison de plus pour lire SYMBOL_FILLING_MODE au moment de l’envoi plutôt que de mémoriser une valeur trouvée une fois pour toutes lors du développement.

Comparez aussi avec un ordre manuel : la fenêtre d’ordre du terminal propose uniquement les politiques compatibles. Si l’ordre manuel passe avec IOC et que l’EA envoie FOK, la différence saute aux yeux.

Cas typiques

L’EA importé d’un autre courtier

Un EA développé sur un serveur qui accepte FOK, avec ORDER_FILLING_FOK codé en dur, échoue immédiatement sur un serveur qui n’accepte qu’IOC. C’est la cause numéro un des 10030. Si vous diffusez un EA, testez-le sur des comptes démo de plusieurs serveurs, avec des modes d’exécution différents, avant de considérer qu’il est portable.

Les ordres en attente

Un ordre limite envoyé avec FOK ou IOC peut être refusé. Pour les ordres en attente, la documentation recommande Return, quel que soit le mode d’exécution. Séparez donc la politique des ordres au marché de celle des ordres en attente.

Le symbole d’une autre catégorie

Dans un même compte, une paire de devises et un CFD sur action peuvent avoir des politiques différentes. Un EA multi-symboles doit déterminer la politique par symbole, jamais une fois pour toutes.

L’exécution partielle mal gérée

Corriger le 10030 en passant à IOC fait apparaître une nouvelle situation : l’exécution partielle, signalée par le retcode 10010 (TRADE_RETCODE_DONE_PARTIAL). Votre code doit alors lire result.volume, mettre à jour son suivi de la position et décider s’il complète le volume manquant. Un EA qui ignore ce cas croit détenir 1 lot alors qu’il n’en détient que 0,6 ; ses calculs de stop et de clôture partielle deviennent faux. La lecture complète de la réponse du serveur est détaillée dans Codes de retour du serveur de trading.

Réessayer avec une autre politique ?

Certains développeurs écrivent une boucle qui essaie FOK, puis IOC, puis Return jusqu’à ce que l’un passe. Cela fonctionne, mais génère des refus inutiles et ralentit l’exécution. Il est plus propre de lire les propriétés une fois et de choisir directement la bonne politique. Réservez le nouvel essai aux cas où les propriétés semblent incohérentes, et journalisez-le.

Une politique IOC ou Return peut conduire à une exécution partielle : la position réellement ouverte est alors plus petite que prévu. Le trading à effet de levier comporte un risque de perte élevé : basez toujours votre suivi du risque sur le volume effectivement exécuté.

Questions fréquentes

Pourquoi mon EA fonctionne chez un courtier et pas chez un autre ?

Parce que chaque serveur autorise des politiques de remplissage différentes. Si la politique est codée en dur, elle peut être incompatible ailleurs. Lisez SYMBOL_FILLING_MODE et SYMBOL_TRADE_EXEMODE pour choisir la bonne.

Existe-t-il un drapeau SYMBOL_FILLING_RETURN ?

Non. La disponibilité de Return dépend du mode d’exécution : autorisée en exécution instantanée, à la demande et bourse, désactivée en exécution au marché. Pour les ordres en attente, Return doit être utilisé.

SetTypeFillingBySymbol suffit-il ?

Dans la plupart des cas, oui : la méthode de CTrade choisit une politique compatible avec le symbole. Rappelez-la pour chaque symbole dans un EA multi-instruments.

FOK ou IOC : lequel choisir ?

FOK si vous voulez le volume exact ou rien, ce qui simplifie la gestion du risque. IOC si vous acceptez une exécution partielle. Dans les deux cas, vérifiez result.volume après l’envoi.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.