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.
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 :
| Constante | Comportement |
|---|---|
ORDER_FILLING_FOK | Fill or Kill : l’ordre est exécuté uniquement dans son volume total, sinon il est annulé |
ORDER_FILLING_IOC | Immediate or Cancel : le volume disponible est exécuté, le reste est annulé |
ORDER_FILLING_BOC | Book 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_RETURN | En 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 :
| Drapeau | Valeur | Signification |
|---|---|---|
SYMBOL_FILLING_FOK | 1 | La politique FOK est autorisée |
SYMBOL_FILLING_IOC | 2 | La politique IOC est autorisée |
SYMBOL_FILLING_BOC | 4 | La 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.
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.
- Erreurs de compilation MQL5
- Invalid pointer access
- GetLastError et gestion des erreurs
- Codes de retour du serveur de trading
- 10004 Requote
- 10006 Requête rejetée
- 10013 Requête invalide
- 10014 Volume invalide
- 10015 Prix invalide
- 10016 Stops invalides
- 10017 Trading désactivé
- 10018 Marché fermé
- 10019 Fonds insuffisants
- 10021 Pas de cotations
- 10024 Trop de requêtes
- 10027 Trading automatique désactivé
- 4756 Échec d’envoi de la requête
- Array out of range
- Division par zéro
