Registo de alterações para a API do cTrader Algo

5.6

Novembro, 2025

Novidades

A nova API ChartTemplates permite-lhe recuperar, criar, atualizar, remover e aplicar modelos de gráficos.
O novo tipo de parâmetro Symbol[] permite-lhe passar vários símbolos para um algo, com uma representação de interface de utilizador de seletor de múltiplos símbolos.
O novo tipo de parâmetro Enum[] permite-lhe passar vários valores de um tipo enum para um algo, com uma representação de interface de utilizador de seletor de múltiplos valores enum.
O novo tipo de parâmetro TimeFrame[] permite-lhe passar vários valores TimeFrame para um algo, com uma representação de interface de utilizador de seletor de múltiplos períodos.
O novo controlo de algo MultiSelect permite que os utilizadores do seu algo selecionem vários valores de string únicos.
O novo método OpenDevToolsWindow para o controlo WebView permite-lhe abrir ferramentas de desenvolvimento para uma instância do controlo WebView.
Novo SwapCalculationType para pontos de símbolo.

Melhorias

Os tipos de parâmetro TimeFrame foram atualizados para suportar períodos personalizados em plugins.
O tipo de parâmetro DateTime foi alterado para usar o novo valor predefinido codificado de 31/10/2025 00:00:00 se não for definido pelo algo, em vez de DateTime.MinValue.
O tipo de parâmetro DateOnly foi alterado para usar o novo valor predefinido codificado de 31/10/2025 se não for definido pelo algo, em vez de DateOnly.MinValue.
O tipo de parâmetro TimeSpan foi alterado para usar o novo valor predefinido de 00:00:00 se não for definido pelo algo, em vez de TimeSpan.MinValue.
O tipo de parâmetro TimeSpan foi alterado para usar o novo valor mínimo de 00:00:00 e o valor máximo de 23:59:59 se não for definido pelo algo, em vez de TimeSpan.MinValue e TimeSpan.MaxValue.
Algumas amostras de algo integradas foram adicionadas à lista de modelos de algoritmos C# e Python e aos repositórios GitHub de amostras de algo.
O código-fonte de todos os indicadores integrados foi adicionado aos repositórios GitHub de amostras de algo C# e Python.
A transferência de dados da janela de visualização do gráfico para os algos foi refatorada de ávida para preguiçosa. Esta alteração evita o uso desnecessário de recursos nos casos em que um algo não utiliza membros da API da janela de visualização do gráfico.

Correções de erros

Controlos de gráfico com coordenadas que resultavam em problemas quando usados juntamente com objetos de gráfico.
Dados relacionados com a conta, como posições, ordens pendentes e outros, não estavam a ser atualizados quando a conta de negociação era alterada para plugins.
O evento ValueChanged do controlo DateTimePicker não estava a ser acionado quando o valor era definido pelo algo.

5.5

Setembro, 2025

Novidades

O novo tipo de parâmetro Symbol permite-lhe selecionar um símbolo da lista de símbolos da sua conta e passá-lo para um algo.
O novo tipo de parâmetro TimeSpan permite-lhe passar um intervalo de tempo ou hora do dia tipificado para um algo, com uma representação de interface de utilizador de seletor de tempo.
O novo tipo de parâmetro DateTime permite-lhe passar uma data e hora tipificadas no fuso horário do seu algo, com uma representação de interface de utilizador de seletor de data e hora.
O novo tipo de parâmetro DateOnly permite-lhe passar uma data tipificada para um algo, com uma representação de interface de utilizador de seletor de data.
A nova propriedade de coleção Parameters, adicionada a PluginType (semelhante a IndicatorType e RobotType), permite-lhe aceder aos parâmetros do plugin no código.
O novo controlo de algo DateTimePicker permite-lhe obter facilmente um valor de data e hora de um utilizador do seu algo.

Melhorias

Alterado o carregamento do ativo de depósito da conta do modo ávido para o modo preguiçoso para evitar erros de ativo de depósito não encontrado durante o arranque do algo.

Correções de erros"

As novas barras carregadas após chamar LoadMoreHistory em plugins não eram adicionadas ao gráfico.
As barras do gráfico não estavam a ser atualizadas após mudar o símbolo ou o intervalo de tempo do gráfico em plugins.
Número incorreto de posições devolvidas dentro do manipulador de eventos de posição aberta ao aceder a Positions.Count

