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

MQL5 · Ordres et positions

Modes de remplissage en MQL5 : FOK, IOC, Return et BOC sans erreur 10030

FOK, IOC, Return ou BOC : le mode de remplissage dépend du symbole et du mode d’exécution. Comment lire SYMBOL_FILLING_MODE, choisir le bon mode et éviter l’erreur 10030.

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

Le mode de remplissage (type_filling) indique au serveur que faire si le volume demandé n’est pas disponible en totalité. MQL5 en propose quatre dans ENUM_ORDER_TYPE_FILLING : FOK (ORDER_FILLING_FOK, tout ou rien), IOC (ORDER_FILLING_IOC, exécuter ce qui est disponible et annuler le reste), Return (ORDER_FILLING_RETURN, le reliquat reste actif) et BOC (ORDER_FILLING_BOC, ordre passif uniquement). Un mode non autorisé pour le symbole est refusé avec TRADE_RETCODE_INVALID_FILL (10030). Lisez donc SYMBOL_FILLING_MODE et le mode d’exécution du symbole avant de choisir.

C’est l’une des causes les plus fréquentes d’un EA qui fonctionne chez un broker et échoue chez un autre. Cette page fait partie de la rubrique Ordres et positions en MQL5.

Les quatre modes

ORDER_FILLING_FOK — Fill or Kill

L’ordre n’est exécuté que si le volume demandé peut l’être en totalité, éventuellement en combinant plusieurs offres disponibles. Sinon, il est annulé. Selon la documentation, il est toujours disponible en exécution Instant et Request ; en exécution Market et Exchange, il n’est disponible que s’il est activé dans les paramètres du symbole.

ORDER_FILLING_IOC — Immediate or Cancel

L’ordre est exécuté pour le volume immédiatement disponible, dans la limite du volume demandé, et la partie non exécutée est annulée. Mêmes conditions de disponibilité que FOK. Avec ce mode, un ordre peut aboutir à TRADE_RETCODE_DONE_PARTIAL (10010) : vérifiez le volume réellement exécuté.

ORDER_FILLING_RETURN

En cas d’exécution partielle, le volume restant n’est pas annulé mais reste actif. La documentation précise que ce mode est toujours disponible en exécution Instant, Request et Exchange, mais désactivé en exécution Market, quels que soient les paramètres du symbole.

ORDER_FILLING_BOC — Book or Cancel

Politique passive : l’ordre ne peut être placé que dans le carnet d’ordres et ne doit pas être exécuté immédiatement. S’il pouvait l’être au moment du placement, il est annulé. Seuls les ordres limites et stop-limit sont concernés. Ce mode intéresse surtout les marchés boursiers, où l’on veut être certain d’apporter de la liquidité.

Ce que dit le symbole

Deux propriétés déterminent le choix.

SYMBOL_TRADE_EXEMODE donne le mode d’exécution : SYMBOL_TRADE_EXECUTION_REQUEST, SYMBOL_TRADE_EXECUTION_INSTANT, SYMBOL_TRADE_EXECUTION_MARKET ou SYMBOL_TRADE_EXECUTION_EXCHANGE. Vérifiez-le pour chaque symbole : il peut différer d’un broker à l’autre, et d’un instrument à l’autre chez le même broker.

SYMBOL_FILLING_MODE est un ensemble d’indicateurs combinés :

IndicateurValeurSignification
SYMBOL_FILLING_FOK1FOK autorisé
SYMBOL_FILLING_IOC2IOC autorisé
SYMBOL_FILLING_BOC4BOC autorisé

Le mode Return n’a pas d’indicateur propre : il découle du mode d’exécution (interdit en Market, disponible ailleurs). Un symbole en exécution Market dont SYMBOL_FILLING_MODE vaut 1 n’accepte donc que FOK ; s’il vaut 3, il accepte FOK et IOC.

Le cas des ordres en attente

La documentation donne une consigne particulière : pour les ordres en attente, utilisez ORDER_FILLING_RETURN quel que soit le mode d’exécution, car le broker appliquera, au moment où les conditions seront remplies, le type de remplissage supporté. La restriction « Return interdit en exécution Market » concerne donc les ordres au marché (TRADE_ACTION_DEAL). Les ordres en attente sont détaillés dans Ordres limites et stop.

Exemple : choisir le mode adapté à chaque requête

La fonction suivante renvoie un mode compatible avec le symbole, selon que l’ordre est au marché ou en attente, et signale les cas où aucun mode valide n’est identifiable.

//+------------------------------------------------------------------+
//| Choix du mode de remplissage selon le symbole et l'action        |
//+------------------------------------------------------------------+
#include <Trade\Trade.mqh>

CTrade trade;

//--- renvoie true et remplit 'filling' si un mode valide est trouvé
bool PickFilling(const string symbol, bool pending, ENUM_ORDER_TYPE_FILLING &filling)
  {
   //--- consigne de la documentation pour les ordres en attente
   if(pending)
     {
      filling = ORDER_FILLING_RETURN;
      return(true);
     }

   long flags = SymbolInfoInteger(symbol, SYMBOL_FILLING_MODE);
   ENUM_SYMBOL_TRADE_EXECUTION exe =
      (ENUM_SYMBOL_TRADE_EXECUTION)SymbolInfoInteger(symbol, SYMBOL_TRADE_EXEMODE);

   //--- préférence : FOK (volume complet) puis IOC
   if((flags & SYMBOL_FILLING_FOK) != 0) { filling = ORDER_FILLING_FOK; return(true); }
   if((flags & SYMBOL_FILLING_IOC) != 0) { filling = ORDER_FILLING_IOC; return(true); }

   //--- Return : autorisé partout sauf en exécution Market
   if(exe != SYMBOL_TRADE_EXECUTION_MARKET)
     {
      filling = ORDER_FILLING_RETURN;
      return(true);
     }
   PrintFormat("%s : aucun mode de remplissage identifiable (flags=%I64d)", symbol, flags);
   return(false);
  }

