얼러트에서 베어리어블 (변수) 값을 쓰는 법

얼러트 메시지에서 변수값을 쓰려면 스페셜 플레이스홀더를 써야 합니다. 보기로, NASDAQ:AAPL 에 대한 얼러트를 만들고 메시지 박스에 아래와 같이 넣을 수 있습니다:

{{exchange}}:{{ticker}}, price = {{close}}, volume = {{volume}} 

얼러트가 트리거되면 다음과 같은 값을 받게 됩니다:

쓸 수 있는 플레이스 홀더는 다음과 같습니다:

1. {{ticker}} - 얼러트에 쓰인 심볼 티커 (AAPL, BTCUSD, 등.).

2. {{exchange}} - 얼러트에 쓰인 심볼 익스체인지 (NASDAQ, NYSE, MOEX, ). 딜레이 심볼은 거래소 끝에 “_DL" 이나 “_DLY” 이 붙습니다. 보기:, “NYMEX_DL”.

3. {{close}}, {{open}}, {{high}}, {{low}}, {{time}}, {{volume}} - 얼러트가 트리거된 바에 대한 값들. 인디케이터, 넌스탠다드 차트 및 드로잉에 대한 얼러트는 레졸루션 영향을 받지만 심플 프라이스 얼러트 (보기: 어떤 값 돌파하는 프라이스) 는 언제나 1분 바에서 셈하게 됩니다. {{time}} 은 UTC 이며, 포맷은 yyyy-MM-ddTHH:mm:ssZ 입니다. 보기: 2019-08-27T09:56:00Z. 나머지 값들은 1245.25 처럼 고정 소숫점 포맷입니다.

4. {{timenow}} - 얼러트 발생 타임, 포맷은 {{time}} 과 같습니다. 레졸루션 무관하게 가장 가까운 초값으로 리턴. 

5. {{plot_0}}, {{plot_1}}, ... {{plot_19}} - 얼러트에서 쓰이는 인디케이터의 해당 아웃풋 시리즈. 플롯 번호는 0부터 시작합니다. 가장 큰 플롯 ID 는 19 (첫 20 개 아웃풋 시리즈만 액세스할 수 있습니다) 입니다. 아웃풋 시리즈는 차트위에서 볼 수 있는 인디케이터 값들입니다. 보기: 빌트인 볼륨 인디케이터는 두 개의 아웃풋 시리즈가 있습니다: 볼륨과 볼륨 MA. 인디케이터에 대해 얼러트를 만들고 아래와 같은 메시지 박스를 타이핑할 수 있습니다: 

Volume: {{plot_0}}, Volume average: {{plot_1}}

6. {{interval}} - 얼러트가 만들어진 차트의 인터벌 (그러니까, 타임프레임/레졸루션) 을 리턴합니다. 기술적인 까닭으로 어떤 경우에는 이 플레이스홀더가 차트의 타임프레임 대신 "1"을 리턴하기도 합니다. 레귤러 프라이스 베이스 얼러트 ("AAPL 크로싱 120" 또는 "AMZN 이 3600 보다 더 큰" 과 같은 컨디션을 가진) 는 모두 심볼의 라스트 밸류를 기초로 하고 있어 차트 타임프레임은 얼러트와는 무관합니다. 이렇기 때문에 모든 프라이스 베이스 얼러트는 사실상 1m 타임프레임에서 셈이 되며 플레이스홀더는 늘 그에 따라 "1" 을 리턴합니다. 덧붙여서, 레인지 차트 또한 1m 데이터를 기초로 셈하기 때문에 {{interval}} 플레이스홀더는 레인지 차트에서 만든 모든 얼러트에 대해 언제나 "1"을 리턴합니다. 드로잉이나 인디케이터에 만든 얼러트에 대해서는 이 플레이스홀더는 잘 돌아갑니다.

7. {{syminfo.currency}} - 는 현재 기호의 통화 코드("EUR", "USD" 등)를 반환합니다.

8. {{syminfo.basecurrency}} - 심볼이 통화쌍을 가리키는 경우 현재 심볼의 기본 통화 코드를 반환합니다. 그렇지 않으면 na를 반환합니다. 예를 들어, 심볼이 "EURUSD"인 경우 "EUR"을 반환합니다.

프레픽스가 "strategy" 인 플레이스홀더는 스트래티지 얼러트에서만 쓸 수 있습니다:

