انتقل إلى المحتوى

بدء الاستخدام

Open API من cTrader هي خدمة يمكنك استخدامها لتطوير تطبيقات مخصصة متصلة بواجهة cTrader الخلفية. يوفر هذا التوثيق كل ما تحتاج إلى معرفته بما في ذلك معلومات حول مجموعات أدوات تطوير البرمجيات، والبرامج التعليمية المنظمة، ومقتطفات التعليمات البرمجية والمزيد.

ما هي Open API؟

Open API من cTrader هي خدمة تسمح لأي شخص لديه cTrader ID (cTID) بإنشاء تطبيق يرسل ويستقبل المعلومات من وإلى واجهة cTrader الخلفية. يمكنك استخدام واجهة API هذه لتطوير تطبيقات أو خدمات موجهة للتداول أو دمج واجهة cTrader الخلفية مع أي حلول موجودة قد تكون لديك.

يتضمن استخدام واجهة API هذه إرسال واستقبال الرسائل من وإلى واجهة cTrader الخلفية. يتم ذلك عن طريق إرسال واستقبال إما كائنات JSON أو Google Protocol Buffers (Protobufs). كلا هذين الوسيلتين لتسلسل البيانات وإلغاء تسلسلها محايدان من حيث اللغة، مما يعني أنه يمكنك استخدام أي لغة برمجة تريدها للتفاعل مع واجهة API.

أسماء الرسائل

عندما يشير هذا التوثيق إلى رسائل محددة (على سبيل المثال، ProtoOAApplicationAuthReq)، فإنه يستخدم ترميز Protobuf مع ProtoOA... في بداية اسم الرسالة.

Open API من cTrader متاحة لأي شخص مسجل لدى وسيط تابع لـ cTrader.

حالات الاستخدام

إليك بعض التطبيقات الممكنة التي قد تنشئها عند التفاعل مع Open API من cTrader:

  • تطبيق تداول مخصص يوجه المستخدمين الجدد لإنشاء حسابات جديدة مع وسيط معين.
  • روبوت Telegram يُعلم متابعيك تلقائيًا بأي صفقات جديدة قد تكون وضعتها.
  • تطبيق للأجهزة القابلة للارتداء يعرض الربح والخسارة الحالية لآخر خمسة مراكز فتحها المستخدم.
  • تطبيق للهاتف المحمول يقدم نظرة عامة على السوق باستخدام خدمة الذكاء الاصطناعي التوليدي.

كما ترى، فإن Open API من cTrader مثالية للمتداولين المحترفين الذين يريدون المشاركة اجتماعيًا والتفاعل مع متابعيهم.

الوظائف الأساسية

إليك قائمة غير شاملة لما تسمح به Open API من cTrader لتعليماتك البرمجية:

  • الوصول إلى بيانات السوق في الوقت الفعلي.
  • تنفيذ جميع أنواع عمليات التداول الممكنة المسموح بها في تطبيقات cTrader الرسمية.
  • استرداد ومعالجة المعلومات حول العمليات السابقة والحالية والمعلقة (بما في ذلك الصفقات والأوامر والمراكز).

كما هو موضح في شروط الاستخدام الخاصة بنا، يمكن الوصول إلى واجهة API من قبل أي شخص لديه cTID، وبشكل افتراضي، يتم دعمها من قبل جميع حسابات التداول لأي وسيط تابع لـ cTrader.

تقييد المعدل

لاحظ وجود بعض القيود على عدد المرات التي يمكنك فيها تنفيذ طلبات معينة إلى واجهة cTrader الخلفية.

  • يمكنك تنفيذ 50 طلبًا كحد أقصى في الثانية لكل اتصال لأي طلبات بيانات غير تاريخية.
  • يمكنك تنفيذ 5 طلبات كحد أقصى في الثانية لكل اتصال لأي طلبات بيانات تاريخية.

التداول التجريبي والحقيقي

يمكنك استخدام Open API من cTrader للتداول نيابة عن الحسابات التجريبية والحقيقية.

نوصي باستخدام الحسابات التجريبية للتطوير والاختبار، ثم الانتقال إلى الحساب الحقيقي بعد التأكد من أن تكاملك مع Open API الخاص بـ cTrader يعمل كما هو مقصود. ومع ذلك، لا توجد قيود صارمة، ويمكنك بحرية اختيار بدء التطوير والاختبار باستخدام حساب حقيقي.

SDKs

عند التكامل مع Open API، يمكنك استخدام إما JSON أو Protobufs لـ تسلسل وإلغاء تسلسل البيانات.

يمكنك استخدام أي لغة لتنفيذ Open API الخاص بـ cTrader. ومع ذلك، إذا كنت تنوي استخدام Protobufs، فإننا نوصي بشدة باستخدام لغة تحظى بدعم SDK رسمي من Spotware. حتى اليوم، هذه اللغات هي كما يلي.

يحتوي كل SDK رسمي مذكور أعلاه على طرق وفئات مساعدة تجعل تنفيذ Open API الخاص بـ cTrader سلسًا قدر الإمكان.

إذا كنت تنوي استخدام JSON، فلا حاجة لاستخدام SDK الخاص بنا حيث أن التعامل مع التسلسل وإلغاء التسلسل في هذه الحالة بسيط نسبيًا.