واجهة MetaTrader 5 Web API هي الواجهة التي توفّرها MetaQuotes على مستوى الخادم لربط خادم تداول MT5 بالمواقع الإلكترونية وأنظمة CRM وغيرها من أنظمة الشركة. يسجّل التطبيق الدخول بحساب مدير (Manager)، ويستطيع إدارة المستخدمين والأرصدة والمجموعات والرموز والأوامر والصفقات والعمليات المنفّذة والأسعار اللحظية والرسوم البيانية. لكنها لا تربط مزوّدي السيولة ولا تبث دفتر أوامر مزوّد السيولة، فهذه مهام واجهات MT5 أخرى.
ما هي MetaTrader 5 Web API؟
واجهة MetaTrader 5 Web API هي الواجهة التي توفّرها MetaQuotes لربط خادم تداول MT5 بخدمات الويب الخاصة بالوسيط: بوابة العملاء، ونظام CRM، ومعالجة المدفوعات، والتقارير، وواجهات التداول المخصصة. وهي تعمل مقابل الخادم لا مقابل منصة المتداول، وتصادق بصفة مدير، أي بنوع الحساب نفسه الذي يستخدمه موظفو المكتب الخلفي في منصة MT5 Manager.
تعريف MetaQuotes لها من سطر واحد، وهو تعريف دقيق: الواجهة مخصصة للربط مع موارد الويب وغيرها من خدمات الشركة. وكل ما في هذه الصفحة يتناول ما يعنيه ذلك في الواقع العملي. أما المرجع التقني الكامل فموجود على موقع الدعم لدى MetaQuotes، ويتاح لحاملي التراخيص بعد تسجيل الدخول؛ فإن كنت تحمل ترخيص خادم MT5 أو تعمل لدى من يحمله، فذلك المرجع هو الحَكَم على أي شيء مكتوب هنا.
“تُستخدم Web API لربط المنصة بموارد الويب وغيرها من خدمات الشركة.”
ما الذي يميّز Web API عن واجهات MetaTrader 5 الأخرى؟
تنشر MetaQuotes خمس واجهات برمجية لـ MT5، ولكل منها وظيفة مختلفة. فـ Web API هي الواجهة التي تخاطب الخادم من الخارج عبر الشبكة، أما الأخرى فإما تعمل داخل الخادم، أو تربطه بالأسواق، أو توسّع تقاريره. والتعريفات الواردة في العمود الثاني مقتبسة من صفحة MetaQuotes الموجهة للوسطاء.
| الواجهة | تعريف MetaQuotes | أين تعمل شيفرتك | الاستخدام المعتاد لدى الوسيط |
|---|---|---|---|
| Web API | "تُستخدم لربط المنصة بموارد الويب وغيرها من خدمات الشركة" | على خادمك الخاص، متصلةً عبر الشبكة | نظام CRM، وبوابة العملاء، والمدفوعات، ومنصة WebTrader مخصصة |
| Manager API | "تتيح لك تطوير أدوات إدارة وتحكم مخصصة، بل ومنصة مدير خاصة بك" | في تطبيق مدير يتصل بالخادم | أدوات المكتب الخلفي، وأدوات مكتب التداول وإدارة المخاطر |
| Server API | "تساعدك على إضافة مزيد من الوظائف إلى MetaTrader 5 Trade Server وMetaTrader 5 History Server" | داخل خادم MT5 كإضافة (Plugin) | قواعد مخصصة على كل صفقة، والمكافآت، ومنطق النسخ |
| Gateway API | "تُستخدم لربط MetaTrader 5 بأنظمة تداول أخرى وإنشاء مصادر بيانات مخصصة" | في بوابة (Gateway) متصلة بالمنصة | مزوّدو السيولة، والبورصات، ومصادر البيانات |
| Report API | "توسّع التقارير التي تنتجها خوادم تداول MetaTrader 5" | داخل مكوّن التقارير | تقارير مخصصة للجهات الرقابية والإدارة |
هل MT5 Web API واجهة REST أم WebSocket؟
تعمل MT5 Web API بنمط الطلب والاستجابة: يرسل تطبيقك أمرًا وينتظر الرد. ويعني ذلك في الإصدارات الحالية طلبات HTTPS إلى مسارات مثل /api/user/get أو /api/tick/last بردود JSON، إلى جانب بروتوكول ثنائي أقدم عبر اتصال دائم (Socket) تستخدمه الشيفرة النموذجية التي تنشرها MetaQuotes نفسها. ونحن نستخدم الاثنين، كلًّا لمهمة مختلفة.
لكنها ليست واجهة WebSocket. فلا شيء في Web API يرسل إليك سعرًا أو تغيّرًا في صفقة من تلقاء نفسه؛ وإن أردت تحديثات حية، فعليك أن تطلبها بالوتيرة التي تختارها. وحين تقرأ أن "MT5 Web API لدى مزوّد ما تعتمد على WebSocket"، فالمقصود عادةً أنه بنى طبقة WebSocket فوقها، وهذا بالضبط ما فعلناه في منصة WebTrader التي تحمل علامتك.
وثمة لبس آخر يستحق التوضيح مبكرًا. فعدة خدمات تبيع "MT5 API" تتصل بحساب المتداول عبر منصة تعمل على سحابتها، أو عبر حزمة Python التي توفّرها MetaQuotes لمنصة سطح المكتب. هذه أدوات على مستوى الحساب، موجهة للمتداولين وخدمات الإشارات. أما Web API فتعمل على مستوى الوسيط: فهي ترى كل حساب على الخادم يُسمح للمدير برؤيته.
كيف تعمل المصادقة في MT5 Web API؟
يصادق تطبيقك بصفة مدير في MT5 عبر آلية التحدي والاستجابة (Challenge-Response)، فلا تنتقل كلمة مرور المدير نصًّا صريحًا أبدًا. وفي صيغة HTTPS التي نستخدمها، تتم العملية على النحو التالي:
- البدءيستدعي التطبيق أمر بدء المصادقة باسم دخول المدير، معرّفًا نفسه بأنه وكيل Web API. فيرد الخادم بتحدٍّ عشوائي.
- الإجابةيدمج التطبيق تجزئة كلمة المرور (Hash) مع ذلك التحدي، ويرسل النتيجة، ويضيف تحديًا عشوائيًا خاصًا به.
- التحقق من الخادميجيب الخادم عن تحدي العميل، فيتحقق التطبيق من الإجابة، وبذلك يكون الطرفان قد أثبتا معرفتهما بكلمة المرور.
- الحفاظ على الجلسةترتبط الجلسة المصادَق عليها بالاتصال القائم تحتها. فإذا انقطع الاتصال، تعيد المصادقة من جديد.
ماذا يمكنك أن تبني بـ MetaTrader 5 Web API؟
يمكن بناء جميع الأنظمة التي يتعامل معها عملاء الوسيط تقريبًا على Web API، لأنها تصل إلى العناصر التي تهم هذه الأنظمة: المستخدمين، والحسابات، والمجموعات، والرموز، والأوامر، والصفقات، والعمليات المنفّذة، وسجل الأسعار. ويربط الجدول التالي مجالات الأوامر التي نستخدمها بالمهام التي تخدمها.
| المجال | ما يغطيه | الاستخدام المعتاد |
|---|---|---|
| المستخدمون والحسابات | إنشاء الحسابات وتعديلها وحذفها وقراءتها؛ التحقق من كلمات المرور أو تغييرها؛ قراءة الرصيد وحقوق الملكية (Equity) والهامش | فتح الحساب بعد إجراءات اعرف عميلك (KYC) في نظام CRM، وإعادة تعيين كلمات المرور، ولوحات البوابة |
| عمليات الرصيد | الإيداع والسحب والائتمان والتصحيحات على الحساب | إضافة إيداع البطاقة أو التحويل البنكي إلى الحساب تلقائيًا |
| المجموعات والرموز | قراءة إعدادات المجموعات والرموز وصيانتها | عرض مواصفات العقود والهامش وأوقات التداول الصحيحة في واجهة العميل |
| الأوامر والصفقات والعمليات المنفّذة والسجل | بيانات التداول المفتوحة والتاريخية، بما في ذلك الاستعلامات المجمّعة لحسابات عديدة | سجل التداول، وكشوف الحساب، وحساب عمولات الوسطاء المعرّفين (IB) |
| الأسعار والرسوم البيانية | آخر الأسعار اللحظية، وإحصاءاتها، وسجلها، وشموع الرسوم البيانية | عروض الأسعار والرسوم البيانية في منصة WebTrader أو تطبيق الجوال |
| طلبات التداول | طلبات تُنفَّذ على الخادم نيابةً عن الحساب، مع رمز للنتيجة | فتح الأوامر وتعديلها وإغلاقها من واجهة عميل مخصصة |
| البريد والأخبار | البريد الداخلي والأخبار المرسلة إلى المنصات | رسائل الخدمة إلى العملاء |
ما الذي لا تستطيع MT5 Web API فعله؟
لا تستطيع Web API ربط خادمك بالسيولة، ولا تشغيل شيفرة داخل الخادم، ولا إرسال البيانات إليك من تلقاء نفسها. وهذه الحدود مقصودة في التصميم، إذ توجد واجهات MetaTrader 5 أخرى لكل مهمة من هذه المهام.
- لا اتصال بالسيولة. تصل الأسعار من البنوك أو مزوّدي Prime-of-Prime عبر بوابة (Gateway)، أو جسر سيولة، أو Ultency؛ راجع صفحتي MT5 Gateway API وربط مزوّدي السيولة.
- لا دفتر أوامر لمزوّد السيولة ولا عمق للسوق. تمنحك Web API آخر الأسعار اللحظية وإحصاءاتها لكل رمز، لكنها لا تبث الدفتر المجمّع من مزوّديك، لذا تعرض واجهة العميل المبنية عليها سعري العرض والطلب فقط، لا سلّم عمق السوق.
- لا منطق داخل الخادم. القواعد التي يجب أن تُطبَّق على كل صفقة قبل تنفيذها تحتاج إلى إضافة مبنية على Server API. فتطبيق Web API لا يرى إلا ما حدث بالفعل.
- لا إرسال تلقائي للتحديثات. كل تحديث هو طلب؛ والأسعار والصفقات الحية تعني استطلاع الخادم (Polling) بوتيرة تختارها أنت ويتحملها الخادم.
- لا تقارير مخصصة على مستوى الخادم. توسيع التقارير التي ينتجها خادم التداول نفسه من مهام Report API.
كيف تستخدم FXUP واجهة MT5 Web API في منصة WebTrader؟
لا تتصل منصة WebTrader وتطبيقات الجوال لدينا بـ MT5 مباشرة أبدًا. بل تتصل عبر WebSocket آمن بواجهة خلفية مكتوبة بلغة Go، وهذه الواجهة الخلفية هي التي تخاطب خادم MT5 عبر Web API باستخدام البروتوكول الثنائي وطلبات HTTPS معًا. فيرى العميل تحديثات تصله فورًا، بينما يرى خادم MT5 عددًا صغيرًا ومتوقعًا من جلسات المدير.
يمكنك تجربة النتيجة في العرض التجريبي لمنصة WebTrader والعرض التجريبي لتطبيق الجوال، وكلاهما متصل ببيئة MT5 تجريبية حقيقية. وFXUP جهة تطوير مستقلة لا ترتبط بشركة MetaQuotes، ونبني على الواجهات المنشورة كأي مطوّر ربط آخر. ويستخدم نظام CRM الخاص بنا الواجهة الخلفية نفسها، كما نعمل مع أنظمة CRM لدى شركائنا، ونقترح ما يناسب إعداد الوسيط منها.
استطلاع مجمّع
حلقة واحدة تطلب من MT5 الأسعار اللحظية والصفقات والأوامر وأرقام الحسابات كل 100 ملّي ثانية باستعلامات مجمّعة، فلا يزداد الحمل على الخادم بازدياد عدد المستخدمين المتصلين.
إرسال مخصص لكل عميل
لا يتلقى كل عميل متصل إلا الرموز والحسابات التي اشترك فيها، ولا تُعاد الأجزاء التي لم تتغير، وتُضغط الرسائل الكبيرة.
تخزين السجل مؤقتًا
يُخزَّن سجل الرسوم البيانية مؤقتًا على القرص ويُحمَّل عند الحاجة، فلا يضطر المتداول الذي يتصفح سنوات من شموع H1 إلى استدعاء خادم MT5 في كل مرة.
سلامة التداول
يُستبعد الأمر المطابق لأمر آخر لا يزال قيد التنفيذ، ولا يعيد الخادم ولا التطبيقات إرسال الصفقة تلقائيًا بعد انتهاء المهلة؛ فالتنفيذ المزدوج أسوأ من إعادة محاولة يقررها المتداول بنفسه.
كيف تُنفَّذ الصفقات عبر Web API؟
الصفقة عبر Web API طلب يُنفَّذ على الخادم نيابةً عن حساب العميل، تليه نتيجة. يرسل تطبيقك الطلب، ويتلقى معرّفًا، ثم يقرأ النتيجة: رمز إرجاع مثل 10009 (تم التنفيذ) أو 10008 (تم وضع الأمر)، أو رفضًا بسبب مستويات إيقاف غير صالحة، أو إغلاق السوق، أو عدم كفاية الأموال.
ويترتب على ذلك أمران عمليان. أولهما أن صلاحيات العميل نفسه تظل سارية: فإعدادات المجموعة، وأنماط تداول الرموز، ومستويات الإيقاف، والهامش يفرضها الخادم لا واجهة العميل، والكلمة الأخيرة للخادم. وثانيهما أن انتهاء المهلة لا يعني فشل الأمر. فإن لم يصل الرد، فالتصرف السليم هو مراجعة الصفقات والسجل قبل أي خطوة أخرى. وتخبر واجهاتنا المتداول بأن النتيجة غير مؤكدة بدلًا من إرسال الأمر نفسه مرة أخرى.
والطوابع الزمنية تفصيل آخر يوقع الفرق في الخطأ. إذ يسجّل MT5 الأوقات بالمنطقة الزمنية المضبوطة على خادم التداول، وكل ما تعرضه للعملاء أو تخزّنه في نظام CRM ينبغي تحويله إلى توقيت UTC الفعلي مرة واحدة، وفي موضع واحد.
ما مدى أمان الربط عبر MT5 Web API؟
تستخدم Web API نفسها مصادقة التحدي والاستجابة وتدعم الجلسات المشفّرة، ومعظم المخاطر المتبقية تكمن في طريقة تعامل مطوّر الربط مع حساب المدير. فمدير Web API يستطيع في أحيان كثيرة تحريك الأموال وتعديل الحسابات، لذا عامل بيانات دخوله معاملة مفاتيح حساب بنكي. وتذكر MetaQuotes في صفحتها الموجهة للوسطاء أن تبادل البيانات بين مكونات النظام يجري عبر اتصال مشفّر، وأنظمتك تحتاج إلى الانضباط نفسه.
- خصّص للربط حساب مدير مستقلًا لا يملك إلا الصلاحيات والمجموعات التي يحتاجها، ولا تستخدم أبدًا حساب دخول أحد موظفي مكتب التداول.
- حدّد المواقع التي يمكن لهذا المدير الاتصال منها، واحفظ بيانات الدخول في مخزن أسرار (Secrets Store) لا في الشيفرة المصدرية.
- لا تكشف Web API أبدًا للمتصفحات أو التطبيقات. فالعملاء يتصلون بواجهتك الخلفية، وهي التي تتحقق من كل طلب مقابل حساب العميل نفسه.
- ضع من جهتك حدًّا لعدد الطلبات، واحظر محاولات الدخول الفاشلة المتكررة لكل عنوان IP.
- سجّل كل عملية رصيد مع من أطلقها وسببها، وطابق هذه السجلات مع نظام CRM يوميًا.
هل توجد حدود لعدد الطلبات في MT5 Web API؟
لا تنشر MetaQuotes حدودًا للطلبات في صفحاتها العامة، ولن نذكر أرقامًا لا نستطيع الإحالة إلى مصدرها. ففي الواقع العملي يحدد الحدَّ سعةُ خادمك وسلوكُ عملية الربط لديك، والربط المهمل قد يبطئ خادم التداول على الجميع.
وما ينجح لدينا هو الاحتفاظ بمجموعة من الجلسات المصادَق عليها، والفصل بين طلبات التداول والاستعلامات العامة، واستخدام الأوامر المجمّعة حيثما وُجدت، والتخزين المؤقت لكل ما لا يتغير كل ثانية، مثل إعدادات الرموز والسجل المغلق. ومن جهة العميل نطبّق ضابطًا عامًا للرسائل لكل اتصال، دون أي حد على الصفقات: فمن حق العميل أن يرسل الأوامر متتالية، فهذا هو التداول.
وإن كنت تصمم عملية الربط بنفسك، فدوّن حجم الحمل الذي تولّده قبل بدء التشغيل: كم مرة تستطلع كل نوع من البيانات، ولكم حسابًا، وعبر كم جلسة. فهذه الصفحة الواحدة تجيب عن معظم الأسئلة التي سيطرحها عليك مسؤول الخادم.
من يمكنه الحصول على وصول إلى MT5 Web API؟
يأتي الوصول إلى Web API من الجهة التي تتحكم في خادم MT5، لأنه يتطلب حساب مدير على ذلك الخادم. ويختلف ما يعنيه ذلك باختلاف إعدادك. ولتعرف أي إعداد من FXUP يمنحك الوصول الذي تحتاج إليه، مع الأسعار والشروط الحالية على الشاشة نفسها، قارن الخيارات في أداة اختيار الحل.
| الإعداد | من يتحكم في الخادم | ما يمكنك الحصول عليه عادةً |
|---|---|---|
| ترخيص MT5 خاص | شركتك | وصول كامل؛ تنشئ حسابات المدير وتحدد الصلاحيات بنفسك |
| وايت ليبل MT5 (White Label) | حامل الترخيص | حساب مدير محصور في مجموعاتك، إن سمحت الاتفاقية بذلك |
| جراي ليبل MT5 (Grey Label) | المزوّد | يختلف باختلاف المزوّد؛ ومع FXUP حساب Manager مخصص لا يرى إلا مستخدميك، إضافة إلى الوصول إلى Manager API وSDK بعد الدفع |
ما الذي ينبغي أن تتضمنه قائمة التحقق لربط MT5 Web API؟
قبل أن تكتب أي شيفرة، احسم الأمور التي يكلّف تغييرها لاحقًا. هذه هي القائمة التي نراجعها مع العملاء الذين يربطون نظام CRM للوسطاء أو بوابة أو واجهة عميل، وهي نفسها التي نطبّقها على عمليات الربط المخصصة الأخرى التي ننفّذها:
- إصدار الخادم، وصيغة Web API التي ستستخدمها (HTTPS أو الثنائية أو كلتيهما).
- حساب مدير مخصص، وصلاحياته، والمجموعات التي يستطيع رؤيتها.
- الأحداث التي تُطلق إنشاء الحسابات وتغييرات الرصيد ونقل الحسابات بين المجموعات، ومن يوافق عليها.
- وتيرة الاستطلاع لكل نوع من البيانات، والأوامر المجمّعة التي تغطيها.
- طريقة التعامل مع المناطق الزمنية، ونقطة تحويل واحدة.
- ما يحدث عند انتهاء المهلة في كل عملية، ولا سيما الصفقات وتغييرات الرصيد.
- المراقبة: تنبيه يصلك حين ينقطع الاتصال بـ MT5، لا شكوى من أحد العملاء.
أسئلة شائعة
ما هي MetaTrader 5 Web API؟
هل MT5 Web API واجهة REST؟
هل يمكنني بناء منصة WebTrader خاصة بي على MT5 Web API؟
هل تتيح Web API الوصول إلى عمق السوق؟
ما الفرق بين Web API وManager API؟
هل يمكن لوسيط الجراي ليبل الحصول على وصول إلى الـ API؟
هل توجد حدود لعدد الطلبات في MT5 Web API؟
هل MT5 Web API آمنة؟
كم يستغرق الربط عبر MT5 Web API؟
هل أحتاج إلى إذن من MetaQuotes لاستخدام Web API؟
لم تجد إجابة سؤالك هنا؟ افتح أداة اختيار الحل واطّلع على الإعداد والأسعار والشروط المناسبة لحالتك.
المصادر
- MetaQuotes — MetaTrader 5 trading platform for brokers and banks (تم الاطلاع في أكتوبر 2026)
- MetaQuotes — MetaTrader 5 for brokers (metaquotes.net) (تم الاطلاع في أكتوبر 2026)
- MetaQuotes — Liquidity providers for MetaTrader 5 (تم الاطلاع في أكتوبر 2026)
- MQL5 Reference — Python integration for the MetaTrader 5 terminal (تم الاطلاع في أكتوبر 2026)
FXUP شركة استشارات وتقنية مستقلة ولا ترتبط بشركة MetaQuotes Ltd. MetaTrader 4 وMetaTrader 5 علامتان تجاريتان مملوكتان لشركة MetaQuotes Ltd. هذه الصفحة معلومات عامة وليست استشارة قانونية أو ضريبية أو استثمارية، والمتطلبات التنظيمية تختلف من بلد إلى آخر وتتغير مع الوقت. وتُعرض أسعار FXUP وشروطها الحالية في أداة اختيار الحل.