Como criar um indicador personalizado no cTrader

Neste artigo e no vídeo correspondente, vamos discutir como pode criar um novo indicador personalizado no cTrader. Vamos criar um indicador de média móvel simples e mostrar-lhe como personalizar rapidamente os parâmetros do indicador.

Antes de seguir as nossas instruções, certifique-se de que descarregou e instalou a aplicação cTrader Windows ou cTrader Mac a partir do site oficial. Inicie-a e navegue até à secção cTrader Algo. Localize o separador Algo no painel esquerdo e clique nele. Agora deverá ver a interface Algo do cTrader.

Adicionar um novo indicador personalizado

Para criar um novo indicador personalizado, precisamos de clicar no botão Novo e selecionar Em branco. Um novo indicador aparecerá na parte inferior da lista de indicadores juntamente com um modelo de código no painel direito.

Em seguida, altere o nome do indicador do seu nome predefinido. Para isso, clique com o botão direito do rato e clique em Renomear, ou selecione-o e pressione F2. Vamos digitar Média móvel simples como o novo nome do nosso indicador. Quando terminar, prima Enter. Neste momento, estamos prontos para começar a codificar a lógica e as fórmulas para o indicador personalizado.

Ver a estrutura do indicador

Antes de começarmos, vamos dar uma olhada rápida na estrutura do código do indicador mostrada na janela do editor de código. Esta estrutura inclui as configurações de parâmetros predefinidas e os métodos para calcular e exibir o indicador num gráfico.

Para começar, cada indicador tem uma secção contendo os seus atributos de classe. É aqui que pode configurar os direitos de acesso que o indicador tem, onde o indicador será mostrado no gráfico, o fuso horário utilizado pelo indicador, a escala do indicador e várias outras configurações avançadas.

Também notará que cada novo modelo de código de indicador define uma classe chamada NewIndicator que contém todos os eventos do indicador e quaisquer métodos personalizados. A declaração do nome da classe é seguida por : Indicator. Isto significa que a classe NewIndicador herda da classe base Indicator que, por sua vez, contém todos os objetos predefinidos aos quais acederemos ao construir o nosso indicador personalizado.

Uma revisão mais detalhada da estrutura do código do indicador e princípios de herança na programação orientada a objetos é fornecida na nossa documentação técnica.

Na secção abaixo, verá o bloco de código contendo todas as configurações predefinidas do indicador. Inicialmente, esta secção conterá apenas o seguinte código.

1
2
3
4
5

[Parameter(DefaultValue = "Hello world!")]
public string Message { get; set; }

[Output("Main")]
public IndicatorDataSeries Result { get; set; }

Imediatamente abaixo da declaração de parâmetros, deverá ver os métodos do indicador. Pense nos métodos como certos eventos que são executados quando o indicador inicia e também quando novos dados de preço são alimentados ao indicador. A tabela seguinte define três métodos-chave do indicador.

Escrever o código do indicador

Agora vamos prosseguir com a adição de código personalizado ao nosso indicador de média móvel simples. O nosso indicador será exibido no gráfico de negociação como uma sobreposição sobre o tipo de gráfico atual.

Primeiro, temos que declarar os atributos da classe do indicador, como discutido anteriormente. Vamos adicionar as seguintes configurações de atributos ao indicador.

1

[Indicator(IsOverlay = true, TimeZone = TimeZones.UTC, AutoRescale = false, AccessRights = AccessRights.None)] 

Pode interpretar o código acima da seguinte forma:

• IsOverlay = true - o indicador será plotado no gráfico sobre velas, barras de Intervalo, blocos Renko ou quaisquer outros elementos dependendo do tipo de gráfico escolhido.
• TimeZone = TimeZones.UTC - o indicador usará o Tempo Universal Coordenado, que é o valor predefinido para todos os indicadores. Alterar o valor deste atributo só é recomendado se o seu indicador usar qualquer tipo de recursos de data e hora nos seus cálculos.
• AutoRescale = false - este atributo define se o indicador deve redimensionar automaticamente o gráfico ao qual está anexado. Como o valor deste atributo é igual a false, o nosso indicador não redimensionará o gráfico.
• AccessRights = AccessRights.None - o indicador não terá permissão para aceder à Internet ou manipular os ficheiros em máquinas locais.

