Come utilizzare i riferimenti e le guide di cTrader Algo

cTrader è dotato di un set completo di materiali supplementari che include un'ampia documentazione (di cui fa parte ciò che stai leggendo attualmente) e video didattici. In questo articolo spieghiamo come puoi utilizzare efficacemente questo tesoro di informazioni. Algo API ha molti membri e sapere come ottenere rapidamente le informazioni di cui hai bisogno è essenziale.

Accedere alla documentazione e alle guide

Puoi trovare facilmente i materiali didattici direttamente in cTrader Windows. Per farlo, apri l'applicazione Algo e seleziona un algoritmo qualsiasi. Nella colonna a destra della finestra dell'editor del codice dovresti vedere la documentazione API completamente integrata all'interno della piattaforma.

In effetti, c'è un'alta probabilità che tu stia leggendo questo articolo mentre sei all'interno di cTrader.

In alternativa, puoi visitare il Centro Assistenza cTrader e aprire la sezione che tratta il trading algoritmico. In essa dovresti vedere la stessa interfaccia e struttura che vedresti in cTrader Windows normale. Ultimo ma non meno importante, puoi visitare il nostro canale YouTube dove puoi guardare guide video che trattano gli algoritmi di cTrader. Nota che tutte queste guide sono disponibili anche come video incorporati nel Centro Assistenza e nella documentazione API integrata.

Navigare nella documentazione

La documentazione contiene diverse sezioni essenziali.

Nozioni di base su C# e .NET. Questa breve introduzione ai principi fondamentali di C# e .NET è perfetta per chiunque voglia iniziare a creare algoritmi personalizzati.

cBot e Indicatori. Queste guide trattano il processo di creazione di cBot e indicatori da zero e forniscono diversi frammenti di codice che puoi riutilizzare liberamente quando crei i tuoi algoritmi.

Funzionalità API. La documentazione in questa sezione descrive in dettaglio come puoi lavorare con diverse funzionalità principali di Algo API, in particolare l'accesso alla rete e l'archiviazione locale. Le guide Operazioni avanzate con cBot e Operazioni avanzate con indicatori contengono frammenti di codice per tipi complessi di algoritmi cTrader come gli indicatori nidificati.

Riferimenti. I riferimenti API contengono descrizioni di ogni singolo membro dell'API, il che significa che puoi leggere informazioni su ciò che puoi ottenere o impostare tramite determinate proprietà, i possibili valori di vari enum e ciò che determinati metodi restituiscono. Le stesse informazioni vengono fornite nella finestra dell'editor del codice quando passi il mouse su un membro specifico dell'API.

Utilizzare frammenti di codice

Gli ampi frammenti di codice sono una delle caratteristiche principali di questa documentazione. Indipendentemente dal tipo di algoritmi che vuoi creare, c'è un'alta probabilità che la documentazione contenga codice che puoi riutilizzare liberamente. Per dimostrarlo, possiamo creare un semplice cBot che funziona quasi interamente con codice preso dalla documentazione con alcune piccole modifiche.

Per farlo, creeremo prima un nuovo cBot. Questo viene fatto facendo clic sul pulsante Nuovo cBot o, se non riesci a vederlo, aprendo il menu a discesa nella parte superiore dell'elenco degli algoritmi e selezionando la stessa opzione.

Creeremo un semplice cBot che esegue operazioni su più simboli. Vogliamo fare trading sulle notizie, quindi ha senso avere un algoritmo che esegua operazioni su tutti i simboli correlati a quelle notizie.

Per farlo, apriremo la documentazione Algo API integrata e digiteremo "multiple symbols" nella sua barra di ricerca. Come mostrato dai risultati della ricerca, c'è una sottosezione che discute il trading di altri simboli nella guida Operazioni avanzate con cBot. Se facciamo clic su questo risultato specifico, verremo immediatamente portati al frammento di codice pertinente insieme ad alcune informazioni supplementari. Possiamo immediatamente copiare e incollare il frammento nel nostro 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);
        }
    }
  }

Le informazioni sopra il frammento di codice ci dicono che possiamo utilizzare la raccolta Symbols per trovare i simboli che vogliamo. Supponiamo che il Tesoro degli Stati Uniti stia tenendo un altro discorso sul ciclo dei tassi di interesse e vogliamo aprire posizioni di vendita all'avvio per diversi indici basati negli Stati Uniti (ma non per il simbolo a cui è collegato il nostro cBot).

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

All'avvio, il nostro cBot eseguirà le operazioni richieste. Fare riferimento alla documentazione API ci ha permesso di risparmiare molto tempo riutilizzando il codice esistente e modificandolo solo leggermente per adattarlo alle nostre esigenze.

Riepilogo

cTrader ti consente di accedere alla documentazione API in diversi luoghi, in particolare all'interno della piattaforma stessa. È un modo incredibilmente conveniente per potenziare i tuoi algoritmi poiché puoi semplicemente riutilizzare frammenti di codice dalla documentazione dopo aver introdotto le modifiche necessarie. Ti consigliamo vivamente di iscriverti al nostro canale YouTube per ricevere aggiornamenti ogni volta che pubblichiamo un nuovo video didattico.