cTrader 알고리즘의 매개변수 유형

이 글과 해당 비디오에서는 cBot 및 지표에서 사용자 정의 가능한 매개변수를 선언하고 사용하는 방법을 보여드립니다. 간단한 지표를 개발하고 cTrader UI에서 매개변수를 구성하는 방법을 보여드리겠습니다. 또한 cTrader cBot 또는 지표에서 사용할 수 있는 매개변수의 종류와 코드에서 어떻게 선언되고 사용되는지 설명하겠습니다.

사용자 정의 가능한 매개변수

사용자 정의 가능한 매개변수는 알고리즘을 추가, 시작 또는 사용할 때 설정할 수 있는 구성 가능한 값입니다. 이를 통해 소스 코드를 수정하지 않고도 cBot, 지표 및 플러그인의 동작을 사용자 정의할 수 있습니다.

이전에 설명한 바와 같이, cTrader는 이러한 매개변수 유형을 지원합니다:

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

매개변수가 있는 간단한 지표 생성

맞춤형 지표에서 매개변수를 사용하는 방법을 시연하기 위해 새로운 지표를 생성하고 Standard Deviation이라고 명명하겠습니다.

표준 편차를 계산하기 위해 먼저 가격의 이동 평균을 계산해야 합니다. 이후 이동 평균 기간부터 시작하여 이동 평균 지표에 필요한 매개변수를 선언합니다.

1

public int MaPeriod { get; set; }

지원되는 유형 중 하나를 가진 모든 공개 속성은 지표 매개변수가 될 수 있습니다. MaPeriod 속성을 매개변수로 변환하려면 필요한 선언을 추가하기만 하면 됩니다.

1
2

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

Parameter 속성은 cTrader에게 정의된 이름("MA Period")으로 지표 매개변수 패널에서 이 속성을 매개변수로 표시하도록 지시합니다.

아래와 같이 Parameter 속성을 사용하면 표시된 이름, 기본값, 이 매개변수가 배치될 그룹, 최대 및 최소값, 그리고 위아래 화살표를 누를 때 매개변수가 변경되는 단계(숫자 값만 해당)와 같은 매개변수의 일부 속성을 정의할 수 있습니다.

1
2

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

이제 이동 평균 지표에 필요한 나머지 매개변수를 추가하겠습니다. MaType 매개변수는 이동 평균 유형을 결정하는 데 도움을 줄 것입니다. 이는 cTrader UI에서 드롭다운 메뉴로 나타나는 enum입니다.

1
2

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

Source 매개변수는 사용자에게 이동 평균 지표의 데이터 소스를 지정할 수 있는 옵션을 제공합니다. 이 매개변수는 DataSeries 유형입니다.

1
2

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

이제 필요한 매개변수가 선언되었으므로 이동 평균을 정의하고 초기화하겠습니다.

1
2
3
4
5
6

private MovingAverage movingAverage;

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

이 시점에서 표준 편차 계산을 구현할 준비가 되었습니다. 기본 코드 템플릿에는 이미 계산 결과를 표시하는 데 사용할 수 있는 Output 속성이 포함되어 있습니다.

1
2

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

마지막으로 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);
}

지표를 차트에 추가하면 인스턴스 추가 창에서 모든 매개변수를 볼 수 있습니다.

추가 매개변수 추가

표준 편차를 완료한 후, 우리는 지표에 대한 시각적 임계값 역할을 할 수평선을 추가할 수도 있습니다. 이를 위해 몇 가지 매개변수를 더 추가해야 합니다.

첫 번째는 우리의 선이 표시될지 여부를 결정할 부울 매개변수입니다.

1
2

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

LineLevel 매개변수를 사용하면 선이 그려질 가격 수준을 결정할 수 있습니다.

1
2

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

또한 선 색상을 선택할 수 있는 매개변수를 추가할 것입니다.

1
2

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

필요한 모든 매개변수가 준비되면, 우리는 지표가 첨부된 차트에 선을 그리는 코드를 작성할 수 있습니다.

1
2
3
4

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

지표를 다시 빌드하고 새 인스턴스를 추가하면, 선을 숨기거나 표시하고, 위아래로 이동하며, 원하는 색상을 선 색상으로 선택할 수 있습니다.

아래 예제에서 볼 수 있듯이, 매개변수를 사용하여 특정 시간 프레임의 차트에 추가될 때만 지표가 표시되도록 할 수도 있습니다.

1
2

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

Initialize() 메서드에서 우리는 지표가 첨부된 차트의 시간 프레임을 확인할 것입니다. TF 매개변수의 값과 같지 않다면, 지표가 표시되지 않도록 할 것입니다.

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

이 가이드가 매개변수와 cTrader 알고리즘 트레이딩에서의 작동 방식을 이해하는 데 도움이 되었기를 바랍니다.