Как использовать справочные материалы и руководства cTrader Algo

cTrader оснащен полным набором дополнительных материалов, включая обширную документацию (часть которой вы сейчас читаете) и обучающие видео. В этой статье мы объясним, как вы можете эффективно использовать эту сокровищницу информации. Algo API имеет множество членов, и умение быстро получать информацию о том, что вам нужно, имеет важное значение.

Доступ к документации и руководствам

Вы можете легко найти обучающие материалы прямо в cTrader Windows. Для этого откройте приложение Algo и выберите любой алгоритм. В столбце справа от окна редактирования кода вы увидите документацию API, полностью интегрированную в платформу.

На самом деле, есть большая вероятность, что вы читаете эту статью прямо в cTrader.

Кроме того, вы можете посетить Справочный центр cTrader и открыть раздел, посвященный алгоритмической торговле. В нем вы увидите тот же интерфейс и структуру, что и в обычном cTrader Windows. И наконец, вы можете посетить наш канал на YouTube, где вы можете посмотреть видеоруководства по алгоритмам cTrader. Обратите внимание, что все эти руководства также доступны в виде встроенных видео в Справочном центре и в интегрированной документации API.

Навигация по документации

Документация содержит несколько важных разделов.

Основы C# и .NET. Это краткое введение в основные принципы C# и .NET идеально подходит для всех, кто хочет начать создавать пользовательские алгоритмы.

сиБоты и Индикаторы. Эти руководства охватывают процесс создания сиБотов и индикаторов с нуля и предоставляют несколько фрагментов кода, которые вы можете свободно использовать при создании собственных алгоритмов.

Возможности API. Документация в этом разделе подробно описывает, как вы можете работать с несколькими основными функциями Algo API, в частности с сетевым доступом и локальным хранилищем. Руководства Расширенные операции сиБотов и Расширенные операции индикаторов содержат фрагменты кода для сложных типов алгоритмов cTrader, таких как вложенные индикаторы.

Справочные материалы. Справочные материалы API содержат описания каждого отдельного члена API, что означает, что вы можете прочитать информацию о том, что вы можете получить или установить через определенные свойства, возможные значения различных enum и что возвращают определенные методы. Та же информация предоставляется в окне редактирования кода, когда вы наводите курсор на конкретный член API.

Использование фрагментов кода

Обширные фрагменты кода являются одной из ключевых особенностей этой документации. Независимо от типа алгоритмов, которые вы хотите создать, существует высокая вероятность того, что документация содержит код, который вы можете свободно использовать повторно. Чтобы продемонстрировать это, мы можем создать простого сиБота, который работает почти полностью на коде, взятом из документации, с небольшими изменениями.

Для этого мы сначала создадим нового сиБота. Это делается нажатием на кнопку Новый сиБот или, если вы ее не видите, открытием выпадающего меню в верхней части списка алгоритмов и выбором той же опции.

Мы создадим простого сиБота, который торгует несколькими инструментами. Мы хотим торговать на новостях, поэтому имеет смысл иметь алгоритм, который торгует всеми инструментами, связанными с этими новостями.

Для этого мы откроем встроенную документацию Algo API и введем "несколько инструментов" в строку поиска. Как показывают результаты поиска, есть подраздел, обсуждающий торговлю другими инструментами в руководстве Расширенные операции с сиБотами. Если мы кликнем на этот конкретный результат, мы сразу перейдем к соответствующему фрагменту кода, а также к некоторой дополнительной информации. Мы можем сразу скопировать и вставить фрагмент в нашего сиБота.

 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 для поиска нужных нам инструментов. Предположим, Казначейство США выступает с очередной речью о цикле процентных ставок, и мы хотим открыть позиции на продажу при запуске для нескольких американских индексов (но не для инструмента, к которому прикреплен наш сиБот).

 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);
        }
    }
  }

При запуске наш сиБот выполнит необходимые операции. Обращение к документации API позволило нам сэкономить много времени, повторно используя существующий код и лишь немного изменяя его в соответствии с нашими потребностями.

Обзор

cTrader позволяет вам получить доступ к документации API в нескольких разных местах, в первую очередь внутри самой платформы. Это невероятно удобный способ расширить возможности ваших алгоритмов, поскольку вы можете просто повторно использовать фрагменты кода из документации после внесения необходимых изменений. Мы также настоятельно рекомендуем подписаться на наш канал YouTube, чтобы получать обновления каждый раз, когда мы выпускаем новое обучающее видео.