خطواتك الأولى في وحدة تحكم MT4.

الخطوات مكتوبة

1. 0:00

   خطواتك الأولى في وحدة تحكم MT4.

   يوضح هذا الدرس كيفية الاتصال بمنصة MT4، وقراءة بيانات الحساب، وفتح صفقة تجريبية وإغلاقها، ثم قطع اتصال الطرفية.

2. 0:15

   افتح وحدة تحكم MT4.

   افتح إم تي فور دوت إم آر بي سي دوت برو. ستفتح وحدة التحكم تلقائياً. تتضمن صفحة البدء دليلاً متدرجاً وبحثاً عن الطرق ودروساً وموارد للمطورين. في هذا المثال، اختر ConnectEx من القائمة الجانبية.

3. 0:40

   اختر مفتاح API.

   يحدد مفتاح API صلاحية وصولك إلى MetaRPC. استخدم TRIAL لجلسة تجريبية، أو أدخل مفتاحك الخاص في الشريط العلوي. تخضع التجربة لحدود السعة والاستخدام. حافظ على سرية مفتاحك. فهو يختلف عن معرّف الطرفية الذي تحصل عليه بعد الاتصال.

4. 1:06

   اتصل بالحساب التجريبي.

   أدخل في ConnectEx رقم دخول الحساب التجريبي وكلمة مرور التداول واسم خادم الوسيط بدقة. نستخدم هنا FreshForex Demo. اترك حقل id الاختياري فارغاً. نفّذ الطلب وانتظر النتيجة. بيانات الحساب مخفية في هذا التسجيل.

5. 1:32

   احتفظ بمعرّف الطرفية.

   اقرأ الاستجابة. رمز حالة HTTP مئتان يعني أن API أعاد استجابة. افحص error أولاً. عند نجاح الاتصال، يتضمن data.terminalInstanceGuid معرّف الطرفية. تحفظه وحدة التحكم في الشريط العلوي وترسله في ترويسة id للطلبات التالية. وهو لا يحل محل مفتاح API.

6. 1:58

   اقرأ بيانات الحساب.

   نفّذ AccountSummary. راجع الرصيد وحقوق الملكية والعملة ووضع التداول في الحساب. يستخدم هذا التسجيل حساباً تجريبياً يسمح بالتداول. قبل إرسال أي أمر، تأكد من أنك تستخدم الحساب المطلوب.

7. 2:20

   جهّز صفقة تجريبية صغيرة.

   اختر OrderSend وأدخل رمزاً متاحاً في حسابك. نستخدم هنا BTCUSD وعملية OC_OP_BUY وحجماً قدره صفر فاصلة صفر واحد لوت. قد يختلف اسم الرمز والحد الأدنى للحجم حسب الوسيط. راجع خصائص الرمز للتأكد.

8. 2:46

   أرسل مرة واحدة ثم اقرأ النتيجة.

   نفّذ الطلب مرة واحدة. في استجابة MT4 الناجحة هذه، يحدد data.ticket رقم الصفقة الجديدة. قيمة data.volume هي صفر فاصلة صفر واحد، ويعرض data.price سعر الفتح. احتفظ بالرقم للخطوات التالية. إذا ظهر خطأ، اقرأ تفاصيله قبل المتابعة.

9. 3:12

   افحص المركز المفتوح.

   نفّذ OpenedOrders. ابحث داخل data.orderInfos عن الرقم الذي أعاده OrderSend. راجع الرمز ونوع الأمر وعدد اللوتات وسعر الفتح. يحتوي هذا المثال على مركز شراء واحد في BTCUSD. يمكنك رؤيته أيضاً في جدول المراكز المباشر.

10. 3:38

    أغلق المركز الذي فتحناه.

    اختر OrderCloseDelete. أدخل الرقم من استجابة OrderSend الناجحة، واضبط lots على صفر فاصلة صفر واحد لإغلاق الحجم بالكامل. اترك سعر الإغلاق فارغاً لاستخدام السعر الحالي. راجع الرقم والحجم ثم نفّذ الطلب.

11. 4:03

    تحقق من نتيجة الإغلاق.

    لا تتضمن الاستجابة خطأ، وقيمة mode هي OCD_MARKET_ORDER. هذه نتيجة إغلاق أمر سوق. استدعِ OpenedOrders مرة أخرى للتحقق من الحجم المتبقي. يفيد ذلك أيضاً عند الإغلاق الجزئي. هنا طلبنا إغلاق الحجم بالكامل.

12. 4:29

    تأكد من عدم وجود أوامر متبقية.

    أعاد استدعاء OpenedOrders التالي قائمة orderInfos فارغة. لا توجد مراكز مفتوحة أو أوامر معلقة على هذا الحساب التجريبي. القائمة الفارغة نتيجة صحيحة وناجحة. أُغلقت الصفقة التي فتحناها.

13. 4:52

    اقطع الاتصال عند الانتهاء.

    نفّذ Disconnect باستخدام معرّف الطرفية الحالي. تأكد من عدم وجود خطأ. أصبحت الطرفية غير متصلة. قطع الاتصال وحده لا يغلق المراكز، ولهذا أغلقنا الصفقة وفحصنا OpenedOrders أولاً.

14. 5:16

    استخدم الخطوات نفسها في الكود.

    أكملت خطوات العمل في وحدة تحكم MT4. استخدم أمثلة الكود كنقطة بداية لتطبيقك، وحافظ على سرية مفتاح API، وافحص نتيجة كل طلب. لمعالجة المشكلات، افتح دليل نتائج الطريقة أو درس معالجة أخطاء MT4.