منو +

تلگرام - بله - ایتا : 09364549266

دانلود اکسپرت CalendarExport یک تقویم اقتصادی کامل برای متاتریدر 5 در فارکس

اکسپرت CalendarExport

این اکسپرت (EA) برای حل یک کمبود اساسی در اکوسیستم متاتریدر ۵ طراحی شده است: تقویم اقتصادی داخلی MT5 تنها از طریق زبان MQL5 و تابع CalendarValueHistory() قابل دسترسی است و هیچ راه دیگری برای خواندن آن وجود ندارد. پکیج پایتون MetaTrader5 اگرچه قیمت‌ها، نمادها، سفارش‌ها و تاریخچه را ارائه می‌دهد، اما هیچ تابعی برای تقویم ندارد. بنابراین هر اسکریپت تحقیقاتی، داشبورد، ربات یا صفحه گسترده‌ای که نیاز دارد بداند رویداد مهم بعدی چه زمانی منتشر می‌شود، راهی برای پرسیدن از ترمینال ندارد. این اکسپرت به عنوان “پل گمشده” روی هر چارتی قرار می‌گیرد و به صورت دوره‌ای تقویم را در یک فایل CSV داخل پوشه MQL5\Files می‌نویسد تا هر ابزار خارجی بتواند آن را بخواند.

 نویسنده این اکسپرت را با دقت مهندسی‌شده از چهار اشتباه رایج محافظت کرده است: اول، خروجی را به صورت UTF-8 می‌نویسد نه کدپیج محلی، زیرا نام رویدادها به زبان ترمینال بازگردانده می‌شوند و در MT5 غیرانگلیسی حاوی کاراکترهای غیرلاتین هستند که با FILE_ANSI به بایت‌های نامعتبر UTF-8 تبدیل شده و در مصرف‌کننده‌هایی مثل پایتون یا اکسل باعث خطا یا خرابی می‌شوند. دوم، خروجی را بر اساس زمان مرتب می‌کند، چون تقویم به ازای هر ارز جداگانه پرس‌وجو می‌شود و خروجی طبیعی گروه‌بندی‌شده بر اساس ارز، پرش‌های زمانی دارد. سوم، کل فایل را در یک فراخوانی می‌نویسد تا خواننده‌ای که وسط نوشتن فایل را باز می‌کند، لیست ناقص نبیند و خط اول شامل timestamp و تعداد رویدادهاست تا تازگی فایل قابل تشخیص باشد. چهارم، موجودیت‌های HTML را در نام رویدادها رمزگشایی می‌کند، مثلاً & را به & تبدیل می‌کند تا نام‌هایی مثل “CFTC S&P 500” درست منتقل شوند.

بروکر GTCfx

 این اکسپرت با گروه‌بندی منظمی از پارامترها کنترل کامل را به کاربر می‌دهد. در بخش “What to include” می‌توان ارزها را با کاما جدا کرد (خالی = همه ارزها)، بازه زمانی را با InpHoursAhead (پیش‌رو) و InpHoursBack (پس‌رو برای داده‌های تازه منتشرشده) تنظیم کرد و حداقل اهمیت رویداد را با InpMinImportance (۰=هیچ، ۱=کم، ۲=متوسط، ۳=بالا) مشخص کرد. در بخش “Output” نیز نام فایل خروجی، بازه بازنویسی (InpRefreshSec با حداقل ۳۰ ثانیه) و انتخاب UTF-8 یا کدپیج ترمینال (InpUtf8) قابل تنظیم است. این طراحی اجازه می‌دهد کاربر بسته به نیاز، فقط رویدادهای با اهمیت بالا و ارزهای خاص را در بازه زمانی دلخواه دریافت کند.

جهت سفارش طراحی و برنامه‌نویسی اختصاصی اندیکاتور، اکسپرت و ربات معامله‌گر برای MetaTrader 4 و  MetaTrader 5  می‌توانید استراتژی، ایده یا نیاز معاملاتی خود را با تیم هوش فعال در میان بگذارید. برای دریافت مشاوره، بررسی امکان پیاده‌سازی و ثبت سفارش، از طریق شماره 09364549266 با پشتیبانی هوش فعال در ارتباط باشید.

