خطای Unsupported filling mode در MQL5: علت و رفع کد ۱۰۰۳۰
پاسخ کوتاه: خطای Unsupported filling mode با کد ۱۰۰۳۰ یعنی نوع پر شدنی که اکسپرت در سفارش فرستاده، برای آن نماد نزد این بروکر مجاز نیست. راه حل این است که نوع پر شدن را در کد ثابت ننویسید. آن را از تنظیمات نماد (SYMBOL_FILLING_MODE) و حالت اجرای بروکر بخوانید و برای هر سفارش انتخاب کنید.
این خطا کجا دیده میشود؟
وقتی اکسپرت متاتریدر ۵ سفارش بازار میفرستد و سرور آن را رد میکند، در تب Journal یا Experts خطی با پیام «Unsupported filling mode» میبینید. اگر نتیجهٔ OrderSend را بخوانید، در retcode عدد ۱۰۰۳۰ برمیگردد. در مستندات MQL5 این کد TRADE_RETCODE_INVALID_FILL نام دارد و یعنی نوع پر شدن سفارش نامعتبر است.
این خطا معمولاً در یکی از این حالتها ظاهر میشود:
- ربات روی بروکر یا حساب دیگری اجرا شده که نوع اجرای دیگری دارد؛
- کد نمونهای از اینترنت برداشته شده که
ORDER_FILLING_FOKیاORDER_FILLING_RETURNرا ثابت گذاشته است؛ - نماد تازهای به ربات اضافه شده که تنظیمات پر شدن متفاوتی دارد. چکلیست این کار در افزودن نماد معاملاتی جدید به ربات آمده است.
متاتریدر ۴ این مفهوم را ندارد. OrderSend در MQL4 پارامتری برای نوع پر شدن نمیگیرد، پس این خطا مخصوص MQL5 است. تفاوتهای دیگر را در تفاوت OrderSend در MQL4 و MQL5 نوشتهایم.
نوع پر شدن سفارش یعنی چه؟
نوع پر شدن (Filling) میگوید اگر همهٔ حجم درخواستی همان لحظه در بازار نبود، با سفارش چه شود. MQL5 چهار گزینه دارد:
| ثابت در MQL5 | رفتار |
|---|---|
ORDER_FILLING_FOK |
همه یا هیچ: فقط اگر کل حجم در دسترس باشد اجرا میشود. |
ORDER_FILLING_IOC |
هر مقداری که همان لحظه در دسترس است اجرا میشود و باقیاش لغو میشود. |
ORDER_FILLING_RETURN |
اگر بخشی از حجم پر شد، باقیمانده لغو نمیشود و بهصورت سفارش باقی میماند. |
ORDER_FILLING_BOC |
فقط برای سفارشهای Limit و Stop Limit؛ سفارش فقط در عمق بازار مینشیند و اگر بلافاصله اجرا شود، لغو میشود. |
چرا یک نوع پر شدن روی یک بروکر کار میکند و روی دیگری نه؟
چون مجاز بودن هر نوع به دو چیز بستگی دارد: حالت اجرای نماد نزد بروکر، و پرچمهای SYMBOL_FILLING_MODE همان نماد. خلاصهٔ جدول مستندات MQL5:
| حالت اجرا | FOK و IOC | RETURN |
|---|---|---|
| Instant Execution | همیشه مجاز | مجاز |
| Request Execution | همیشه مجاز | مجاز |
| Market Execution | طبق تنظیمات نماد | مجاز نیست |
| Exchange Execution | طبق تنظیمات نماد | مجاز |
بیشتر حسابهای ECN و Raw با Market Execution کار میکنند. پس کدی که با ORDER_FILLING_RETURN روی یک حساب Instant بیمشکل بوده، روی حساب Market همین خطا را میدهد. حالت اجرای هر نماد را در پنجرهٔ Specification متاتریدر هم میبینید.
کد MQL5: انتخاب نوع پر شدن از روی تنظیمات نماد
این تابع حالت اجرای نماد و پرچمهای مجاز را میخواند و نوعی را برمیگرداند که سرور میپذیرد:
// Picks a filling type the trade server accepts for this symbol
bool PickFilling(const string symbol,ENUM_ORDER_TYPE_FILLING &filling)
{
long exec=SymbolInfoInteger(symbol,SYMBOL_TRADE_EXEMODE);
long mode=SymbolInfoInteger(symbol,SYMBOL_FILLING_MODE);
if(exec==SYMBOL_TRADE_EXECUTION_INSTANT || exec==SYMBOL_TRADE_EXECUTION_REQUEST)
{
filling=ORDER_FILLING_FOK; // always allowed in these modes
return(true);
}
if((mode & SYMBOL_FILLING_FOK)!=0)
{
filling=ORDER_FILLING_FOK;
return(true);
}
if((mode & SYMBOL_FILLING_IOC)!=0)
{
filling=ORDER_FILLING_IOC;
return(true);
}
if(exec==SYMBOL_TRADE_EXECUTION_EXCHANGE)
{
filling=ORDER_FILLING_RETURN; // allowed on exchange execution
return(true);
}
PrintFormat("%s: no filling type allowed for market orders",symbol);
return(false);
}
در سفارش، پیش از OrderSend مقدار را بگذارید:
MqlTradeRequest request={};
MqlTradeResult result={};
request.action=TRADE_ACTION_DEAL;
request.symbol=_Symbol;
request.volume=0.10;
request.type=ORDER_TYPE_BUY;
request.price=SymbolInfoDouble(_Symbol,SYMBOL_ASK);
request.deviation=10;
if(!PickFilling(_Symbol,request.type_filling))
return;
if(!OrderSend(request,result))
PrintFormat("OrderSend failed: retcode %u, error %d",result.retcode,GetLastError());
اگر با کلاس CTrade کار میکنید، متد SetTypeFillingBySymbol(_Symbol) همین کار را از روی تنظیمات نماد انجام میدهد. خروجیاش bool است؛ اگر false داد، ارسال سفارش را ادامه ندهید.
#include <TradeTrade.mqh>
CTrade trade;
int OnInit()
{
if(!trade.SetTypeFillingBySymbol(_Symbol))
{
Print("No filling type could be set for ",_Symbol);
return(INIT_FAILED);
}
return(INIT_SUCCEEDED);
}
برای پایهٔ ارسال سفارش، آموزش ارسال سفارش Buy و Sell در MQL5 را ببینید.
سفارشهای Pending چه؟
طبق مستندات، سفارشهای Pending در هر حالت اجرایی باید ORDER_FILLING_RETURN داشته باشند، چون قرار نیست هنگام ارسال اجرا شوند. اگر ربات هم سفارش بازار میفرستد و هم Pending، نوع پر شدن را برای هر کدام جدا بگذارید. خطای رایج این است که یک متغیر سراسری برای هر دو به کار برود.
چکلیست رفع خطای ۱۰۰۳۰
- نوع پر شدن ثابت را از کد بردارید و از روی نماد انتخاب کنید.
- در لاگ،
retcodeو نام نماد را چاپ کنید تا معلوم باشد خطا از کدام نماد است. - در Specification نماد ببینید حالت اجرا Market است یا Instant.
- برای سفارشهای Pending از
ORDER_FILLING_RETURNاستفاده کنید. - روی حساب دمو همان بروکر تست کنید. تستر تنظیمات نماد را از سرور بروکر میگیرد، ولی رفتار پر شدن روی حساب واقعی ممکن است فرق داشته باشد.
کدهای خطای دیگر را در بررسی Error Code ها در برنامهنویسی ربات و خطای کمبود موجودی را در ساخت اولین ربات در MT5 توضیح دادهایم. اگر ربات آمادهای دارید که این خطا را میدهد و سورسش را ندارید، اصلاحش فقط از فروشندهٔ همان ربات برمیآید یا ربات باید از نو ساخته شود. برای اصلاح رباتی که سورسش را دارید یا ساخت دوباره، از صفحهٔ اکسپرت نویسی در متاتریدر ۵ درخواست دهید.
پرسشهای پرتکرار
آیا با عوض کردن بروکر این خطا برطرف میشود؟
ممکن است، ولی راه درست نیست. کدی که نوع پر شدن را از نماد میخواند، روی هر بروکری کار میکند.
چرا در تستر خطا نمیدهد ولی روی حساب واقعی میدهد؟
معمولاً چون تست روی سرور یا نوع حساب دیگری انجام شده است. تست را با همان حساب و همان نماد انجام دهید.
FOK بهتر است یا IOC؟
برای رباتهایی که حجم کوچک معامله میکنند معمولاً فرقی ندارد. اگر پر شدن ناقص برای منطق ربات مشکلساز است، FOK را ترجیح دهید، به شرط اینکه نماد آن را مجاز کرده باشد.
دیدگاهها