2) 문법구조 이해하기

파인스크립트의 문법구조에 대해 알아봅시다. 예시로 사용되는 코드는 Indicator 타입의 코드를 활용합니다. 파인스크립트에서는 반드시 필요한 필수구문이 존재하며, 해당 구문을 누락할 경우 컴파일오류가 나며 작동하지 않습니다.

1. 필수함수

• pinescript는 맨처음 행에 반드시 버전선언이 이루어져야 하며, 아래와 같이 선언합니다.

//@version = 5

• 버전선언이 완료 되었다면, 코드타입에 대한 선언이 필요합니다. 코드타입은 1) indicator : 지표형태의 코드로, 가장 일반적인 코드타입입니다. 2) strategy : 전략형태의 코드로, 트레이딩 뷰에서 제공되는 백테스팅 데이터와 함꼐 broker를 연결하여, 실제 트레이딩을 진행할 수 있습니다. 3) library : 라이브러리형태의 코드로, 자주 사용하는 구조의 코드를 모듈화 하여, 퍼블리싱한 후 지속적으로 import 하여, 사용할 수 있습니다.

• 코드타입에 대한 선언은 버전선언 다음 행에서 작성되어야 하며, 다음과 같이 작성합니다.

//@version = 5
indicator(title = "인디케이터 제목", overaly = "true or false", format = 포맷타입)

• 코드타입 선언 시 사용되는 다양한 param 중 일반적으로 사용되는 param 은 1) title = "인디케이터 제목" 2) overlay = "true or false" >> overlay = true 일때 해당 인디케이터는 메인화면에 출력되며, overlay = false 일때는 하단에 별도의 지표로 출력됩니다. 3) format >> format param 은 반드시 선언해야되는 것은 아니며, default 값으로는 format = format.price 가 적용됩니다. 만약 백분율 형태로 출력하고 싶다면, format = format.percent 로 선언하면됩니다.

overlay = true 일때와 false 일때의 출력화면

• 파인스크립트 버전과 코드타입 선언이 끝났다면, 마지막으로 필요한 요소는 바로 "출력" 함수입니다. 파인스크립트에서 사용되는 "출력"함수는 plot, plotshape, bgcolor 등 다양한 방법으로 화면상에 출력시킬 수 있으며, 가장 기본적은 plot 함수는 코드 작성자가 계산한 값을 화면상에 실선(line), 끊어진 실선(linebr), 점선(circles), 막대 그래프(columbs) 등 다양한 형태로 출력할 수 있으며, 이는 style param 설정을 통해 작성하면 됩니다. 작성방법은 plot() 함수 작성시 사용 되는 param에 대한 자세한 설명은 다음과 같습니다.

//@version = 5
indicator(title = "example_code", overlay = true, format = format.price)
//plot
plot(open, style = plot.style_line, color = color.new(color.red,50), title = "open price")

• plot(출력 할 함수, style = 출력 스타일, color = color.new(출력 색상, 투명도), title = "이름")

예제코드에서는 시가를 나타내는 open 값을 출력하였습니다. 이렇게 파인스크립트에서는 미리 선언해둔 수들을 별도의 연산없 사용할 수 있습니다. 이러한 변수를 내장변수(built ins variables)라고 말합니다. 표적인 예시로 open : 시가, high : 고가, low : 저가, close : 종가, hlc3 : (high+low+close)/3 등이 있습니다.