API2Trade — مركز المساعدة
ابحث أو تنقّل بين الفئات لإيجاد الأجوبة. لكل سؤال رابط خاص يمكن مشاركته.
ابحث أو تنقّل بين الفئات لإيجاد الأجوبة. لكل سؤال رابط خاص يمكن مشاركته.
API2Trade خدمة واجهة REST مُستضافة تتيح لك التعامل برمجيًا مع حسابات التداول على MT4 و MT5 — دون إبقاء منصة MetaTrader مفتوحة على حاسبك.
تربط حساب التداول مرة واحدة، ومن تلك اللحظة يمكنك تنفيذ الصفقات وقراءة بيانات الحساب وأسعار السوق من أي لغة برمجة باستخدام طلبات HTTP القياسية.
للتفاصيل التقنية الكاملة، راجع الوثائق الرسمية.
البدء يستغرق أقل من 30 دقيقة:
/RegisterAccount.راجع الدليل خطوة بخطوة في وثائق التوثيق.
أي لغة قادرة على إرسال طلبات HTTP تعمل مع API2Trade. ولأنها واجهة REST عادية عبر HTTPS، يمكنك استخدام Python أو JavaScript/Node.js أو Go أو C# أو Java أو Ruby أو PHP أو أي لغة أخرى.
كما تعمل مع أدوات بلا برمجة مثل Postman و Make (Integromat) و n8n و Zapier، أو أي أداة تستطيع نداء نقطة وصول HTTP.
نعم. تدعم الواجهة حسابات MetaTrader 4 (MT4) و MetaTrader 5 (MT5). ويمكنك ربط حسابات من المنصّتين وإدارتها في الوقت نفسه، بحسب خطتك.
تختلف نقاط الوصول المتاحة بين MT4 و MT5 في بعض التفاصيل (مثلًا يوفّر MT5 أنواع أوامر وخيارات سجل أكثر). راجع الوثائق للمرجع الكامل لكل منصّة.
لا. هذا هو الغرض الأساسي من الخدمة. تعمل API2Trade بالكامل على الخادم. تُدخل بيانات الوسيط مرة واحدة، وتتولّى الواجهة الحفاظ على الاتصال بالوسيط بالنيابة عنك.
لا تحتاج إلى تركيب MetaTrader ولا إبقاء منصة طرفية قيد التشغيل ولا كتابة أي Expert Advisors بلغة MQL.
يختلف التوثيق بحسب خطتك:
استخدم مفتاح الواجهة في ترويسة x-api-key، وأرسل معرّف الحساب UUID في معامل الاستعلام id (أو accountId):
curl -X GET "https://api.api2trade.com/AccountSummary?id=YOUR_ACCOUNT_UUID" \
-H "x-api-key: YOUR_API_KEY"تجد مفتاح الواجهة في تبويب الإعدادات في لوحة التحكم.
يحصل مستخدمو خطط Pro على عنوان أساسي مخصّص مع اسم مستخدم وكلمة مرور. وتُوثَّق جميع الطلبات عبر Basic Auth:
Authorization: Basic BASE64_ENCODED(USERNAME:PASSWORD)مفتاح الواجهة موجود في تبويب الإعدادات في لوحة التحكم على app.api2trade.com.
الممارسة المفضّلة: احفظه في متغيّر بيئة (مثل MTAPI_KEY) وأدخِله وقت التشغيل.
يمكنك ربط الحسابات بطريقتين:
سجّل الدخول على app.api2trade.com، وانتقل إلى قسم الحسابات، وأضف بيانات MT4/MT5 (رقم الدخول وكلمة المرور واسم خادم الوسيط). بعد الربط ستحصل على معرّف UUID فريد لذلك الحساب.
استخدم نقطة الوصول /RegisterAccount. المعاملات الدقيقة وصيغة الاستجابة موجودة في وثائق الواجهة.
BrokerName-Live أو BrokerName-Demo.استخدم نقطة الوصول /CheckConnect. تتحقّق من حالة الاتصال لمعرّف الحساب المحدّد، وتحاول إعادة الاتصال تلقائيًا إذا كان قد انقطع.
لتفاصيل صيغة الطلب وقيم الاستجابة، راجع الوثائق.
استخدم نقطة الوصول /DeleteAccount لفصل حساب تداول مربوط وحذفه. ويمكنك سرد جميع الحسابات المربوطة حاليًا عبر /GetAccounts.
راجع وثائق الواجهة لمعاملات الطلب.
تغطّي الواجهة دورة التداول كاملة:
لتفاصيل نقاط الوصول والمعاملات وصيغ الاستجابة، راجع وثائق الواجهة.
استخدم نقطة الوصول /OrderSend. تحدّد الرمز ونوع العملية (Buy أو Sell أو Buy Limit وغيرها) والحجم، واختياريًا stop loss و take profit وتعليقًا.
تختلف معاملات /OrderSend قليلًا بين MT4 و MT5 — إذ يدعم MT5 حقولًا إضافية مثل expirationType و stopLimitPrice.
استخدم نقطتي الوصول /OrderHistory أو /OrderHistoryPagination. يمكنك التصفية بنطاق التاريخ ورقم التذكرة وترتيب الفرز. كما يوفّر MT5 نقطتي /PendingOrderHistory و /HistoryDealsByPositionId لاستعلامات أدقّ.
المرجع الكامل للمعاملات في الوثائق.
نعم. توفّر الواجهة اتصال WebSocket (أحداث) للبثّ في الوقت الفعلي، ما يتيح استقبال التحديثات مباشرةً بدل الاستعلام المتكرّر لنقاط REST.
عبر بثّ WebSocket يمكنك استقبال أسعار السوق اللحظية، وفي حالة MT4 استجابات غير متزامنة لبعض الطلبات مثل سجل الأسعار.
لأسعار العرض والطلب اللحظية يمكنك استخدام نقطة REST /GetQuote (أو /GetQuoteMany لعدّة رموز)، أو الاشتراك في الأسعار عبر بثّ WebSocket للحصول على تحديثات متواصلة في الوقت الفعلي.
تقبل /GetQuote معاملًا باسم msNotOlder يحدّد ما إذا كانت الواجهة تنتظر تكّة جديدة أم تُعيد آخر تكّة معروفة.
لبيانات الشموع التاريخية OHLC استخدم /QuoteHistory (MT4) أو /PriceHistory (MT5) — راجع الوثائق لخيارات الأطر الزمنية والمعاملات.
تتوفّر ثلاث خطط نشطة (الأسعار غير شاملة ضريبة القيمة المضافة):
تتوفّر أيضًا خطة سنوية بتوفير يصل إلى 25% بحسب الخطة. وجميع الأسعار مؤكّدة في صفحة الأسعار.
لا. لا نوفّر حاليًا فترة تجريبية مجانية. إن كانت لديك أسئلة عن كيفية تقييم الواجهة، تواصل معنا عبر Telegram أو بالبريد على [email protected].
وإذا اتُّفق على فترة تجريبية بشكل فردي، تقتضي الشروط إرسال الإلغاء بالبريد الإلكتروني إلى [email protected] قبل انتهائها — ويُعتدّ بوقت الشراء مرجعًا، ويبقى البريد مطلوبًا حتى إذا كان الدفع قد تمّت معالجته.
نعم. تشمل خطة Single Account اتصالًا واحدًا كل 30 يومًا. وإذا احتجت إلى حسابات أكثر، يُحتسب كل حساب إضافي بـ 10 يورو للحساب شهريًا، ويُحصَّل تلقائيًا في نهاية كل دورة فوترة.
وإن كنت تحتاج إلى عدد كبير من الحسابات، فالترقية إلى خطة Pro (حسابات غير محدودة*) أوفر بدءًا من نحو 50 حسابًا.
تُعالَج المدفوعات عبر Stripe. وتشمل الطرق المقبولة بطاقات الائتمان والخصم والعملات الرقمية والحوالة المصرفية.
وبإتمام الطلب فإنك توافق أيضًا على اتفاقية خدمات Stripe.
نعم، يمكنك الإلغاء في أي وقت. ويسري الإلغاء في نهاية دورة الفوترة الحالية المدّتها 30 يومًا — ولا تُردّ مبالغ جزئية عن الأيام غير المستخدمة.
للإلغاء خلال فترة تجريبية: أرسل بريدًا إلى [email protected] قبل انتهائها. وإذا كان الدفع قد حُصِّل بالفعل، فما زال الإلغاء بالبريد مطلوبًا لإيقاف الاشتراك.
تشغّل الخدمة شركة Apex Vanguard Dynamics LLC، وهي شركة ذات مسؤولية محدودة (LLC) مسجّلة في الولايات المتحدة، وعنوانها المسجّل 30 N Gould St Ste R, Sheridan, WY 82801, الولايات المتحدة.
البريد الإلكتروني: [email protected] · الهاتف: +1 (929) 333-6422
للبيانات القانونية الكاملة، راجع البيانات القانونية.
تخضع الشروط والأحكام لقوانين ولاية وايومنغ بالولايات المتحدة. وتخضع أي منازعات للاختصاص القضائي الحصري لمحاكم وايومنغ، ويتّفق الطرفان على السعي أولًا لتسويتها بالتفاوض بحسن نيّة.
يمكنك قراءة الشروط والأحكام الكاملة على الموقع.
لا. تقتضي شروط الخدمة صراحةً الحفاظ على سرّية بيانات الدخول ومفاتيح الواجهة، وعدم مشاركتها مع أي طرف ثالث دون موافقة خطية مسبقة من API2Trade.
وإذا كنت تبني منتجًا أو خدمة فوق الواجهة (لعملائك مثلًا)، فينبغي أن تبني طبقة توثيق خاصة بك وأن تُبقي مفتاح API2Trade على الخادم فقط — دون كشفه للمستخدمين النهائيين أبدًا.
لا. تحظر شروط الخدمة استخراج البيانات (scraping) أو إعادة بيعها دون إذن خطي صريح من API2Trade. كما أن الاشتراكات غير قابلة للتحويل.
إذا كانت لديك حالة عمل محدّدة، تواصل مع [email protected].
نعم. اتفاقيات عدم الإفشاء متاحة عند الطلب ويجب الاتفاق عليها خطيًا من الطرفين. وتُطبَّق الشروط القياسية لاتفاقية عدم الإفشاء ما لم يُتفق على غير ذلك.
للطلب، تواصل مع [email protected].
تفيد API2Trade بتطبيق عدّة تدابير أمنية:
لمزيد من التفاصيل عن ممارسات الأمان، راجع سياسة الخصوصية.
تشغّل API2Trade شركة أمريكية (راجع من يشغّل API2Trade؟)، وتفيد بالامتثال لقوانين حماية البيانات السارية، بما يشمل GDPR حيث ينطبق على مستخدمي الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية.
البيانات الشخصية التي تُجمع: معلومات الحساب (الاسم والبريد الإلكتروني وبيانات الفوترة)، وبيانات الاستخدام (سجلات الواجهة وعنوان IP والمتصفّح ونظام التشغيل)، ومعلومات الدفع المعالجة عبر Stripe.
وتفيد الشركة بأنها لا تبيع البيانات الشخصية ولا تشاركها مع أطراف أخرى. التفاصيل الكاملة في سياسة الخصوصية.
وفقًا لسياسة الخصوصية، قد تُجمع البيانات التالية:
وقد تُعالَج البيانات داخل المنطقة الاقتصادية الأوروبية أو في بلدان أخرى ذات مستويات حماية ملائمة (نظرًا لوجود 11 مركز بيانات حول العالم).
اقرأ سياسة الخصوصية الكاملة للمعلومات التفصيلية.
أكثر أسباب فشل الاتصال شيوعًا:
ICMarkets-Live02). تجده في MetaTrader ضمن ملف → فتح حساب.استخدم /CheckConnect للتحقّق من حالة الاتصال الحالية. وإذا استمرّت المشكلة، تواصل مع [email protected].
تعني أخطاء التوثيق عادةً أن مفتاح الواجهة مفقود أو خطأ أو يُرسَل بصيغة غير صحيحة. تحقّق من الآتي:
x-api-key وليس Authorization: Bearer.api.api2trade.com).راجع وثائق التوثيق للصيغ الصحيحة لكل نوع خطة.
تعلن API2Trade عن توافر 99.95% عبر مراكز بياناتها الـ 11 حول العالم، بمتوسّط زمن استجابة نحو 47 ملّي ثانية.
ولاحِظ أنه وفقًا لشروط الخدمة تُقدَّم الخدمة «كما هي» و«حسب توافرها» — فالتشغيل المتواصل أو الخالي من الأخطاء غير مضمون تعاقديًا. ولأنظمة الإنتاج، طبّق دائمًا منطق إعادة المحاولة ومعالجة الأخطاء من جانبك.
يأتي رفض الأوامر من خادم التداول لدى الوسيط، لا من API2Trade. وأشهر الأسباب:
EURUSD مقابل EURUSDm).راجع استجابة الخطأ من الواجهة — فهي تتضمّن الحقلين message و code من الوسيط لبيان سبب الرفض.