معماری کد بر پایه یک ساختار Event بنا شده که هر ردیف خروجی را نگه می‌دارد تا کل مجموعه قبل از نوشتن قابل مرتب‌سازی باشد. تابع CurrencyOf با یک مکانیزم کش، ارز مربوط به هر کشور را فقط یک بار از ترمینال می‌پرسد چون هزاران مقدار تقویمی بین تعداد محدودی کشور مشترک هستند. تابع ImportanceWord مقادیر عددی importance را به کلمات خوانا (NONE/LOW/MEDIUM/HIGH) تبدیل می‌کند تا مصرف‌کننده مجبور نباشد CALENDAR_IMPORTANCE_HIGH را پاک‌سازی کند. تابع Unescape موجودیت‌های HTML را با ترتیب صحیح (amp در آخر برای جلوگیری از باگ double-decoding) رمزگشایی می‌کند. تابع Csv نیز نقل‌قول‌گذاری استاندارد CSV را انجام می‌دهد تا نام رویدادهایی که کاما دارند، دستکاری نشوند. تابع SortByTime از مرتب‌سازی درجی استفاده می‌کند که برای چند صد ردیف کارآمد است و ترتیب مساوی‌ها را حفظ می‌کند.

توضیحات طراح اکسپرت CalendarExport 

پنج جزئیات مهم در این ابزار وجود دارد. نخست، خروجی UTF-8 است، زیرا نام رویدادها توسط ترمینال بومی‌سازی می‌شوند و در MT5 غیرانگلیسی حاوی کاراکترهای دارای اعراب یا غیرلاتین هستند؛ اگر با کدپیج محلی نوشته شوند، به بایت‌هایی تبدیل می‌شوند که UTF-8 معتبر نیستند و بیشتر مصرف‌کننده‌ها یا خطا می‌دهند یا نام را بی‌صدا خراب می‌کنند. دوم، خروجی بر اساس زمان مرتب می‌شود، چون تقویم به ازای هر ارز یک بار پرس‌وجو می‌شود و خروجی طبیعی بر اساس ارز گروه‌بندی شده و در زمان جلو و عقب می‌پرد، اما این نسخه ترتیب زمانی دارد. سوم، فایل در یک فراخوانی واحد نوشته می‌شود؛ بدین ترتیب فایل در حافظه ساخته شده و یک‌جا نوشته می‌شود، در غیر این صورت خواننده‌ای که وسط نوشتن فایل را باز کند، لیست ناقصی می‌بیند و هیچ راهی برای فهمیدن آن ندارد. چهارم، موجودیت‌های HTML رمزگشایی شده‌اند، چون ترمینال نام رویدادها را escape شده ذخیره می‌کند و اگر بدون تغییر نوشته شود، به‌صورت اشتباه به هر مصرف‌کننده‌ای می‌رسد. پنجم، یک هدر تازگی وجود دارد که خط اول آن شامل زمان به‌روزرسانی، تعداد رویدادها و اختلاف UTC سرور است تا مصرف‌کننده بتواند فایل کهنه را از فایل جاری تشخیص دهد و متوجه شود که اکسپرت جدا شده، به‌جای اینکه تقویم قدیمی را طوری نشان دهد که گویی زنده است. زمان به‌روزرسانی از ساعت سرور معاملاتی خوانده می‌شود و نه از آخرین تیک، زیرا وقتی بازار بسته است آخرین تیک ثابت می‌ماند و فایلی که به آن روش تاریخ‌گذاری شده باشد در حالی که هر چند دقیقه بازنویسی می‌شود کهنه به نظر می‌رسد و پنجره رویداد در طول آخر هفته به عقب می‌لغزد.

ورودی‌ها