• {{strategy.position_size}} - 파인 키워드와 같은 값을 리턴, 다시 말해, 커런트 포지션 사이즈를 리턴.
• {strategy.order.action}} - 체결된 오더에 대해 “바이” 또는 “셀” 스트링을 보여줌.
• {{strategy.order.contracts}} - 체결 오더의 컨트랙트 수 리턴.
• {{strategy.order.price}} - 체결 프라이스 리턴.
• {{strategy.order.id}} - 체결 오더 ID 리턴 (다음 오더 펑크션의 첫 파라미터로 쓰인 스트링: strategy.entry, strategy.exit or strategy.order).
• {{strategy.order.comment}} - 체결 오더 코멘트 리턴 (다음 오더 펑크션의 코멘트 파라미터로 쓰인 스트링: strategy.entry, strategy.exit or strategy.order). 코멘트가 없으면 strategy.order.id 밸류 리턴.
• {{strategy.order.alert_message}} - 다음 오더 내는 펑크션 콜때 스트래티지의 파인 코드에서 쓰이는 alert_message 파라미터 밸류 리턴: strategy.entry, strategy.exit or strategy.order. 이 피처는 파인 V4 이상에서만 쓸 수있습니다.
• {{strategy.market_position}} - 스트래티지의 커런트 포지션을 다음 스트링 폼으로 리턴: “long”, “flat”, or “short”.
• {{strategy.market_position_size}} - 커런트 포지션 사이즈 리턴.
• {{strategy.prev_market_position}} - 스트래티지의 프리비어스 (이전) 포지션을 다음 스트링 폼으로 리턴: “long”, “flat”, or “short”.
• {{strategy.prev_market_position_size}} - 이전 포지션 사이즈 절대값 (0 이상) 리턴.

얼러트가 트리거되면 해당 밸류를 볼 수 있게 됩니다:

파인 스크립트로 짠 아래의 plot 펑크션에 대해:

• plot;
• plotshape;
• plotchar;
• plotarrow;
• plotbar;
• plotcandle.

플레이스홀더 {{plot_0}}, {{plot_1}}, ... {plot_19}}를 쓸 수 있을 뿐만 아니라 이름으로도 인식할 수 있습니다. 그러려면 플레이스홀더 {{plot(“Name”)}}을 쓰면 됩니다. 여기서 Name은 시리즈의 이름입니다. 보기로, plotarrow 함수의 경우:

//@version=6indicator('My script')plotarrow(close, colorup=color.new(color.teal,40), colordown=color.new(color.orange, 40) , title = 'arrow')

알림 텍스트에 {{plot("arrow")}} 를 넣으십시오.

plotcandle 및 plotbar 펑크션의 경우 각 펑크션이 4개의 시리즈(오픈, 하이, 로우, 클로즈)를 나타내므로 이름으로 시리즈에 액세스하는 것은 지원되지 않습니다. 각 시리즈에 대해 적절한 번호를 붙인 플레이스홀더를 쓸 수 있습니다.

빌트인 인디케이터에는 일련 번호가 영어로 된 플레이스홀더만 사용할 수 있습니다. 보기로, 볼륨 인디케이터의 경우:

거래량: {{plot(“Volume”)}}, 거래량 평균: {{plot(“Volume MA”)}}

얼러트에 여러 개의 인디케이터가 쓰이는 경우 첫 번째 인디케이터의 값만 {{plot}} 플레이스홀더로 치환됩니다:

위의 보기에서는 “My script1” 인디케이터의 시리즈 값이 플레이스홀더로 들어가게 됩니다. “My script2” 인디케이터의 값을 나타내려면 첫 번째 드롭다운 메뉴에서 해당 인디케이터를 고르십시오.

alertcondition 펑크션의 메시지 아규먼트에도 플레이스홀더를 지정할 수 있으며, 얼러트를 만들 때 이 아규먼트의 값은 자동으로 얼러트 텍스트 인풋 박스에 나타나게 됩니다.

스알러트 조건 함수의 조건으로 얼러트를 만들 때 값을 바꾸면 4버전(Pine v4) 이상에서 작성된 스크립트에서 작동한다는 점에 유의하세요.

트리거된 얼러트의 값은 메시지에서 원하는 주소로 변수 값을 전송함으로 웹훅과 함께 사용할 수 있습니다. 또는 이미 동적 값 사용을 활용하고 있는 MT4/MT5에 트레이딩뷰 얼러트와 같은 써드 파티 앱을 사용할 수도 있습니다. 이 보기 스크립트에서 몇 가지 구문 사용 사례를 확인할 수 있습니다. 얼러트를 사용하는 분들에게 더 많은 가능성을 열어줍니다.