5.4

Julho, 2025

Novidades

API de teclas de atalho para plugins: Novos objetos de API para plugins permitem adicionar teclas de atalho globais. Estas teclas de atalho comportam-se como as teclas de atalho integradas do cTrader e funcionam em todo o lado.
Descrições de parâmetros e saídas: Nova propriedade Description nos atributos de parâmetros e saídas mostra dicas de ferramentas na interface do utilizador quando os utilizadores passam o rato por cima.
Alternância de barras do gráfico: Nova flag Bars nas definições de exibição do gráfico permite ocultar as barras do gráfico. A flag elimina a necessidade de cores transparentes e evita problemas de escala ao não desenhar as barras.
Definição de frames ativos: Novo método Activate na classe Frame permite que os plugins definam o gráfico ou frame ativo.
Saídas de barras: Os indicadores agora podem produzir barras OHLC com volume em vez de uma única série de dados. A saída permite exibir gráficos de barras personalizados em painéis ou no gráfico principal e pode ser reutilizada por outros indicadores.
Séries de dados para plugins: O novo método CreateDataSeries permite que os plugins criem séries de dados. As séries criadas podem ser passadas como entradas para indicadores internos.
Propriedades filhas do painel: As novas propriedades Children, HasChild e ChildrenCount permitem-lhe aceder e trabalhar com o conteúdo do painel.
Informações de posição do painel de grelha: O novo método GridChildPositionInfo retorna a posição de um filho na grelha.
API de menu principal para plugins: A nova API permite adicionar itens de menu com ícones SVG ao menu principal. Os itens de menu superiores podem mostrar controlos personalizados. Os itens de menu inferiores podem acionar manipuladores de plugins.
Parâmetros de plugin: Os plugins agora podem usar parâmetros da mesma forma que os indicadores e cBots. Os parâmetros são visíveis e editáveis nas definições do plugin.

Melhorias

A API Assets foi refatorada para reduzir o uso de recursos.
A API Sleep foi melhorada para evitar o congelamento de cBots e indicadores quando o mercado está fechado.

Correções de erros

Não foram encontrados ou corrigidos erros de API na versão 5.4.

5.3

Junho, 2025

Novidades

API de intervalo de tempo personalizado: A nova API permite que os plugins definam intervalos de tempo personalizados e forneçam dados para eles.
API de símbolo personalizado: A nova API permite que os plugins criem símbolos personalizados. Os símbolos criados podem ser baseados em existentes ou definidos do zero e comportam-se como símbolos do corretor.
Fonte de dados de testes de verificação personalizada: A nova API permite que os plugins forneçam dados para testes de verificação e otimização. A API suporta dados de ticks externos e feeds de terceiros.
Notificações pop-up: Os algos agora podem mostrar alertas pop-up semelhantes às notificações integradas do cTrader.
Acesso ao sentimento do símbolo: Os algos agora podem ler dados de sentimento para símbolos.

Melhorias

Testes de verificação entre intervalos de tempo: Mensagens de erro melhoradas para uso de intervalos de tempo incompatíveis em testes de verificação e otimização.
Atualizado o link do Centro de Ajuda nos modelos de algo predefinidos.
Disponibilizados Account.UserId e Account.Nickname para instâncias de cBot na Nuvem.
Tratamento de desconexão CID: Os algos continuam a funcionar e retornam os últimos dados conhecidos da conta quando o CID se desconecta.
Tempos limite de mensagens: O tratamento de tempos limite evita que os algos fiquem bloqueados enquanto esperam por uma resposta do cTrader.
Atualizações da API do Centro de Ajuda: Adicionados métodos de API protegidos à referência do Centro de Ajuda.

Correções de erros

Account.BrokerName retornava vazio na consola.
Os algos congelavam ao carregar todas as transações da conta.
A ferramenta RiskReward nos testes de verificação colocava incorretamente negociações em tempo real.
Erro de digitação na documentação da propriedade ChartObject.IsLocked.
ComboBox.SelectionChanged era acionado após definir o item selecionado antes da renderização.