ورودی‌های این ابزار شامل InpCurrencies برای لیست جداشده با کاما مانند USD,EUR (برای همه ارزها خالی بگذارید)، InpHoursAhead برای میزان نگاه به جلو با پیش‌فرض ۴۸، InpHoursBack برای میزان نگاه به عقب جهت گرفتن داده‌های تازه منتشرشده با پیش‌فرض ۳، InpMinImportance با مقادیر ۰ برای هیچ، ۱ برای کم، ۲ برای متوسط و ۳ برای بالا با پیش‌فرض ۲، InpFile برای نام فایل خروجی داخل MQL5\Files، InpRefreshSec برای بازه بازنویسی بر حسب ثانیه با حداقل ۳۰، و InpUtf8 برای خروجی UTF-8 که فقط اگر مصرف‌کننده‌تان کدپیج محلی نیاز دارد خاموش می‌شود.

نکته‌ای درباره زبان

نام رویدادها به زبان ترمینال بازگردانده می‌شوند و MQL5 هیچ راهی برای درخواست زبان دیگر ارائه نمی‌دهد؛ اگر به کلیدی نیاز دارید که بین زبان‌ها و نصب‌های مختلف پایدار باشد، از ستون event_id استفاده کنید که دقیقاً به همین دلیل آنجاست.

عیب‌یابی

اگر فایل خالی بیرون آمد، MT5 تقویم را فقط زمانی پر می‌کند که ترمینال متصل باشد و برخی بروکرها آن را محدود می‌کنند، بنابراین در Tools → Options → Server بررسی کنید که تقویم فعال باشد.

پنج جزئیاتی که اهمیت دارند
تنظیمات اکسپرت CalendarExport

در ادامه هر یک از تنظیمات (Inputs) که کاربر در پنجره‌ی تنظیمات اکسپرت مشاهده می‌کند، به‌صورت آیتم‌به‌آیتم و همراه با توضیح پاراگرافی شرح داده شده است:

گروه اول: — What to include —

این گروه مشخص می‌کند که چه داده‌هایی از تقویم اقتصادی استخراج و در فایل CSV نوشته شوند.

 ارزها (Currencies, comma separated):این پارامتر تعیین می‌کند که کدام ارزها در خروجی گنجانده شوند. کاربر باید کد ارزها را با کاما از هم جدا کند؛ مثلاً USD,EUR,GBP,JPY. اگر این فیلد خالی گذاشته شود، اکسپرت تمام ارزهای موجود در تقویم اقتصادی متاتریدر ۵ را استخراج می‌کند. توجه داشته باشید که هر ارز به کشور مربوطه‌اش وابسته است و اکسپرت برای هر رویداد، ارز کشور میزبان را از طریق CalendarCountryById استخراج و به‌صورت کش‌شده ذخیره می‌کند تا از تماس‌های تکراری با ترمینال جلوگیری شود.

 چند ساعت جلوتر (How many hours ahead to look):این پارامتر بازه‌ی زمانی آینده را مشخص می‌کند. اکسپرت از لحظه‌ی فعلی (بر اساس ساعت سرور معاملاتی، نه آخرین تیک) تا این تعداد ساعت جلوتر را جست‌وجو می‌کند و رویدادهای اقتصادی پیش‌رو را در فایل می‌نویسد. مقدار پیش‌فرض ۴۸ ساعت (دو روز) است که معمولاً برای پوشش رویدادهای مهم هفته کافی است. با افزایش این مقدار، حجم فایل خروجی بیشتر می‌شود.

 چند ساعت عقب (How many hours back):این پارامتر بازه‌ی زمانی گذشته را تعیین می‌کند. هدف اصلی آن، ثبت رویدادهایی است که همین الان منتشر شده‌اند و مقدار واقعی (Actual) آن‌ها تازه در تقویم درج شده است. مقدار پیش‌فرض ۳ ساعت است. اگر این مقدار را صفر بگذارید، فقط رویدادهای آینده در فایل نوشته می‌شوند. اگر آن را بزرگ‌تر کنید، تاریخچه‌ی بیشتری از رویدادها در خروجی ظاهر می‌شود.

 حداقل اهمیت (Minimum importance):این پارامتر سطح اهمیت رویدادها را فیلتر می‌کند و تنها رویدادهایی با اهمیت مساوی یا بالاتر از مقدار وارد شده در خروجی نوشته می‌شوند. مقادیر مجاز عبارت‌اند از:

  • 0 = هیچ (None) — همه‌ی رویدادها حتی بی‌اهمیت
  • 1 = کم (Low)
  • 2 = متوسط (Medium) — مقدار پیش‌فرض
  • 3 = زیاد (High) — فقط رویدادهای بسیار مهم مانند نرخ بهره یا NFP

