يحتفظ MetaTrader 4 بكل صفقة تنفذها، لكنه يبقيها داخل المنصة. يستطيع SetupBook سحبها إلى يوميتك من تلقاء نفسه: ملف صغير اسمه SetupBookSync يعمل داخل MT4 ويرسل كل صفقة إلى SetupBook لحظة إغلاقها. لا تكتب شيئًا. يستغرق الإعداد نحو عشر دقائق، وتقوم به مرة واحدة.
يعرض هذا الدليل كل نقرة، بالصور، على Windows وعلى Mac. إذا كنت تستخدم MetaTrader 5 فاتبع دليل MetaTrader 5 بدلًا منه؛ الخطوات متشابهة تقريبًا، لكن الملف مختلف.
قبل أن تبدأ
- حساب SetupBook. المزامنة جزء من Pro، وكل يومية تبدأ بـ 14 يومًا منه: ابدأ 14 يومًا مجانًا.
- MetaTrader 4 مثبّت على حاسوبك ومسجَّل الدخول فيه إلى حساب الوسيط. تجريبي أو حقيقي، أي وسيط، الإصدار (build) 600 أو أحدث (أي إصدار منذ 2014). لا تستطيع منصة الويب ولا تطبيق الهاتف تشغيل الملف؛ تحتاج إلى برنامج سطح المكتب.
- عشر دقائق.
SetupBookSync يقرأ فقط. لا يستطيع فتح أمر أو تغييره أو إغلاقه، ولا يرى كلمة مرورك أبدًا. السر الوحيد الذي يحمله هو الـ token من الخطوة 1، وذلك الـ token لا يستطيع الكتابة إلا في يوميتك أنت. الكود المصدري منشور على /ea/SetupBookSync.mq4، فيستطيع أي شخص التحقق مما يفعله.
1. أنشئ الاتصال وانسخ الـ token
في SetupBook افتح الحسابات ← الاتصالات واضغط إضافة اتصال. اختر MetaTrader 4، واترك الحساب على إنشاء من حساب المنصة، واضغط أنشئ الـ token واعرضه.
تعرض نافذة token المزامنة الخاص بك، وهو كود طويل يبدأ بـ sbk_. اضغط نسخ. يُعرض الـ token هذه المرة فقط؛ إذا فقدته فافتح الاتصال لاحقًا واضغط token جديد. في النافذة نفسها اضغط تنزيل SetupBookSync.ex4 واحتفظ بالملف في مكان يسهل العثور عليه، على سطح المكتب مثلًا.
2. ضع SetupBookSync.ex4 في مجلد Experts
لا يرى MetaTrader إلا البرامج الموجودة داخل مجلد بياناته. في MT4 افتح File → Open Data Folder، وادخل إلى MQL4 ثم Experts، وأسقط SetupBookSync.ex4 هناك. الملف يأتي مترجَمًا (compiled)، فلا تحتاج إلى MetaEditor ولا إلى أي برمجة.
على Windows
يفتح File → Open Data Folder المكان الصحيح مباشرة، وهو عادة مجلد تحت C:\Users\<اسمك>\AppData\Roaming\MetaQuotes\Terminal. افتح MQL4 → Experts والصق الملف.
على Mac
تعمل نسخة Mac من MetaTrader 4 داخل طبقة Windows صغيرة، لذلك يفتح File → Open Data Folder نافذة بنمط Windows تبدأ في Desktop. لا تبحث عن المجلد هناك. اضغط My Computer → (C:) → Program Files (x86) → MetaTrader 4 → MQL4 → Experts وأسقط الملف فيه.
في Finder يقع المجلد نفسه في ~/Library/Application Support/net.metaquotes.wine.metatrader4/drive_c/Program Files (x86)/MetaTrader 4/MQL4/Experts. اضغط Cmd+Shift+G في Finder والصق هذا المسار إذا كنت تفضّل ذلك. نسخ Mac الخاصة بالوسطاء تستخدم مجلدًا مشابهًا يحمل اسم الوسيط.
عد إلى MT4 وافتح لوحة Navigator (View → Navigator، أو Ctrl+N)، واضغط بزر الفأرة الأيمن على Expert Advisors واختر Refresh. يظهر SetupBookSync في القائمة. إن لم يظهر، أغلق MetaTrader وافتحه مجددًا.
3. اسمح بـ setupbook.io في Options
يحجب MetaTrader كل طلب إنترنت يصدر من أي برنامج ما لم تسمح بالعنوان أولًا. افتح Tools → Options، وانتقل إلى تبويب Expert Advisors، وفعّل Allow WebRequest for listed URL، واضغط مرتين على السطر الفارغ تحته، واكتب https://setupbook.io واضغط OK.
اكتب العنوان كما هو تمامًا: https://setupbook.io، بلا www، ولا شيء بعد .io. هذه هي الخطوة التي يتجاوزها الناس أكثر من غيرها؛ وبدونها يقول الرسم البياني cannot reach.
4. فعّل AutoTrading وضع الملف على رسم بياني
انظر إلى شريط الأدوات: يجب أن يكون زر AutoTrading أخضر. إذا كان أحمر فاضغطه مرة واحدة. بدونه لا يشغّل MetaTrader أي Expert Advisor على الإطلاق، بما فيه برنامجنا.
الآن اسحب SetupBookSync من Navigator إلى أي رسم بياني مفتوح. لا يهم الرمز ولا الإطار الزمني. تُفتح نافذة: انتقل إلى تبويب Inputs، واضغط مرتين على القيمة بجوار SetupBook sync token، والصق الـ token واضغط OK.
تعرض الزاوية العلوية اليسرى من الرسم البياني ما يفعله SetupBookSync. وتعرض الزاوية العلوية اليمنى اسمه مع وجه مبتسم صغير. الوجه المبتسم يعني أنه يعمل؛ والوجه المشطوب يعني أن AutoTrading متوقف أو أن البرنامج لم يُسمح له بالعمل.
5. اعرض سجل الحساب كاملًا
لا يسمح MetaTrader 4 لأي برنامج بأن يرى سوى الصفقات الظاهرة في تبويب Account History، وافتراضيًا هي صفقات الأيام القليلة الأخيرة. في لوحة Terminal في الأسفل (Ctrl+T) اضغط Account History، ثم اضغط بزر الفأرة الأيمن في أي مكان من القائمة واختر All History. عندها يرسل SetupBookSync كل شيء.
6. تحقق من وصول الصفقات
خلال ثوانٍ قليلة تتغير الحالة في زاوية الرسم البياني إلى عدد الصفقات المرسلة. في SetupBook افتح الحسابات ← الاتصالات: تعرض البطاقة الآن الوسيط ورقم الدخول، وشارة تجريبي إذا كان الحساب تجريبيًا، ووقت آخر مزامنة. أُنشئ لك حساب SetupBook يحمل اسم الوسيط ورقم الدخول، وصفقاتك تحت الصفقات.
إذا كان سجل الحساب فارغًا، على حساب تجريبي جديد تمامًا مثلًا، فافتح صفقة صغيرة واحدة وأغلقها. تظهر في SetupBook خلال ثوانٍ.
ماذا يحدث بعد الإعداد
- تصل الصفقة الجديدة خلال نحو خمس ثوانٍ من إغلاقها، ما دام MetaTrader مفتوحًا.
- يُحدَّث الوقف والهدف لمراكزك المفتوحة مرة كل دقيقة، فالوقف الذي حرّكته يظهر محرَّكًا في اليومية.
- حين يكون MetaTrader مغلقًا لا يُرسل شيء. وفي المرة التالية التي تفتحه فيها يرسل SetupBookSync ما فاتك.
- الحقول التي جاءت من MetaTrader (الرمز، الاتجاه، الأسعار، الحجم، العمولة، الـ swap، صافي النتيجة) مقفلة في اليومية وتبقى دقيقة. وكل ما تضيفه أنت (الخطة، جودة النموذج، الأخطاء، الملاحظات، لقطات الشاشة) يبقى لك.
- تجريبي أو حقيقي يُقرأ من المنصة. حساب شركة التمويل يصل بوصفه حقيقي؛ غيّر نوع الحساب إلى تمويل في SetupBook إذا أردت الحد اليومي ومتابعة التحدي.
- يمكنك إيقاف المزامنة في أي وقت: أزل SetupBookSync من الرسم البياني، أو اضغط token جديد أو احذف الاتصال في SetupBook. تبقى الصفقات التي وصلت إلى اليومية وتصير قابلة للتعديل.
إذا لم يعمل شيء
الأسئلة الشائعة
هل هو آمن؟ هل يستطيع SetupBookSync التداول على حسابي؟
لا. يقرأ فقط سجل الحساب والمراكز المفتوحة. لا يحوي أي كود يضع أمرًا أو يغيّره أو يغلقه، ولا يرى كلمة مرورك أبدًا. السر الوحيد الذي يحمله هو الـ token، وهو لا يستطيع الكتابة إلا في يومية SetupBook الخاصة بك. الكود المصدري منشور، فيستطيع أي شخص التحقق.
هل يعمل مع كل وسيط؟
نعم. يحتاج إلى MetaTrader 4 الإصدار 600 أو أحدث، وهو ما يقدمه كل وسيط منذ 2014. الحسابات التجريبية والحقيقية تعمل بالطريقة نفسها.
هل يعمل على Mac؟
نعم، مع نسخة Mac من MetaTrader 4 من MetaQuotes أو من وسيطك. الفرق الوحيد هو مكان مجلد Experts، الموضح في الخطوة 2.
هل يمكنني ربط أكثر من حساب MT4؟
نعم. أنشئ اتصالًا لكل حساب في SetupBook، لكل منها الـ token الخاص به، وضع SetupBookSync على رسم بياني في كل منصة. يحصل كل حساب على حساب SetupBook خاص به.
ماذا يحدث حين يكون حاسوبي مغلقًا؟
لا يُرسل شيء ما دام MetaTrader مغلقًا. حين تفتحه مجددًا تستكمل المزامنة من حيث توقفت. إذا أردت أن تصل الصفقات وحاسوبك مغلق، فشغّل MetaTrader على VPS.
هل أحتاج إلى MetaEditor أو إلى أي برمجة؟
لا. ملف MetaTrader 4 يأتي مترجَمًا. كل ما تفعله هو نسخه إلى مجلد.
ما وظيفة بقية مدخلات Expert Advisor؟
اتركها كما هي. Sync endpoint هو عنوان SetupBook. Check every (seconds) هو عدد الثواني بين كل تحديث للمراكز المفتوحة، وافتراضيًا ستون. Deals per request هو حجم الصفحة في أول مزامنة كاملة. Log every request يطبع كل طلب وجوابه في تبويب Experts، ولا يفيد إلا حين يفشل شيء. الكود المصدري الكامل منشور على /ea/SetupBookSync.mq4، فيمكنك قراءة ما يخرج من منصتك بالضبط.
هل يكلّف شيئًا؟
المزامنة جزء من Pro. وكل يومية تبدأ بـ 14 يومًا من Pro: تُطلب بطاقة عند التسجيل، ولا يُخصم شيء طوال 14 يومًا. وإن ألغيت قبلها بقيت على الخطة المجانية.
هل تفضّل كتابة الصفقات يدويًا أو استيراد ملف تقرير؟ كلاهما ما زال يعمل: انظر دليل الاستخدام ودليل الاستيراد. ولمعرفة كيف ترتبط المنصات الأخرى اقرأ نظرة عامة على كل الاتصالات.