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.
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 :
| Indicateur | Valeur | Signification |
|---|---|---|
SYMBOL_FILLING_FOK | 1 | FOK autorisé |
SYMBOL_FILLING_IOC | 2 | IOC autorisé |
SYMBOL_FILLING_BOC | 4 | BOC 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 :
- affichez
SYMBOL_FILLING_MODEetSYMBOL_TRADE_EXEMODEdu symbole concerné ; - vérifiez le mode envoyé (
trade.RequestTypeFilling()ourequest.type_filling) ; - si le symbole est en exécution Market, vérifiez que vous n’envoyez pas
ORDER_FILLING_RETURNpour un ordre au marché ; - 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.
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.
- Ordres, positions et transactions : le modèle de MT5
- Comptes netting ou hedging
- La classe CTrade
- OrderSend et MqlTradeRequest
- OrderCheck : vérifier un ordre avant envoi
- Ouvrir une position au marché
- Ordres limites et stop
- Placer et modifier stop loss et take profit
- Coder un trailing stop
- Passer une position à break-even
- Fermer une position (totale ou partielle)
- Parcourir et filtrer les positions
- Le magic number
- Lire l’historique des ordres et transactions
- OnTradeTransaction : réagir aux événements de trading
- Gérer spread et slippage dans un EA
- Calculer et normaliser la taille de lot
