Como usar as referências e guias do cTrader Algo

O cTrader vem equipado com um conjunto completo de materiais suplementares, incluindo documentação extensa (parte da qual você está a ler atualmente) e vídeos educativos. Neste artigo, explicamos como pode usar eficazmente este tesouro de informações. A API de algoritmos tem muitos membros, e saber como obter rapidamente informações sobre o que precisa é essencial.

Aceder à documentação e guias

Pode encontrar facilmente materiais educativos diretamente no cTrader Windows. Para isso, abra a aplicação Algo e selecione qualquer algoritmo. Na coluna à direita da janela do editor de código, deve ver a documentação da API totalmente integrada dentro da plataforma.

Na verdade, há uma grande probabilidade de estar a ler este artigo dentro do cTrader.

Alternativamente, pode visitar o Centro de Ajuda do cTrader e abrir a secção que cobre a negociação algorítmica. Nela, deve ver a mesma interface e estrutura que veria no cTrader Windows normal. Por último, mas não menos importante, pode visitar o nosso canal do YouTube onde pode assistir a guias em vídeo que cobrem os algoritmos do cTrader. Note que todos estes guias também estão disponíveis como vídeos incorporados no Centro de Ajuda e na documentação integrada da API.

Navegar pela documentação

A documentação contém várias secções essenciais.

Noções básicas de C# e .NET. Esta breve introdução aos princípios fundamentais de C# e .NET é perfeita para qualquer pessoa que queira começar a criar algoritmos personalizados.

cBots e Indicadores. Estes guias cobrem o processo de criação de cBots e indicadores do zero e fornecem vários trechos de código que pode reutilizar livremente ao criar os seus próprios algoritmos.

Funcionalidades da API. A documentação nesta secção detalha como pode trabalhar com várias funcionalidades importantes da API Algo, nomeadamente o acesso à rede e o armazenamento local. Os guias Operações avançadas de cBot e Operações avançadas de indicadores contêm trechos de código para tipos complexos de algoritmos do cTrader, como indicadores aninhados.

Referências. As referências da API contêm descrições de cada membro da API, o que significa que pode ler informações sobre o que pode obter ou definir através de certas propriedades, os valores possíveis de vários enum's e o que certos métodos retornam. A mesma informação é fornecida na janela do editor de código quando passa o rato sobre um membro específico da API.

Usar trechos de código

Trechos de código extensos são uma das características principais desta documentação. Independentemente do tipo de algoritmos que deseja criar, há uma grande probabilidade de a documentação conter código que pode reutilizar livremente. Para demonstrar isto, podemos criar um cBot simples que funciona quase inteiramente com código retirado da documentação com algumas pequenas modificações.

Para fazer isso, primeiro criaremos um novo cBot. Isto é feito clicando no botão Novo cBot ou, se não o conseguir ver, abrindo o menu suspenso no topo da lista de algoritmos e selecionando a mesma opção.

Criaremos um cBot simples que negocia múltiplos símbolos. Queremos negociar notícias, por isso faz sentido ter um algoritmo que negocie todos os símbolos relacionados com essa notícia.

Para isso, abriremos a documentação integrada da API Algo e digitaremos "múltiplos símbolos" na sua barra de pesquisa. Como mostrado pelos resultados da pesquisa, há uma subsecção que discute a negociação de outros símbolos no guia Operações avançadas com cBots. Se clicarmos neste resultado específico, seremos imediatamente levados ao trecho de código relevante, bem como a algumas informações suplementares. Podemos imediatamente copiar e colar o trecho no nosso 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);
        }
    }
  }

As informações acima do trecho de código dizem-nos que podemos usar a coleção Symbols para encontrar os símbolos que queremos. Suponha que o Tesouro dos EUA está a fazer outro discurso sobre o ciclo das taxas de juro e queremos abrir posições de venda no início para vários índices baseados nos EUA (mas não para o símbolo ao qual o nosso cBot está anexado).

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

No início, o nosso cBot executará as operações necessárias. Recorrer à documentação da API permitiu-nos poupar muito tempo ao reutilizar código existente e apenas modificá-lo ligeiramente para atender às nossas necessidades.

Resumo

O cTrader permite-lhe aceder à documentação da API em vários lugares diferentes, nomeadamente dentro da própria plataforma. É uma forma incrivelmente conveniente de potenciar os seus algoritmos, pois pode simplesmente reutilizar trechos de código da documentação após introduzir as modificações necessárias. Também recomendamos vivamente que se subscreva o nosso canal do YouTube para ser atualizado sempre que lançamos um novo vídeo educativo.