الواجهة البرمجية لتطبيق TickTrader Algo (TickTrader Algo API)

الواجهة البرمجية لتطبيق TickTrader Algo (TickTrader Algo API)

يمكن للمستخدمين إنشاء روبوتات ومؤشرات التداول الخاصة بهم باستخدام TickTrader.Algo.Api.
لإنشاء روبوت تداول مخصص أو مؤشر، يرجى اتباع الخطوات التالية:
  1. تثبيت تطبيق (Visual Studio) 
  2. امتداد تطبيق (TT Algo Visual Studio ) 
     إذا لزم الأمر، قم بتثبيت أو تحديث الإصدار الخاص بك من TT Algo Visual Studio Extension. 
  3. اتبع التعليمات الخاصة بكيفية إنشاء Algo Trade Bot(آلغو التجارة بوت) أو Algo Indicator(مؤشر ألغو) في Visual Studio وقم بتشغيلها في محطة TickTrader.

Algo Trade Bot(آلغو التجارة بوت)

  1. قم بإنشاء مشروع جديد في Visual Studio باستخدام قالب Empty Trade Bot.

  2. قم بتعيين اسم مشروع Trade Bot الخاص بك (مثل MyTradeBotTest) وانقر فوق "إنشاء".

  3.  في قسم Solution Explorer، سترى البنية التالية:

    • MyTradeBotTest.cs: الملف الذي يحتوي على رمز الروبوت الذي تم إنشاؤه.
    • README.md: الملف الذي يمكنك من خلاله إضافة وصف لروبوتك بتنسيق MarkDown.


  4. إذا كنت تريد استخدام أحدث إصدار من واجهة برمجة التطبيقات (API)، فتحقق من وجود تحديثات في NuGet Explorer، وحدد إدارة حزم NuGet للحل...

    في النافذة المعروضة، حدد حزمة TickTrader.Algo.Api > حدد مشروعك (متاح إذا كان التحديث) > حدد الإصدار > انقر فوق تثبيت.

  5. بعد إنشاء مشروع Trade Bot، ستحصل على القالب التالي:



    حدد TradeBot واضغط على F12 لرؤية وظائف روبوت التداول.


    بالضغط على F12 على AlgoPlugin، يمكنك رؤية الوظائف العامة التي يمكن استخدامها في كل من الروبوتات والمؤشرات.
  6. لدى الروبوتات الطرق التالية:

    • Init: سيتم استدعاء الطريقة بعد تشغيل الروبوت.
    • OnStart: سيتم استدعاء الطريقة مباشرة قبل بدء تشغيل الروبوت.
    • OnStop: سيتم استدعاء الطريقة عندما يتوقف الروبوت.
    • AsyncStop: سيتم أيضًا استدعاء الطريقة عندما يتوقف الروبوت. يمكنك استخدام هذه الطريقة عندما تحتاج إلى تنفيذ تعليمات برمجية غير متزامنة عندما يتوقف الروبوت.
    • OnQuote: سيتم استدعاء الطريقة مع عرض أسعار وارد جديد.
    • OnModeTick: سيتم استدعاء الطريقة عند تحديث علامة النموذج.
       يمكنك أيضًا استخدام (تجاوز) الطرق التالية في الروبوت الخاص بك::
    • OnRateUpdate: سيتم استدعاء الطريقة مع تحديث الأشرطة.
  7.  دعونا نلقي نظرة على مثال روبوت التجارة الذي يمكنك إنشاؤه باستخدام قالب نموذج روبوت التجارة:


    كيف يعمل "Sample Trade Bot": يفتح مركزًا متكررًا مع الجانب المحدد (معلمة "جانب المركز")، وحجم التداول المحدد (معلمة "الحجم")، والانتظار لفترة من الوقت (يتم تحديدها بواسطة "وقت الانتظار" المعلمة)، ثم يغلق المركز المفتوح بأمر سوق من الجانب الآخر. يكرر الروبوت قيد التشغيل هذه الخطوات حتى يتوقف.
    ملحوظة! يعمل الروبوت فقط على حسابات TickTrader NET.

  8. قم ببناء مشروعك من خلال تحديد أمر Build Solution في قائمة سياق Solution Explorer..

  9.  قم بتحميل حزمة باستخدام الروبوت الذي تم إنشاؤه إلى خوادم Ticktrader Algo: Explorer > Algo Servers > تحميل الحزمة.. 

  10.  حدد أمر Add Bot Instance في قائمة السياق: حدد اسم الخادم (محلي) وحساب التداول الخاص بك من القائمة، وحدد Algo Bot الذي تم تنزيله وأدخل معرف المثيل (اختياري). انقر فوق موافق..

     يمكنك تغيير إعدادات ومعلمات تشغيل الروبوت في علامة التبويب "المدخلات". انقر فوق "موافق" لحفظ التغييرات.

  11. انقر بزر الماوس الأيمن فوق الروبوت المضاف وحدد أمر Start Bot لتشغيله.



