Changelog per l'API cTrader Algo
5.7
Marzo 2026
Novità
- Nuovo valore
Floatingaggiunto all'enumChartModeconsente di impostare la modalità del contenitore del grafico sulla nuova modalità mobile. - Il nuovo tipo di parametro
Fileconsente di passare un file a un algoritmo, permettendo all'algoritmo di leggere e scrivere dal file. - Il nuovo tipo di parametro
File[]o parametro multi-file consente di passare più file a un algoritmo, permettendo all'algoritmo di leggere e scrivere da qualsiasi file. - Le nuove proprietà di collezione
Archived,CustomeEnabledaggiunte al tipoSymbolsrendono l'interrogazione dei simboli più semplice e performante. - La nuova opzione
DATA-DIRper il comando CLIbacktestconsente di utilizzare una directory specifica per salvare e caricare i dati sui prezzi durante il backtesting dei cBot con CLI. Questa opzione elimina la necessità di scaricare più volte i dati storici sui prezzi quando CLI viene utilizzato tramite Docker.
Correzioni di bug
ChartTemplates.DefaultTemplateè null.
5.6
Novembre 2025
Novità
- La nuova API
ChartTemplatesconsente di recuperare, creare, aggiornare, rimuovere e applicare i template dei grafici. - Il nuovo tipo di parametro
Symbol[]consente di passare più simboli a un algoritmo, con una rappresentazione dell'interfaccia utente di selezione multi-simbolo. - Il nuovo tipo di parametro
Enum[]consente di passare più valori di un tipo enum a un algoritmo, con una rappresentazione dell'interfaccia utente di selezione multi-valore enum. - Il nuovo tipo di parametro
TimeFrame[]consente di passare più valoriTimeFramea un algoritmo, con una rappresentazione dell'interfaccia utente di selezione multi-periodo. - Il nuovo controllo algoritmo
MultiSelectconsente di permettere agli utenti del tuo algoritmo di selezionare più valori stringa univoci. - Il nuovo metodo
OpenDevToolsWindowper il controlloWebViewconsente di aprire gli strumenti di sviluppo per un'istanza del controllo WebView. - Nuovo
SwapCalculationTypeper i punti del simbolo.
Miglioramenti
- I tipi di parametro
TimeFrameaggiornati per supportare periodi personalizzati nei plugin. - Il tipo di parametro
DateTimemodificato per utilizzare il nuovo valore predefinito hardcoded di31/10/2025 00:00:00se non impostato dall'algoritmo invece diDateTime.MinValue. - Il tipo di parametro
DateOnlymodificato per utilizzare il nuovo valore predefinito hardcoded di31/10/2025se non impostato dall'algoritmo invece diDateOnly.MinValue. - Il tipo di parametro
TimeSpanmodificato per utilizzare il nuovo valore predefinito di00:00:00se non impostato dall'algoritmo invece diTimeSpan.MinValue. - Il tipo di parametro
TimeSpanmodificato per utilizzare il nuovo valore minimo di00:00:00e il valore massimo di23:59:59se non impostato dall'algoritmo invece diTimeSpan.MinValueeTimeSpan.MaxValue. - Alcuni esempi di algoritmi integrati aggiunti all'elenco dei template di algoritmi C# e Python e ai repository GitHub degli esempi di algoritmi.
- Codice sorgente di tutti gli indicatori integrati aggiunto ai repository GitHub degli esempi di algoritmi C# e Python.
- Trasferimento dei dati della finestra del grafico agli algoritmi modificato da eager a lazy. Questa modifica previene l'utilizzo non necessario di risorse nei casi in cui un algoritmo non utilizza i membri API della finestra del grafico.
Correzioni di bug
- Controlli del grafico con coordinate che causavano problemi se utilizzati insieme agli oggetti del grafico.
- Dati relativi all'account, come posizioni, ordini in sospeso e altri, non venivano aggiornati quando l'account di trading veniva cambiato per i plugin.
- L'evento
ValueChangeddel controlloDateTimePickernon veniva attivato quando il valore veniva impostato dall'algoritmo.
5.5
Settembre 2025
Novità
- Il nuovo tipo di parametro
Symbolti permette di selezionare un simbolo dall'elenco dei simboli del tuo account e passarlo a un algoritmo. - Il nuovo tipo di parametro
TimeSpanti permette di passare un intervallo di tempo o un'ora del giorno tipizzati a un algoritmo, con una rappresentazione UI di selezione dell'ora. - Il nuovo tipo di parametro
DateTimeti permette di passare una data e un'ora tipizzate nel fuso orario del tuo algoritmo, con una rappresentazione UI di selezione di data e ora. - Il nuovo tipo di parametro
DateOnlyti permette di passare una data tipizzata a un algoritmo, con una rappresentazione UI di selezione della data. - La nuova proprietà della collezione
Parameters, aggiunta aPluginType(simile aIndicatorTypeeRobotType), ti permette di accedere ai parametri del plugin nel codice. - Il nuovo controllo algoritmo
DateTimePickerti permette di ottenere facilmente un valore di data e ora da un utente del tuo algoritmo.
Miglioramenti
- Modificato il caricamento per l'asset di deposito dell'account da modalità eager a lazy per prevenire errori di asset di deposito non trovato durante l'avvio dell'algoritmo.
Correzioni di bug
- Le nuove barre caricate dopo aver chiamato
LoadMoreHistorynei plugin non venivano aggiunte al grafico. - Le barre del grafico non venivano aggiornate dopo aver cambiato il simbolo o il periodo di tempo del grafico nei plugin.
- Numero errato di posizioni restituite all'interno del gestore dell'evento di apertura della posizione quando si accedeva a
Positions.Count
5.4
Luglio 2025
Novità
- API dei tasti di scelta rapida per i plugin: i nuovi oggetti API per i plugin ti permettono di aggiungere tasti di scelta rapida globali. Questi tasti di scelta rapida si comportano come i tasti di scelta rapida integrati di cTrader e funzionano ovunque.
- Descrizioni di parametri e output: la nuova proprietà
Descriptionnegli attributi di parametri e output mostra suggerimenti nell'interfaccia utente quando gli utenti vi passano sopra con il mouse. - Attivazione/disattivazione delle barre del grafico: il nuovo flag
Barsnelle impostazioni di visualizzazione del grafico ti permette di nascondere le barre del grafico. Il flag elimina la necessità di colori trasparenti e previene problemi di ridimensionamento non disegnando le barre. - Impostazione dei frame attivi: il nuovo metodo
Activatenella classeFramepermette ai plugin di impostare il grafico o il frame attivo. - Output delle barre: gli indicatori possono ora produrre barre
OHLCcon volume invece di una singola serie di dati. L'output permette di visualizzare grafici a barre personalizzati sui pannelli o sul grafico principale e può essere riutilizzato da altri indicatori. - Serie di dati per i plugin: il nuovo metodo
CreateDataSeriespermette ai plugin di creare serie di dati. Le serie create possono essere passate come input agli indicatori interni. - Proprietà figlie del pannello: le nuove proprietà
Children,HasChildeChildrenCountti permettono di accedere e lavorare con i contenuti del pannello. - Informazioni sulla posizione del pannello griglia: il nuovo metodo
GridChildPositionInforestituisce la posizione di un figlio nella griglia. - API del menu principale per i plugin: la nuova API ti permette di aggiungere voci di menu con icone SVG al menu principale. Le voci del menu superiore possono mostrare controlli personalizzati. Le voci del menu inferiore possono attivare gestori di plugin.
- Parametri dei plugin: i plugin possono ora utilizzare i parametri nello stesso modo in cui lo fanno gli indicatori e i cBot. I parametri sono visibili e modificabili nelle impostazioni del plugin.
Miglioramenti
- L'API
Assetsè stata rielaborata per ridurre l'utilizzo delle risorse. - L'API
Sleepè stata migliorata per prevenire il blocco dei cBot e degli indicatori quando il mercato è chiuso.
Correzioni di bug
- Nessun bug dell'API è stato trovato o risolto nella versione 5.4.
5.3
Giugno 2025
Novità
- API del periodo di tempo personalizzato: la nuova API permette ai plugin di definire periodi di tempo personalizzati e fornire dati per essi.
- API del simbolo personalizzato: la nuova API permette ai plugin di creare simboli personalizzati. I simboli creati possono essere basati su quelli esistenti o definiti da zero e si comportano come i simboli del broker.
- Fonte di dati di backtesting personalizzata: la nuova API permette ai plugin di fornire dati di backtesting e ottimizzazione. L'API supporta dati tick esterni e feed di terze parti.
- Popup di notifica: gli algoritmi possono ora mostrare avvisi popup simili alle notifiche integrate di cTrader.
- Accesso al sentiment del simbolo: gli algoritmi possono ora leggere i dati di sentiment per i simboli.
Miglioramenti
- Backtesting cross-periodo di tempo: messaggi di errore migliorati per l'utilizzo di periodi di tempo incompatibili nel backtesting e nell'ottimizzazione.
- Aggiornato il link al Centro Assistenza nei template di algoritmi predefiniti.
- Resi disponibili
Account.UserIdeAccount.Nicknameper le istanze di cBot in cloud. - Gestione della disconnessione CID: gli algoritmi continuano a funzionare e restituiscono gli ultimi dati dell'account noti quando CID si disconnette.
- Timeout dei messaggi: la gestione dei timeout previene che gli algoritmi si blocchino in attesa di una risposta da cTrader.
- Aggiornamenti dell'API del Centro Assistenza: aggiunti metodi API protetti al riferimento del Centro Assistenza.
Correzioni di bug
Account.BrokerNamerestituiva un valore vuoto nella console.- Gli algoritmi si bloccavano durante il caricamento di tutte le transazioni dell'account.
- Lo strumento
RiskRewardnel backtest posizionava in modo errato le operazioni live. - Errore di battitura nella documentazione della proprietà
ChartObject.IsLocked. ComboBox.SelectionChangedveniva attivato dopo aver impostato l'elemento selezionato prima del rendering.
