콘텐츠로 이동

Python 알고리즘에서 사용자 정의 가능한 매개변수

Python 트레이딩 봇, 기술 지표 또는 플러그인을 개발할 때 사용자 정의 가능한 매개변수를 추가하고 구성해야 할 수 있습니다. 이 문서는 cTrader용 Python 알고리즘에서 사용자 정의 가능한 매개변수를 선언하고 사용하는 방법을 설명합니다.

참고

cTrader Python 알고리즘의 실행 모델은 .NET/C# 엔진을 포함하며, 모든 사용자 정의 가능한 매개변수는 .cs 파일 내에서 선언되어야 합니다. cTrader에서 Python 알고리즘을 생성할 때마다 해당 알고리즘에 대한 .cs 파일이 자동으로 생성되어 관련 폴더에 저장됩니다.

위치

Python 알고리즘에 대한 .cs 파일의 위치는 알고리즘 유형(cBot, 지표 또는 플러그인)과 알고리즘 이름에 따라 다릅니다.

  • cBot의 경우: Documents/cAlgo/Sources/Robots/{cBot-name}/{cBot-name}/
  • 지표의 경우: Documents/cAlgo/Sources/Indicators/{Indicator-name}/{Indicator-name}/
  • 플러그인의 경우: Documents/cAlgo/Sources/Indicators/{Plugin-name}/{Plugin-name}/

Python 알고리즘에 대한 .cs 파일을 찾으려면 다음 지침을 따르세요:

  1. cTrader Windows 또는 Mac에서 알고리즘을 마우스 오른쪽 버튼으로 클릭한 후 폴더에서 보기를 선택합니다.

  2. {name-of-algorithm}/{name-of-algorithm}을 탐색한 후 파일 목록에서 .cs 파일(C# 소스 파일)을 식별합니다.

.cs 파일은 일반적으로 알고리즘과 동일한 이름을 가지며, 모든 공백이 제거됩니다. 예를 들어, Amazing Aroon cBot이라는 알고리즘은 AmazingArooncBot.cs 파일을 생성합니다.

팁

동일한 폴더에서 알고리즘의 주요 Python 코드에 액세스할 수 있으며, 이는 Amazing Aroon cBot_main.py와 같은 .py 파일에 저장됩니다. Python 파일은 간단한 명명 규칙을 따릅니다:

  • cBot의 경우: cBot-name_main.py
  • 지표의 경우: Indicator-name_main.py
  • 플러그인의 경우: Plugin-name_main.py

내용

.cs 파일을 NotePad 또는 Visual Studio Code와 같은 텍스트 또는 코드 편집기에서 열면 다음과 유사한 코드를 볼 수 있습니다:

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

참고

템플릿을 사용하지 않고 처음부터 Python cBot을 생성한 경우 빈 클래스를 볼 수 있습니다.

.cs 파일에 선언된 모든 매개변수는 코드 편집기에 표시된 코드가 포함된 주요 Python 파일에서 사용할 수 있습니다. 아래 주요 Python 코드는 사용자 정의 가능한 매개변수의 사용을 보여줍니다:

 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")

# <strong>Import cAlgo API types</strong>
from cAlgo.API import *

# <strong>Import trading wrapper functions</strong>
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)

장점

사용자 정의 가능한 매개변수의 주요 장점은 cTrader Windows, Mac, Web 및 Mobile을 포함한 모든 cTrader 앱의 UI에서 편집 가능한 필드로 나타난다는 것입니다. 이러한 필드의 값은 알고리즘의 소스 코드에 액세스하거나 수정할 필요 없이 쉽게 수정하여 필요나 작업에 맞출 수 있습니다.

cTrader 스토어에서 판매자는 종종 사용자 정의 가능한 매개변수를 사용하여 알고리즘의 구매자가 자신의 목표와 워크플로우에 맞게 알고리즘을 조정할 수 있도록 합니다.

Image title