با مقدار پیش‌فرض 2، رویدادهای کم‌اهمیت حذف می‌شوند و خروجی تمیزتر و کاربردی‌تر خواهد بود. در کد، این فیلتر با شرط if((int)ev.importance < InpMinImportance) continue; اعمال می‌شود.

تنظیمات اکسپرت CalendarExport

گروه دوم: --- Output ---

این گروه مشخص می‌کند که فایل خروجی کجا، با چه فرمتی و با چه فراوانی نوشته شود.

 نام فایل خروجی (Written to this terminal’s MQL5\Files):نام فایل CSV خروجی است که در پوشه‌ی MQL5\Files ترمینال جاری ذخیره می‌شود.

فاصله‌ی بازنویسی (How often the file is rewritten, min 30):این پارامتر فاصله‌ی زمانی (به ثانیه) بین دو بار بازنویسی فایل را مشخص می‌کند. اکسپرت با EventSetTimer یک تایمر تنظیم می‌کند و در هر تیک تایمر، تابع Write() را دوباره اجرا می‌کند. حداقل مقدار مجاز ۳۰ ثانیه است؛ اگر عددی کمتر از ۳۰ وارد شود، به‌صورت خودکار روی ۳۰ تنظیم می‌شود (در کد: InpRefreshSec > 30 ? InpRefreshSec : 30). مقدار پیش‌فرض ۳۰۰ ثانیه (۵ دقیقه) است که برای اکثر کاربردها تعادل مناسبی بین به‌روز بودن و بار روی سیستم فراهم می‌کند.

  • false: فایل با کدپیج محلی ترمینال (ANSI) نوشته می‌شود. این حالت فقط برای ابزارهای قدیمی که UTF-8 را پشتیبانی نمی‌کنند مناسب است، ولی در غیر این صورت ممکن است نام رویدادها در سمت مصرف‌کننده خراب یا غیرقابل‌خواندن شوند.

نکات تکمیلی درباره‌ی خروجی

علاوه بر تنظیمات فوق، اکسپرت یک خط هدر در ابتدای فایل می‌نویسد که شامل زمان آخرین به‌روزرسانی، اختلاف ساعت سرور با GMT و تعداد رویدادها است. این خط به مصرف‌کننده کمک می‌کند تا تشخیص دهد فایل تازه است یا کهنه، و آیا اکسپرت هنوز متصل است یا خیر.

ستون‌های فایل CSV به‌ترتیب عبارت‌اند از:

time_server, currency, importance, event, forecast, previous, actual, event_id

که در آن event_id یک شناسه‌ی پایدار و مستقل از زبان است و برای کلیدگذاری در ابزارهای خارجی کاربرد دارد.

اکسپرت CalendarExport

فارکس ویژه ⭐ VIP
⭐ این فایل ویژه است. برای دانلود، شماره شما باید VIP باشد.
💎 برای اطلاع از نحوه عضویت VIP، اینجا کلیک کنید.

ℹ️ این فایل ویژه است. پس از بررسی شماره، وضعیت اشتراک شما نمایش داده می‌شود.

⚠️ هشدار و سلب مسئولیت

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

معاملات فارکس و سایر بازارهای مالی دارای ریسک بالایی هستند. هوش فعال هیچ‌گونه مسئولیتی در قبال سود، زیان، تصمیمات معاملاتی یا خسارات احتمالی ناشی از استفاده از این اکسپرت‌ها ندارد.

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

راهنمای نصب اندیکاتور و اکسپرت در متاتریدر

 
 

راهنمای ایجاد حساب دمو و ریل ، نصب متاتریدر و اضافه کردن حساب به متاتریدر

 

ثبت نام در لایت فایننس |ثبت نام در وینگو مارکت  | ثبت نام در متاگلد | ثبت نام در ایکس چف

دیدگاهتان را بنویسید

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

ارتباط با پشتیبانی هوش فعال

از طریق روش‌های زیر با ما در ارتباط باشید: