Aller au contenu

Paramètres personnalisables dans les algorithmes Python

Lors du développement de bots de trading Python, d'indicateurs techniques ou de plug-ins, vous pouvez avoir besoin d'ajouter et de configurer des paramètres personnalisables. Cet article explique comment déclarer et utiliser des paramètres personnalisables dans un algorithme Python pour cTrader.

Remarque

Le modèle d'exécution pour les algorithmes Python de cTrader implique un moteur .NET/C#, qui nécessite que tous les paramètres personnalisables soient déclarés dans des fichiers .cs. Chaque fois que vous créez un algorithme Python dans cTrader, un fichier .cs pour cet algorithme est généré automatiquement et stocké dans le dossier approprié.

Emplacement

L'emplacement du fichier .cs pour un algorithme Python dépend du type d'algorithme, qu'il s'agisse d'un cBot, d'un indicateur ou d'un plug-in, ainsi que du nom de l'algorithme.

  • Pour les cBots : Documents/cAlgo/Sources/Robots/{cBot-name}/{cBot-name}/
  • Pour les indicateurs : Documents/cAlgo/Sources/Indicators/{Indicator-name}/{Indicator-name}/
  • Pour les plug-ins : Documents/cAlgo/Sources/Indicators/{Plugin-name}/{Plugin-name}/

Vous pouvez suivre ces instructions pour localiser le fichier .cs d'un algorithme Python :

  1. Faites un clic droit sur l'algorithme dans cTrader Windows ou Mac, puis sélectionnez Afficher dans le dossier.

  2. Naviguez à travers {name-of-algorithm}/{name-of-algorithm}, puis identifiez le fichier .cs (fichier source C#) dans la liste des fichiers.

Le fichier .cs porte généralement le même nom que l'algorithme, avec tous les espaces supprimés. Par exemple, un algorithme nommé Amazing Aroon cBot donne un fichier AmazingArooncBot.cs.

Astuce

Dans le même dossier, vous pouvez accéder au code Python principal de votre algorithme, stocké dans un fichier .py tel que Amazing Aroon cBot_main.py. Le fichier Python suit une convention de nommage simple :

  • Pour les cBots : cBot-name_main.py
  • Pour les indicateurs : Indicator-name_main.py
  • Pour les plug-ins : Plugin-name_main.py

Contenu

Ouvrez le fichier .cs dans n'importe quel éditeur de texte ou de code, tel que NotePad ou Visual Studio code et vous devriez voir un code similaire à celui-ci :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
using cAlgo.API;

namespace cAlgo.Robots;

[Robot(AccessRights = AccessRights.None, AddIndicators = true)]
public partial class AmazingArooncBot : Robot
{
    [Parameter("Volume (Lots)", DefaultValue = 0.01)]
    public double VolumeInLots { get; set; }

    [Parameter("Stop Loss (Pips)", DefaultValue = 10, MaxValue = 100, MinValue = 1, Step = 1)]
    public double StopLossInPips { get; set; }

    [Parameter("Take Profit (Pips)", DefaultValue = 10, MaxValue = 100, MinValue = 1, Step = 1)]
    public double TakeProfitInPips { get; set; }

    [Parameter("Label", DefaultValue = "AmazingArooncBot")]
    public string Label { get; set; }

    [Parameter("Periods", DefaultValue = 25, Group = "Aroon", MinValue = 2)]
    public int Periods { get; set; }
}

Remarque

Vous verrez une classe vide si vous avez créé votre cBot Python à partir de zéro sans utiliser de modèle.

Tout paramètre déclaré dans le fichier .cs peut être utilisé dans le fichier Python principal, qui contient le code affiché dans l'éditeur de code. Le code Python principal ci-dessous illustre l'utilisation des paramètres personnalisables :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
import clr

clr.AddReference("cAlgo.API")

# Import cAlgo API types
from cAlgo.API import *

# Import trading wrapper functions
from robot_wrapper import *

class AmazingArooncBot():
    def on_start(self):
        self.volumeInUnits = api.Symbol.QuantityToVolumeInUnits(api.VolumeInLots)
        self.aroon = api.Indicators.Aroon(api.Periods)

    def on_bar_closed(self):
        if self.aroon.Up.Last(0) > self.aroon.Down.Last(0) and self.aroon.Up.Last(1) < self.aroon.Down.Last(1):
            self.close_positions(TradeType.Sell)
            api.ExecuteMarketOrder(TradeType.Buy, api.SymbolName, self.volumeInUnits, api.Label, api.StopLossInPips, api.TakeProfitInPips)
        elif self.aroon.Up.Last(0) < self.aroon.Down.Last(0) and self.aroon.Up.Last(1) > self.aroon.Down.Last(1):
            self.close_positions(TradeType.Buy)
            api.ExecuteMarketOrder(TradeType.Sell, api.SymbolName, self.volumeInUnits, api.Label, api.StopLossInPips, api.TakeProfitInPips)

    def get_bot_positions(self):
        return api.Positions.FindAll(api.Label)

    def close_positions(self, tradeType):
        for position in self.get_bot_positions():
            if position.TradeType != tradeType:
                continue
            api.ClosePosition(position)

Avantages

L'avantage principal des paramètres personnalisables est qu'ils apparaissent comme des champs modifiables dans l'interface utilisateur de toutes les applications cTrader, y compris cTrader Windows, Mac, Web et Mobile. Les valeurs de ces champs peuvent être modifiées facilement pour répondre à tout besoin ou opération, sans avoir besoin d'accéder ou de modifier le code source de l'algorithme.

Dans cTrader Store, les vendeurs utilisent souvent des paramètres personnalisables pour s'assurer que les acheteurs d'algorithmes sont en mesure d'ajuster les algorithmes pour répondre à leurs objectifs et flux de travail.

Image title