Como utilizar ficheiros .cbotset

Neste artigo e no vídeo, discutimos como pode utilizar ficheiros .cbotset. Pode pensar nestes ficheiros como contentores para armazenar e reutilizar determinadas definições de instância e valores de parâmetros para cBots.

Aplicar e guardar ficheiros .cbotset

A forma mais fácil de começar a trabalhar com ficheiros .cbotset é adicionar uma nova instância de cBot. Ao escolher um cBot, o cTrader irá exibir a janela Adicionar instância onde poderá personalizar os seus parâmetros.

Em alternativa, pode selecionar uma instância existente e aceder à janela Modificar parâmetros. Para cBots, isto é feito clicando duas vezes numa instância e selecionando Modificar parâmetros ou clicando duas vezes numa instância. Note que só é possível alterar parâmetros se uma instância estiver atualmente parada.

Para guardar os parâmetros da instância atual num ficheiro separado, clique no ícone Guardar no canto superior direito da janela, como mostrado na imagem abaixo.

Na caixa de diálogo do ficheiro, introduza o nome do ficheiro e confirme a sua escolha.

Ao trabalhar com outra instância do mesmo algoritmo, clique no ícone Abrir, como mostrado na imagem abaixo. Isto abre a caixa de diálogo de seleção de ficheiros onde poderá escolher o ficheiro .cbotset que guardou anteriormente.

Ao selecionar e abrir um ficheiro .cbotset, várias definições da instância serão atualizadas para corresponder aos valores especificados no ficheiro selecionado. Estas definições incluem não apenas os valores dos parâmetros, mas também o símbolo e o intervalo de tempo ao qual a instância atualmente selecionada está associada.

Se o seu cBot estiver atualmente associado a um gráfico para outro símbolo ou a um gráfico com um intervalo de tempo diferente do especificado no ficheiro, o cTrader irá exibir uma janela de aviso.

Se optar por continuar, os valores dos parâmetros serão substituídos pelos do ficheiro. No entanto, a instância permanecerá associada ao seu gráfico original.

Ao clicar no botão Executar, a instância do algoritmo será iniciada tendo em conta as definições especificadas no ficheiro que acabou de aplicar. Isto torna os ficheiros .cbotset um método altamente conveniente para garantir que diferentes instâncias do mesmo algoritmo se comportam exatamente da mesma forma.

Antes de prosseguir, vamos analisar como um ficheiro .cbotset está estruturado. Embora tenha uma extensão elaborada, o ficheiro pode ser aberto em qualquer editor de texto simples, como o Bloco de notas básico. Se abrirmos o ficheiro, deveremos ver uma sequência de pares chave-valor, como mostrado abaixo.

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

{
  "Chart": {
    "Symbol": "GBPJPY",
    "Period": "m5"
  },
  "Parameters": {
    "PositionId": "PID",
    "TakeProfit1Enabled": "False",
    "TakeProfit1Pips": "15",
    "TakeProfit1Volume": "1500",
    "TakeProfit2Enabled": "False",
    "TakeProfit2Pips": "30",
    "TakeProfit2Volume": "1000",
    "TakeProfit3Enabled": "False",
    "TakeProfit3Pips": "10",
    "TakeProfit3Volume": "3000"
  }
}

Podemos facilmente ajustar os valores conforme necessário, tornando os ficheiros .cbotset facilmente modificáveis mesmo fora do cTrader.

Casos de uso para ficheiros .cbotset

A utilização de ficheiros .cbotset pode poupar muito tempo e esforço nos seguintes casos.

• Cenário 1 - quando tem um conjunto de parâmetros obtidos através de otimização e pretende reutilizá-lo para novas instâncias de um algoritmo.

Como a otimização consiste em encontrar os melhores valores de parâmetros para um determinado algoritmo, pode querer reutilizar os resultados da otimização para o maior número possível de novas instâncias.

Para tal, realize a otimização e selecione a passagem cujos resultados melhor se adequam aos seus requisitos. A partir daqui, tem duas opções para gerar o ficheiro .cbotset contendo os valores dos parâmetros da passagem escolhida.

Opção 1: mude para o separador Parâmetros da passagem e clique no botão Guardar parâmetros.

Opção 2: clique em Aplicar junto à passagem escolhida e depois guarde os valores recentemente aplicados através do separador Parâmetros, clicando no ícone Guardar.

Posteriormente, deverá poder reutilizar livremente o ficheiro com os resultados da otimização para qualquer uma das novas instâncias do mesmo algoritmo.

• Cenário 2 - quando o seu algoritmo tem um grande número de parâmetros, tornando difícil configurar cada nova instância "manualmente".

Considere um exemplo de um cBot com quatro ou mais parâmetros.

Demoraria muito tempo a especificar manualmente os valores dos parâmetros necessários ao criar novas instâncias de tais algoritmos. Felizmente, todo o processo demora segundos quando se utilizam ficheiros .cbotset, pois pode facilmente aplicar quaisquer configurações que desejar a quaisquer instâncias que tenha ou possa criar no futuro.

• Cenário 3 - quando tem várias configurações de parâmetros, cada uma das quais alcança resultados diferentes, e pretende alternar facilmente entre elas.

Dependendo da situação, pode querer criar várias combinações de parâmetros que alteram drasticamente o comportamento de um algoritmo. Isto é frequentemente útil quando tem um cBot em que os níveis de take profit ou stop loss estão incluídos como parâmetros. Neste caso, poderia aplicar rapidamente definições pré-configuradas contendo vários mecanismos de proteção que correspondem aos seus níveis de tolerância ao risco e às condições de mercado.

Pode até adicionar várias instâncias do mesmo algoritmo e aplicar um ficheiro .cbotset diferente a cada uma no início, o que pode ser útil para cobrir riscos.

Utilizar ficheiros .cbotset com cTrader CLI

Também pode utilizar ficheiros .cbotset ao executar cBots em processos externos através da ferramenta cTrader CLI.

Ao utilizar o comando run no cTrader CLI, tem várias opções configuráveis que lhe permitem especificar várias definições obrigatórias e opcionais, nomeadamente o cBot que pretende iniciar ou o símbolo no qual pretende executá-lo.

Para garantir que o seu cBot é iniciado com parâmetros de um determinado ficheiro .cbotset, basta especificar o caminho para este ficheiro imediatamente após o caminho para o ficheiro .algo que contém o cBot. A ordem correta é mostrada no exemplo seguinte.

ctrader-cli.exe run C:\mycoolbot.algo C:\coolbotsettings.cbotset

Em seguida, pode especificar outros argumentos necessários, incluindo o seu e-mail do cTrader (-c={email}), o caminho para o ficheiro que contém a sua palavra-passe (--pwd-file={passwordFile}), o número da sua conta de negociação (--account={account}), e o símbolo e intervalo de tempo no qual o cBot deve ser executado (--symbol={symbol} --period={period}).

Depois de executar o comando, o bot começará a operar utilizando os valores dos parâmetros do ficheiro escolhido.

Resumo

Saber como trabalhar com um ficheiro .cbotset é uma competência valiosa para qualquer trader algorítmico que queira maximizar o desempenho dos seus algoritmos. Se quiser saber mais sobre negociação algorítmica no cTrader, subscreva o nosso canal do YouTube.