← جميع الشروحات
MT4 API · 4:26

أسعار MT4 المباشرة عبر WebSocket

اتصل، واشترك، واقرأ الأسعار، ثم افصل الاتصال.

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

  1. 0:00

    أسعار MT4 المباشرة عبر WebSocket

    يوضح هذا الدرس كيفية استقبال أسعار ميتاتريدر أربعة مباشرة عبر WebSocket. سنربط حساباً تجريبياً، ونشترك في رمز واحد، ونقرأ رسائل حقيقية، ثم نوقف البث ونفصل اتصال المنصة.

  2. 0:21

    افتح لوحة تحكم API

    افتح إم تي فور نقطة إم آر بي سي نقطة برو. ستفتح لوحة التحكم تلقائياً. اختر Connect Ex من طرق الاتصال. في هذا الدرس نقرأ الأسعار فقط، دون فتح صفقات أو إغلاقها.

  3. 0:41

    اربط الحساب التجريبي

    استخدم Trial أو مفتاح API الخاص بك. أدخل رقم الحساب التجريبي المخصص، وكلمة مرور التداول، واسم خادم الوسيط بدقة. اترك حقل id الاختياري فارغاً لهذا الاتصال الجديد، ثم نفذ الطلب. احتفظ ببيانات الدخول بسرية.

  4. 1:04

    احفظ معرّف المنصة

    في Connect Ex، تحقق من رمز حالة HTTP مئتين، ثم اقرأ رد JSON. إذا احتوى error على خطأ، اقرأ تفاصيله قبل المتابعة. عند النجاح، يحتوي data على terminal Instance Guid. تحفظ لوحة التحكم هذا المعرّف للطلبات التالية وتعرض حالة الاتصال.

  5. 1:30

    اختر رمزاً واحداً

    من قسم الاشتراكات، اختر On Symbol Tick. أبقِ معرّف الاتصال نفسه. أدخل الاسم الدقيق للرمز لدى الوسيط في symbol Names، وهنا نستخدم EURUSD. قد تختلف الأسماء واللواحق بين الوسطاء. اضغط زر الاتصال بالبث.

  6. 1:54

    تابع الأسعار المباشرة

    تعني علامة متصل أن WebSocket مفتوح. تتحدث بطاقة السعر مع وصول كل تحديث. الإطارات المستلمة هي رسائل الخادم الحقيقية. هذا بث مستمر، وليس طلبات HTTP متكررة. تحقق من error في كل رسالة قبل قراءة data نقطة symbol Tick.

  7. 2:20

    افهم bid وask

    داخل symbol Tick، يحدد symbol الأداة المالية. Bid هو سعر البيع، وask سعر الشراء. الفرق بينهما هو السبريد. هذه أسعار وليست تأكيداً لتنفيذ صفقة. قد تكون last وvolume صفراً إذا لم يقدم الوسيط بيانات آخر صفقة لهذه الأداة.

  8. 2:44

    استخدم توقيت UTC

    لتوحيد الوقت بين الأنظمة، استخدم time U T C، أو time M S C U T C للمللي ثانية. في هذه اللقطة، يتقدم توقيت الوسيط بساعتين عن حقل UTC الصريح. لا تعتبر توقيت الوسيط UTC لمجرد انتهاء النص بحرف Z. وقت استلام الإطار قيمة مستقلة.

  9. 3:09

    مثال JavaScript المقابل

    يستخدم مثال JavaScript عنوان WebSocket الآمن والرمز نفسه. لا يتيح WebSocket في المتصفح تعيين ترويسات مصادقة مخصصة، لذلك نمرر مفتاح API ومعرّف المنصة ضمن معاملات العنوان. لا تشارك العنوان الكامل. حلل JSON، وعالج error أولاً، ثم اقرأ السعر ووقت UTC.

  10. 3:35

    أوقف الاشتراك

    عند الانتهاء، اضغط فصل الاتصال في لوحة البث. وفي الكود أغلق WebSocket. ينهي هذا الاشتراك، لكنه لا يفصل اتصال المنصة نفسها. غياب الرسائل الجديدة لا يعني دائماً وجود خطأ. تحقق من الاتصال، واسم الرمز، وهل ينشر الوسيط الأسعار حالياً.

  11. 4:01

    افصل اتصال المنصة

    اختر Disconnect ونفذ الطلب باستخدام المعرّف نفسه. تحقق من رمز حالة HTTP مئتين وحقل error. يحتوي رد النجاح هنا على معرّف المنصة ومدة تشغيلها. تتغير الحالة في الأعلى إلى غير متصل. انتهى الآن الاشتراك وجلسة المنصة معاً.