برنامه‌نویسی ربات معامله‌گر

خطای Unsupported filling mode در MQL5: علت و رفع کد ۱۰۰۳۰

تصویر شاخص خطای 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، نوع پر شدن را برای هر کدام جدا بگذارید. خطای رایج این است که یک متغیر سراسری برای هر دو به کار برود.

چک‌لیست رفع خطای ۱۰۰۳۰

  1. نوع پر شدن ثابت را از کد بردارید و از روی نماد انتخاب کنید.
  2. در لاگ، retcode و نام نماد را چاپ کنید تا معلوم باشد خطا از کدام نماد است.
  3. در Specification نماد ببینید حالت اجرا Market است یا Instant.
  4. برای سفارش‌های Pending از ORDER_FILLING_RETURN استفاده کنید.
  5. روی حساب دمو همان بروکر تست کنید. تستر تنظیمات نماد را از سرور بروکر می‌گیرد، ولی رفتار پر شدن روی حساب واقعی ممکن است فرق داشته باشد.

کدهای خطای دیگر را در بررسی Error Code ها در برنامه‌نویسی ربات و خطای کمبود موجودی را در ساخت اولین ربات در MT5 توضیح داده‌ایم. اگر ربات آماده‌ای دارید که این خطا را می‌دهد و سورسش را ندارید، اصلاحش فقط از فروشندهٔ همان ربات برمی‌آید یا ربات باید از نو ساخته شود. برای اصلاح رباتی که سورسش را دارید یا ساخت دوباره، از صفحهٔ اکسپرت نویسی در متاتریدر ۵ درخواست دهید.

پرسش‌های پرتکرار

آیا با عوض کردن بروکر این خطا برطرف می‌شود؟

ممکن است، ولی راه درست نیست. کدی که نوع پر شدن را از نماد می‌خواند، روی هر بروکری کار می‌کند.

چرا در تستر خطا نمی‌دهد ولی روی حساب واقعی می‌دهد؟

معمولاً چون تست روی سرور یا نوع حساب دیگری انجام شده است. تست را با همان حساب و همان نماد انجام دهید.

FOK بهتر است یا IOC؟

برای ربات‌هایی که حجم کوچک معامله می‌کنند معمولاً فرقی ندارد. اگر پر شدن ناقص برای منطق ربات مشکل‌ساز است، FOK را ترجیح دهید، به شرط اینکه نماد آن را مجاز کرده باشد.

منابع

هشدار ریسک: این مطلب جنبه آموزشی دارد و توصیه سرمایه‌گذاری نیست. معامله در بازارهای مالی با ریسک از دست دادن سرمایه همراه است و نتایج گذشته یا بک‌تست تضمینی برای آینده نیست.

نویسنده

تیم متااکسپرت در طراحی و برنامه‌نویسی ربات‌های معامله‌گر و اکسپرت‌های متاتریدر با MQL4 و MQL5 تخصص دارد و تجربه‌های عملی خود را در قالب این مقالات منتشر می‌کند.

دیدگاه‌ها

دیدگاه یا سؤال خود را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

کد امنیتی