دليل البدء السريع لـ MT5 REST API
اختر لغة برمجة وشغّل المثال الكامل: أنشئ حساباً تجريبياً جديداً، واتصل به، واقرأ بياناته، وافتح صفقة تجريبية على EURUSD بحجم 0.01 لوت، واعرضها، ثم أغلقها وتحقق من إغلاقها وافصل الاتصال. يُستخدم رصيد تجريبي فقط للتداول. استخدام مفتاح API الخاص بك يستهلك رصيد الخدمة.
دورة تشغيل العرض التجريبي كاملة
/DemoAccount/Openأنشئ حسابًا تجريبيًا لدى MetaQuotes. احتفظ ببيانات الدخول التي تصلك بسرية. هذه الخطوة لا تُودع أموالًا في حساب تداول حقيقي.
/ConnectExاربط الحساب التجريبي واحتفظ بمعرّف المنصة. مفتاح API يحدد حسابك في MRPC، بينما يحدد معرّف المنصة هذا الاتصال.
/AccountSummaryاقرأ بيانات الحساب المتصل. تعني الاستجابة الناجحة أن التكامل يستطيع جلب البيانات؛ ولا ينفذ هذا الطلب أي صفقة.
/OrderSendشراء 0.01 لوت من EURUSD. تحقّق من رمز استجابة الوسيط؛ نجاح HTTP 200 وحده لا يؤكد تنفيذ الصفقة.
/OpenedOrdersتحتوي positionInfos على المراكز المفتوحة، وopenedOrders على الأوامر المعلقة. استخدم تذكرة المركز الواردة في هذه الاستجابة لإغلاقه.
/OrderClose → /OpenedOrdersأغلق المركز باستخدام تذكرته وحجمه، ثم اطلب OpenedOrders مجددًا للتأكد من أنه لم يعد مفتوحًا.
/Disconnectأغلق الاتصال حتى إذا فشل طلب سابق. تتضمن الأمثلة القابلة للتنزيل خطوات لتحرير الموارد، وتطلب انتهاء صلاحية المنصة بعد خمس دقائق كإجراء احتياطي.
المصادقة وقراءة الحساب
أرسل مفتاح API في ترويسة APIKey. تُرجع ConnectEx القيمة terminalInstanceGuid: استخدمها في ترويسة id عند استدعاء AccountSummary وDisconnect. هذان معرّفان مختلفان. يقرأ الطلب أدناه حسابًا متصلًا بالفعل.
curl --request GET "https://mt5.mrpc.pro/AccountSummary" \
--header "APIKey: YOUR_API_KEY" \
--header "id: YOUR_TERMINAL_ID"
قطع الاتصال بعد الطلب
استدعِ Disconnect داخل كتلة finally، حتى عند فشل القراءة. يطلب العرض مدة صلاحية خمس دقائق للطرفية كإجراء احتياطي للتنظيف. نزّل المثال الكامل أعلاه بلغة البرمجة التي تستخدمها.
حل مشكلات فشل الاتصال
تحقق من مفتاح API واسم خادم الوسيط ورقم الحساب وكلمة المرور. إذا فشلت ConnectEx دون إرجاع معرّف الطرفية، فلا تنتقل إلى AccountSummary. تحقق من رصيد الخدمة وحدود الفترة التجريبية، ولا تكشف بيانات الدخول في السجلات.
شغّل عرضًا مباشرًا →