Agora podemos definir os parâmetros do nosso indicador. Estas são as configurações que podem ser ajustadas no painel de configurações após adicionar o indicador a um gráfico. Vamos codificar os seguintes parâmetros:

• A fonte de dados para a fórmula do indicador.
• Os períodos usados na fórmula.
• A linha plotada do resultado de saída do indicador.

Adicione o seguinte trecho ao indicador.

1
2
3
4
5
6
7
8

[Parameter("Source")]
public DataSeries Source { get; set; }

[Parameter("Periods", DefaultValue = 14)]
public int Periods { get; set; }

[Output("Main", LineColor = "Turquoise")]
public IndicatorDataSeries Result { get; set; }

Vamos definir 14 como o valor predefinido do parâmetro Periods e turquoise como a cor da linha predefinida. No entanto, pode definir estes parâmetros para quase qualquer valor predefinido suportado pelo cTrader.

Agora podemos adicionar o código que irá plotar a saída do indicador no gráfico usando o método de evento Calculate().

1
2
3
4
5
6
7
8
9

public override void Calculate(int index)
{
    var sum = 0.0;

    for (var i = index - Periods + 1; i <= index; i++)
    sum += Source[i];

    Result[index] = sum / Periods;
}

Este código atribui o resultado dos cálculos do indicador ao parâmetro Result que definimos anteriormente.

Criar e testar o indicador

Assim que terminarmos de escrever o código do nosso indicador, podemos clicar no botão Criar localizado na barra superior da interface do cTrader. Em alternativa, clique com o botão direito do rato no seu indicador e selecione Criar no menu recém-aberto ou prima Ctrl + B.

Se a criação for bem-sucedida, verá uma mensagem verde na área Resultado da criação na parte inferior do editor de código.

No entanto, se houver problemas com o seu código, verá uma mensagem vermelha e um resumo detalhado de todos os erros de criação.

Após criar com sucesso o seu indicador, podemos agora prosseguir com a criação de uma instância. A forma mais simples de o fazer é clicar com o botão direito do rato no indicador e escolher a opção Adicionar uma instância.

Isto irá criar uma nova instância do indicador para o gráfico h1 para EURUSD. No entanto, pode alterar o tipo de gráfico, o intervalo de tempo e o símbolo clicando na instância e abrindo o menu relevante.

O separador Parâmetro recém-aparecido deve mostrar os três parâmetros personalizáveis que codificámos anteriormente. Pode deixá-los como estão ou alterar os seus valores diretamente na interface do cTrader.

O gráfico de negociação deve agora mostrar o resultado do indicador. No nosso caso, será uma linha turquesa que mostra a média móvel simples.

Se clicar com o botão direito do rato na linha, verá uma nova janela que permite personalizar os parâmetros do indicador. Por exemplo, podemos mudar a cor da linha de saída de turquesa para azul. Também podemos ajustar a espessura da linha. Para guardar as suas alterações, clique em OK.

Adicionar o indicador a um gráfico em tempo real

Agora vamos mudar para o separador Negociar no cTrader para anexar o nosso indicador personalizado a um gráfico em tempo real. Abra o gráfico para o símbolo que gostaria de analisar.

No menu no topo, clique no ícone Indicadores para abrir uma nova secção.

Depois, selecione Personalizado e, no menu recém-aparecido, escolha o indicador personalizado que criámos (Média móvel simples).

Verá uma nova janela que permite personalizar os parâmetros do indicador. Depois de escolher os valores que prefere, clique em OK para adicionar o indicador ao gráfico para o símbolo escolhido.

Para voltar à janela de definições do indicador, clique com o botão direito do rato nos resultados do indicador. No nosso caso, podemos clicar com o botão direito do rato na linha turquesa. Em alternativa, clique no ícone Propriedades que aparece quando passa o rato sobre o nome do indicador no gráfico.

A janela de definições do indicador irá aparecer, e poderá alterar a cor da linha traçada, bem como a sua espessura.