كيفية استخدام مراجع وأدلة cTrader Algo

يأتي cTrader مجهزًا بمجموعة كاملة من المواد التكميلية بما في ذلك الوثائق الشاملة (التي تقرأها حاليًا) ومقاطع الفيديو التعليمية. في هذه المقالة، نشرح كيف يمكنك استخدام هذا الكنز من المعلومات بشكل فعال. تحتوي واجهة برمجة التطبيقات الخوارزمية على العديد من الأعضاء، ومعرفة كيفية الحصول على المعلومات بسرعة حول ما تحتاجه أمر ضروري.

الوصول إلى الوثائق والأدلة

يمكنك بسهولة العثور على المواد التعليمية مباشرة في cTrader Windows. للقيام بذلك، افتح تطبيق Algo وحدد أي خوارزمية. في العمود الموجود على يمين نافذة محرر الكود، يجب أن ترى وثائق واجهة برمجة التطبيقات مدمجة بالكامل داخل المنصة.

في الواقع، هناك احتمال كبير أنك قد تقرأ هذه المقالة أثناء وجودك داخل cTrader.

بدلاً من ذلك، يمكنك زيارة مركز مساعدة cTrader وفتح القسم الذي يغطي التداول الخوارزمي. فيه، يجب أن ترى نفس الواجهة والهيكل كما هو الحال في cTrader Windows العادي. أخيرًا وليس آخرًا، يمكنك زيارة قناة YouTube الخاصة بنا حيث يمكنك مشاهدة أدلة الفيديو التي تغطي خوارزميات cTrader. لاحظ أن جميع هذه الأدلة متوفرة أيضًا كمقاطع فيديو مضمنة في مركز المساعدة وفي وثائق واجهة برمجة التطبيقات المدمجة.

التنقل عبر الوثائق

تحتوي الوثائق على عدة أقسام أساسية.

أساسيات C# و.NET. هذه المقدمة الموجزة للمبادئ الأساسية لـ C# و.NET مثالية لأي شخص يتطلع إلى البدء في إنشاء خوارزميات مخصصة.

cBots و المؤشرات. تغطي هذه الأدلة عملية إنشاء cBots والمؤشرات من الصفر وتوفر العديد من مقتطفات الكود التي يمكنك إعادة استخدامها بحرية عند إنشاء الخوارزميات الخاصة بك.

ميزات واجهة برمجة التطبيقات. تفصل الوثائق في هذا القسم كيف يمكنك العمل مع العديد من الميزات الرئيسية لواجهة برمجة تطبيقات Algo، وبشكل أكثر وضوحًا الوصول إلى الشبكة والتخزين المحلي. تحتوي أدلة عمليات cBot المتقدمة و عمليات المؤشرات المتقدمة على مقتطفات كود لأنواع معقدة من خوارزميات cTrader مثل المؤشرات المتداخلة.

المراجع. تحتوي مراجع واجهة برمجة التطبيقات على أوصاف لكل عضو في واجهة برمجة التطبيقات، مما يعني أنه يمكنك قراءة معلومات حول ما يمكنك الحصول عليه أو تعيينه عبر خصائص معينة، والقيم الممكنة لمختلف enum، وما تعيده طرق معينة. يتم توفير نفس المعلومات في نافذة محرر الكود عندما تحوم فوق عضو معين في واجهة برمجة التطبيقات.

استخدام مقتطفات الكود

مقتطفات الكود الشاملة هي إحدى الميزات الرئيسية لهذه الوثائق. بغض النظر عن نوع الخوارزميات التي تريد إنشاءها، هناك احتمال كبير أن الوثائق تحتوي على كود يمكنك إعادة استخدامه بحرية. لتوضيح ذلك، يمكننا إنشاء cBot بسيط يعمل تقريبًا بالكامل على الكود المأخوذ من الوثائق مع بعض التعديلات الصغيرة.

للقيام بذلك، سننشئ أولاً cBot جديدًا. يتم ذلك بالنقر فوق زر cBot جديد أو، إذا لم تتمكن من رؤيته، فتح القائمة المنسدلة في أعلى قائمة الخوارزميات وتحديد نفس الخيار.

سننشئ cBot بسيطًا يتداول رموزًا متعددة. نريد التداول على الأخبار، لذا من المنطقي أن يكون لدينا خوارزمية تتداول جميع الرموز المتعلقة بتلك الأخبار.

للقيام بذلك، سنفتح وثائق واجهة برمجة تطبيقات Algo المدمجة ونكتب "رموز متعددة" في شريط البحث الخاص بها. كما هو موضح في نتائج البحث، هناك قسم فرعي يناقش تداول الرموز الأخرى في دليل العمليات المتقدمة مع cBots. إذا نقرنا على هذه النتيجة المحددة، سيتم نقلنا على الفور إلى مقتطف الكود ذي الصلة بالإضافة إلى بعض المعلومات التكميلية. يمكننا على الفور نسخ ولصق المقتطف في cBot الخاص بنا.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

  [Robot()]
  public class Sample_cBot : Robot
  {
    protected override void OnStart()
    {
        var symbol = Symbols.GetSymbol("GBPUSD");

        if (symbol is not null)
        {
            _ = ExecuteMarketOrder(TradeType.Sell, symbol.Name, symbol.VolumeInUnitsMin);
        }
    }
  }

تخبرنا المعلومات الموجودة أعلى مقتطف الكود أنه يمكننا استخدام مجموعة Symbols للعثور على الرموز التي نريدها. لنفترض أن وزارة الخزانة الأمريكية تقدم خطابًا آخر حول دورة سعر الفائدة ونريد فتح مراكز بيع عند البدء لعدة مؤشرات أمريكية (ولكن ليس للرمز الذي تم إرفاق cBot الخاص بنا به).

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

[Robot()]
  public class Sample_cBot : Robot
  {
    protected override void OnStart()
    {
        var symbolOne = Symbols.GetSymbol("US 500");

        var symbolTwo = Symbols.GetSymbol("US 30");

        var symbolThree = Symbols.GetSymbol("US TECH 100");

        if (symbolOne is not null && symbolTwo is not null && symbolThree is not null)
        {
            ExecuteMarketOrder(TradeType.Sell, symbolOne.Name, symbolOne.VolumeInUnitsMin);
            ExecuteMarketOrder(TradeType.Sell, symbolTwo.Name, symbolTwo.VolumeInUnitsMin);
            ExecuteMarketOrder(TradeType.Sell, symbolThree.Name, symbolThree.VolumeInUnitsMin);
        }
    }
  }

عند البدء، سينفذ cBot الخاص بنا العمليات المطلوبة. سمح لنا الرجوع إلى وثائق واجهة برمجة التطبيقات بتوفير الكثير من الوقت من خلال إعادة استخدام الكود الموجود وتعديله قليلاً فقط ليناسب احتياجاتنا.

الملخص

يتيح لك cTrader الوصول إلى وثائق واجهة برمجة التطبيقات في العديد من الأماكن المختلفة، وبشكل أكثر وضوحًا داخل المنصة نفسها. إنها طريقة مريحة للغاية لتمكين الخوارزميات الخاصة بك حيث يمكنك ببساطة إعادة استخدام مقتطفات الكود من الوثائق بعد إدخال التعديلات المطلوبة. نوصي أيضًا بشدة بالاشتراك في قناة YouTube الخاصة بنا حتى يتم تحديثك في كل مرة نصدر فيها مقطع فيديو تعليمي جديد.