int OnInit()
  {
   ENUM_ORDER_TYPE_FILLING f;
   if(!PickFilling(_Symbol, false, f))
      return(INIT_FAILED);
   trade.SetTypeFilling(f);                       // pour les ordres au marché
   PrintFormat("Mode retenu pour %s : %s", _Symbol, EnumToString(f));
   return(INIT_SUCCEEDED);
  }

void OnTick()
  {
   // Avant un ordre en attente : trade.SetTypeFilling(ORDER_FILLING_RETURN);
   // puis revenir au mode marché pour les ordres suivants.
  }

La préférence pour FOK est un choix : elle garantit que la position a exactement le volume demandé, ce qui simplifie la gestion du risque. Si vous préférez une exécution partielle à une absence d’exécution, inversez l’ordre de priorité entre FOK et IOC. EnumToString affiche le nom de la constante, pratique pour le journal.

Afficher les réglages d’un symbole

Avant de déployer un EA chez un nouveau broker, prenez l’habitude d’afficher dans le journal, pour chaque symbole tradé, la valeur de SYMBOL_FILLING_MODE, le mode d’exécution, le volume minimal, le pas de volume et la distance minimale des stops. Ces cinq lignes, écrites dans OnInit, suffisent à expliquer la majorité des refus observés lors d’un changement de compte. Elles constituent aussi une trace utile si le broker modifie ses paramètres plus tard : en comparant le journal d’avant et d’après, vous identifiez immédiatement ce qui a changé.

SetTypeFillingBySymbol : la solution intégrée

La classe CTrade propose SetTypeFillingBySymbol(symbol), qui règle le mode à partir de SYMBOL_FILLING_MODE. Selon la documentation, si FOK et IOC sont tous deux autorisés, c’est ORDER_FILLING_FOK qui est retenu ; la méthode renvoie false si la politique n’a pas pu être déterminée. Elle suffit dans la plupart des cas pour les ordres au marché. Pour les ordres en attente, réglez explicitement ORDER_FILLING_RETURN avant l’envoi, comme le recommande la documentation des modes de remplissage.

Diagnostic d’une erreur 10030

Quand le serveur renvoie TRADE_RETCODE_INVALID_FILL, suivez cette démarche :

  1. affichez SYMBOL_FILLING_MODE et SYMBOL_TRADE_EXEMODE du symbole concerné ;
  2. vérifiez le mode envoyé (trade.RequestTypeFilling() ou request.type_filling) ;
  3. si le symbole est en exécution Market, vérifiez que vous n’envoyez pas ORDER_FILLING_RETURN pour un ordre au marché ;
  4. pour un EA multi-symboles, recalculez le mode pour chaque symbole au lieu d’en régler un seul dans OnInit.

La page 10030 Mode de remplissage non supporté est entièrement consacrée à ce code de retour.

Cas d’usage et pièges

EA multi-symboles. Les paramètres peuvent différer d’un symbole à l’autre chez le même broker : un indice en exécution Exchange, une paire de devises en exécution Market. Choisissez le mode au moment de chaque envoi.

Volume partiel avec IOC. Sur un symbole peu liquide ou pour un volume important, IOC peut exécuter seulement une partie. Lisez ResultVolume() et adaptez stops et gestion à ce volume réel.

Backtest trompeur. Un backtest ne reproduit pas forcément la liquidité ni les exécutions partielles que vous rencontrerez en réel. Ne concluez pas de l’absence de problème en test que votre gestion des exécutions partielles est inutile.

Le mode de remplissage influe sur le volume réellement exécuté, donc sur le risque réel de la position. Le trading avec effet de levier comporte un risque élevé de perte en capital ; vérifiez le comportement de votre EA sur un compte de démonstration du broker visé.

FAQ

Pourquoi mon EA renvoie-t-il 10030 chez un nouveau broker ?

Le mode de remplissage envoyé n’est pas autorisé pour ce symbole. Le cas typique est ORDER_FILLING_RETURN pour un ordre au marché sur un symbole en exécution Market. Lisez SYMBOL_FILLING_MODE et choisissez FOK ou IOC.

Quel mode utiliser pour un Buy Limit ?

La documentation recommande ORDER_FILLING_RETURN pour les ordres en attente, quel que soit le mode d’exécution du symbole.

FOK ou IOC : lequel choisir ?

FOK garantit le volume complet ou rien, ce qui simplifie la gestion du risque. IOC privilégie l’exécution, éventuellement partielle. Pour un EA de détail aux volumes modestes, la différence se voit rarement, mais votre code doit gérer les deux.

Faut-il recalculer le mode à chaque ordre ?

Pour un EA mono-symbole qui n’envoie que des ordres au marché, un réglage dans OnInit suffit. Dès que l’EA alterne ordres au marché et ordres en attente, ou trade plusieurs symboles, choisissez le mode au moment de chaque envoi : le coût de cette lecture est négligeable et elle évite des refus difficiles à reproduire.

Que fait ORDER_FILLING_BOC ?

Il place un ordre passif dans le carnet et l’annule s’il pouvait être exécuté immédiatement. Il ne s’applique qu’aux ordres limites et stop-limit, et seulement si le symbole l’autorise.

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.