Types de paramètres dans cTrader Algo

Dans cet article et la vidéo correspondante, nous allons vous montrer comment déclarer et utiliser des paramètres personnalisables dans vos cBots et indicateurs. Nous allons développer un indicateur simple et vous montrer comment configurer les paramètres à partir de l'interface utilisateur de cTrader. Nous expliquerons également quel type de paramètres vous pouvez utiliser dans un cBot ou un indicateur cTrader et illustrerons comment ils sont déclarés et utilisés dans votre code.

Paramètres personnalisables

Les paramètres personnalisables sont des valeurs configurables qui peuvent être définies lors de l'ajout, du démarrage ou de l'utilisation d'un algorithme. Ils vous permettent, ainsi qu'aux autres utilisateurs, de personnaliser le comportement des cBots, des indicateurs et des plug-ins sans modifier le code source.

Comme expliqué précédemment, cTrader prend en charge ces types de paramètres :

• int
• double
• string
• bool
• DataSeries
• TimeFrame
• enum
• Color
• DateTime
• DateOnly
• TimeSpan
• Symbol
• Symbol[] (multi-symbol)
• Enum[] (multi-enum)
• TimeFrame[] (multi-period)

Créer un indicateur simple avec des paramètres

Pour démontrer comment vous pouvez utiliser des paramètres dans des indicateurs personnalisés, nous allons créer un nouvel indicateur et le nommer Standard Deviation.

Pour calculer l'écart type, nous devons d'abord calculer la moyenne mobile du prix. Par la suite, nous déclarerons les paramètres nécessaires pour un indicateur de moyenne mobile en commençant par la période de la moyenne mobile.

1

public int MaPeriod { get; set; }

Toute propriété publique qui a l'un des types pris en charge peut devenir un paramètre d'indicateur. Pour transformer notre propriété MaPeriod en paramètre, il suffit d'ajouter la déclaration requise.

1
2

[Parameter("MA Period")]
public int MaPeriod { get; set; }

L'attribut Parameter indique à cTrader de présenter cette propriété comme un paramètre dans le panneau des paramètres de l'indicateur en utilisant le nom défini ("MA Period").

Comme indiqué ci-dessous, l'attribut Parameter vous permet également de définir certaines propriétés du paramètre telles que le nom affiché, la valeur par défaut, le groupe dans lequel ce paramètre sera placé, les valeurs maximales et minimales, ainsi que le pas que le paramètre changera lorsque les flèches haut et bas sont pressées (uniquement pour les valeurs numériques).

1
2

[Parameter("SMA Period", DefaultValue = 14, Group = "MA", MaxValue = 100, MinValue = 1, Step = 1)]
public int MaPeriod { get; set; }

Nous allons maintenant ajouter le reste des paramètres nécessaires pour un indicateur de moyenne mobile. Le paramètre MaType nous aidera à déterminer le type de moyenne mobile. Il s'agit d'un enum qui apparaîtra comme un menu déroulant dans l'interface utilisateur de cTrader.

1
2

[Parameter("MA Type", Group = "MA")]
public MovingAverageType MaType { get; set; }

Le paramètre Source donnera aux utilisateurs la possibilité de spécifier la source de données pour notre indicateur de moyenne mobile. Ce paramètre est de type DataSeries.

1
2

[Parameter("Source", Group = "MA")]
public DataSeries Source { get; set; }

Maintenant que les paramètres requis sont déclarés, nous allons définir et initialiser notre moyenne mobile.

1
2
3
4
5
6

private MovingAverage movingAverage;

protected override void Initialize()
{
    movingAverage = Indicators.MovingAverage(Source, MaPeriod, MaType);
}

À ce stade, nous sommes prêts à mettre en œuvre le calcul de notre écart type. Le modèle de code par défaut contient déjà la propriété Output que nous pouvons utiliser pour afficher les résultats du calcul.

1
2

[Output("Result", LineColor = "Orange")]
public IndicatorDataSeries Result { get; set; }

Enfin, nous allons implémenter le calcul de l'écart type dans la méthode Calculate().

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

public override void Calculate(int index)
{
    var average = movingAverage.Result[index];

    double sum = 0;

    for (var period = 0; period < MaPeriod; period++)
    {
        sum += Math.Pow(Source[index - period] - average, 2.0);
    }

    Result[index] = Math.Sqrt(sum / MaPeriod);
}

Si nous ajoutons notre indicateur à un graphique, nous devrions voir tous nos paramètres dans la fenêtre Ajouter une instance.

Ajouter des paramètres supplémentaires

Une fois notre écart type terminé, nous pouvons également ajouter une ligne horizontale qui servira de seuil visuel pour l'indicateur. À cette fin, nous devrons ajouter quelques paramètres supplémentaires.

Le premier sera un paramètre booléen qui déterminera si notre ligne sera affichée ou non.

1
2

[Parameter("Show Line", DefaultValue = true, Group = "Line")]
public bool ShowLine { get; set; }

Le paramètre LineLevel nous permettra de déterminer le niveau de prix auquel la ligne doit être tracée.

1
2

[Parameter("Line Level", DefaultValue = 0.001, Step = 0.001, Group = "Line")]
public double LineLevel { get; set; }

Nous ajouterons également un paramètre permettant de choisir la couleur de la ligne.

1
2

[Parameter("Line Color", DefaultValue = "Blue", Group = "Line")]
public Color LineColor { get; set; }

Avec tous les paramètres nécessaires en place, nous pouvons écrire du code pour tracer la ligne sur le graphique où notre indicateur est attaché.

1
2
3
4

if (ShowLine)
{
    Chart.IndicatorAreas[0].DrawHorizontalLine("Line", LineLevel, LineColor);
}

Si nous reconstruisons l'indicateur et ajoutons une nouvelle instance, nous pourrons masquer/afficher la ligne, la déplacer vers le haut ou vers le bas et sélectionner la couleur de notre choix comme couleur de ligne.

Comme le montre l'exemple ci-dessous, les paramètres peuvent également être utilisés pour garantir que notre indicateur n'est affiché que lorsqu'il est ajouté à des graphiques pour une période spécifique.

1
2

[Parameter("Timeframe")]
public TimeFrame TF { get; set; }

Dans la méthode Initialize(), nous vérifierons la période du graphique auquel notre indicateur est attaché. Si elle n'est pas égale à la valeur du paramètre TF, nous empêcherons l'affichage de l'indicateur.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

protected override void Initialize()
{
    if (TimeFrame != TF)
        return;

    movingAverage = Indicators.MovingAverage(Source, MaPeriod, MaType);

    if (ShowLine)
    {
        Chart.IndicatorAreas[0].DrawHorizontalLine("Line", LineLevel, LineColor);
    }
}

Nous espérons que ce guide vous a été utile pour comprendre les paramètres et leur fonctionnement dans le trading algorithmique de cTrader.