Algo Indicator(مؤشر ألغو)

  1. قم بإنشاء مشروع جديد في Visual Studio باستخدام قالب المؤشر الفارغ.
    إذا لزم الأمر، قم بتثبيت أو تحديث إصدار TT Algo Visual Studio Extension عن طريق تحديد الأدوات > تثبيت أو تحديث TT Algo Visual Studio Extension في محطة TickTrader. سيتم تثبيت تثبيت الامتداد تلقائيًا في Visual Studio.

  2.  قم بتعيين اسم المشروع (على سبيل المثال MyIndicatorTest) وانقر فوق إنشاء. 

  3.  في قسم Solution Explorer، سترى البنية التالية:

    • MyIndicatorTest.cs: الملف الذي يحتوي على رمز المؤشر الذي تم إنشاؤه.
    • README.md: الملف الذي يمكنك من خلاله إضافة وصف للمؤشر الخاص بك بتنسيق MarkDown.

  4.  إذا كنت تريد استخدام أحدث إصدار من واجهة برمجة التطبيقات (API)، فتحقق من وجود تحديثات في NuGet Explorer، وحدد إدارة حزم NuGet للحل...


     في النافذة المعروضة، حدد حزمة TickTrader.Algo.Api > حدد المشروع (متاح إذا كان التحديث) > حدد الإصدار > انقر فوق تثبيت.

  5. بعد إنشاء مشروع المؤشر سوف تحصل على القالب التالي:

    حدد المؤشر واضغط على F12 لعرض وظيفة المؤشر..




     بالضغط على F12 على AlgoPlugin، يمكنك رؤية الوظائف العامة التي يمكن استخدامها في كل من الروبوتات والمؤشرات.



  6. هناك الطرق التالية:

    • Initسيتم استدعاء الطريقة بعد تشغيل المؤشر في Algo Studio
    • Calculateسيتم استدعاء الطريقة مع الحسابات.
  7.  دعونا نلقي نظرة على مثال المؤشر الذي يمكنك إنشاؤه باستخدام قالب المؤشر النموذجي:



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

    • الفترة: فترة متوسط السعر، القيمة الافتراضية هي 14 (int).
    • SmoothFactor: العامل الناعم وهو 0.0667 افتراضيًا (مزدوج).
    • الوضع: وضع الحساب: الأسي/البسيط (التعداد).
    • الإدخال: إدخال السعر.
    • المخرجات: متوسط السعر ملون باللون الأحمر.

  8.  قم ببناء مشروعك من خلال تحديد أمر Build Solution في قائمة سياق Solution Explorer.

  9.  يجب وضع حزمة المؤشرات في مجلد حزم Algo الذي يمكن فتحه عن طريق تحديد الأدوات > فتح مجلد حزم Algo.

  10.  يمكن إضافة المؤشر إلى الرسم البياني من قائمة السياق الخاصة به. انقر بزر الماوس الأيمن فوق منطقة المخطط وحدد مؤشر التحميل > المؤشرات الخاصة بي.

  11. بعد تحميل المؤشر، يمكنك عرض وتكوين إعداداته باستخدام قائمة المؤشرات > تحرير عنصر قائمة سياق المؤشر.