핵심만 먼저
트레이딩뷰 파인스크립트는 차트 상단 '파인 에디터(Pine Editor)' 탭에서 바로 작성할 수 있으며, indicator() 함수로 지표 선언 후 plot()으로 선을 그리는 구조가 기본입니다.
파인스크립트를 처음 접한 건 기존 RSI 지표에 내가 원하는 신호선을 하나 더 추가하고 싶어서였습니다. 찾아보니 코드라고 겁먹을 필요가 없더라고요. 파이썬이나 자바처럼 복잡하지 않고, 트레이딩에 특화된 함수들이 이미 다 준비돼 있어서 몇 줄로 실용적인 지표를 만들 수 있었습니다.
프로그래밍 경험이 없어도 괜찮습니다. 이 글에서는 파인 에디터를 열고, 기본 구조를 이해하고, 이동평균선 하나를 직접 그려보는 것까지 단계별로 설명합니다. 첫 번째 코드를 차트에 올리는 순간의 성취감이 생각보다 큽니다.
파인스크립트를 작성하는 파인 에디터는 트레이딩뷰 차트 화면 안에 내장되어 있습니다. 별도 설치나 계정 업그레이드 없이 무료로 사용할 수 있습니다.
파인 에디터 화면 구성은 간단합니다. 왼쪽이 코드 작성 영역, 오른쪽 상단 버튼이 '차트에 추가(Add to chart)'와 '저장(Save)'입니다. 작성한 코드를 차트에 적용하려면 '차트에 추가' 버튼을 누르면 됩니다. 이후 코드를 수정하면 자동으로 차트에 반영됩니다.
파인스크립트 코드는 크게 세 부분으로 구성됩니다. 처음에 이 구조를 이해하면 나머지는 함수 이름만 배우면 됩니다.
| 구성 요소 | 역할 | 예시 |
|---|---|---|
| indicator() 선언 | 지표 이름, 오버레이 여부 설정 | indicator("내 지표", overlay=true) |
| 변수 및 계산 | 값 계산 및 조건 정의 | myLine = ta.sma(close, 20) |
| plot() 출력 | 차트에 선·색상으로 표현 | plot(myLine, color=color.blue) |
indicator()의 overlay 파라미터가 중요합니다. overlay=true로 설정하면 지표가 캔들 차트 위에 직접 그려집니다(이동평균선처럼). overlay=false로 설정하면 차트 아래 별도 패널에 그려집니다(RSI처럼).
파인스크립트에서 close는 종가, open은 시가, high는 고가, low는 저가를 의미하는 내장 변수입니다. ta.sma(close, 20)은 종가 기준 20일 단순이동평균을 계산하라는 뜻입니다. 영어지만 직관적이어서 익히기 어렵지 않습니다.
이제 직접 이동평균선 지표를 만들어봅니다. 파인 에디터에 기존 내용을 지우고 아래 구조를 참고해 입력합니다.
코드의 첫 번째 줄은 파인스크립트 버전을 선언합니다. 두 번째 줄 indicator()에서 지표 이름과 overlay 설정을 합니다. 세 번째 줄에서 ta.sma() 함수로 20일 단순이동평균을 계산하고 변수에 담습니다. 네 번째 줄 plot()으로 차트에 파란 선을 그립니다.
ta.sma() 대신 ta.ema()로 바꾸면 지수이동평균이 됩니다. 이런 식으로 내장 함수 이름만 바꾸면 다양한 지표로 변형할 수 있습니다. 트레이딩뷰 공식 문서(Pine Script Reference Manual)에 모든 내장 함수 목록이 정리되어 있어 참고하기 좋습니다.
커스텀 지표 실험이 끝나면 피플로 국내주식에서 직접 만든 지표와 기본 분석을 함께 활용해 실전 적용 가능성을 확인해볼 수 있습니다.
파인스크립트에는 주요 지표를 한 줄로 구현하는 내장 함수가 준비되어 있습니다. 자주 활용되는 것들을 정리합니다.
| 함수 | 기능 | 예시 |
|---|---|---|
| ta.sma() | 단순이동평균(SMA) | ta.sma(close, 20) |
| ta.ema() | 지수이동평균(EMA) | ta.ema(close, 12) |
| ta.rsi() | RSI 계산 | ta.rsi(close, 14) |
| ta.macd() | MACD 계산 | ta.macd(close, 12, 26, 9) |
| ta.atr() | ATR(평균진폭) 계산 | ta.atr(14) |
| ta.crossover() | 상향 돌파 조건 | ta.crossover(fastMA, slowMA) |
조건을 만족할 때 차트에 표시(플롯 모양)를 추가하는 plotshape() 함수도 유용합니다. 예를 들어 골든크로스 발생 시 캔들 아래에 화살표를 표시하는 식입니다. 처음에는 plot()과 plotshape() 두 함수만 익혀도 실용적인 지표를 충분히 만들 수 있습니다.
변수명은 영어로, 주석은 // 뒤에 적습니다. 스크립트가 길어지면 주석으로 각 블록의 역할을 적어두면 나중에 수정할 때 훨씬 편합니다.
작성한 파인스크립트를 저장하고 관리하는 방법입니다.
반대로 다른 사람이 만든 공개 지표를 불러와 수정하는 것도 가능합니다. 지표 검색창에서 원하는 공개 스크립트를 찾아 추가한 뒤, 파인 에디터에서 '오픈 소스(Open Source)' 버튼이 있으면 코드를 확인하고 복사해 내 스크립트로 저장한 뒤 수정할 수 있습니다. 이 방식으로 기존 지표를 조금씩 변형하는 게 파인스크립트 학습의 가장 빠른 방법입니다.
파인스크립트를 처음 배울 때 '이걸 꼭 배워야 하나?'라는 생각이 들었습니다. 기본 지표만으로도 충분하지 않을까 싶었거든요. 그런데 실제로 써보니 기본 지표에 조건 하나만 추가하고 싶거나, 두 지표의 신호가 동시에 만족될 때 표시해주는 기능이 필요할 때 파인스크립트가 유일한 해결책이었습니다.
제가 처음 만든 건 RSI가 30 이하면서 동시에 이동평균선 위에 있는 경우에만 화살표를 표시하는 단순한 지표였습니다. 코드는 10줄도 안 됐는데 내가 원하는 조건을 정확히 시각화해주니 차트 보는 시간이 눈에 띄게 줄었습니다. 파인스크립트는 프로그래밍 능력보다 '내가 어떤 신호가 필요한지'를 먼저 명확히 하는 것이 더 중요합니다. 그 생각이 정리되면 코드는 자연스럽게 따라옵니다.
※ 본 글은 교육·정보 제공 목적의 콘텐츠이며, 특정 종목·자산의 매수·매도 권유가 아닙니다. 투자 판단과 책임은 투자자 본인에게 있습니다.
코딩 경험이 없어도 기본적인 커스텀 지표를 만들 수 있습니다. indicator(), plot(), ta.sma() 등 소수의 핵심 함수만 이해하면 실용적인 지표를 만들 수 있습니다. 기존 공개 스크립트를 조금씩 수정하는 방식이 입문에 가장 효과적입니다.
파인 에디터 접근과 기본 스크립트 작성은 무료 계정에서도 가능합니다. 다만 스크립트 저장 개수나 일부 고급 기능은 유료 플랜에서 더 넓게 사용할 수 있습니다. 처음 배울 때는 무료 계정으로 충분합니다.
가능합니다. 커스텀 지표를 차트에 추가한 뒤 지표 이름을 우클릭하면 '알림 추가(Add alert)' 옵션이 나타납니다. 스크립트 내에서 alertcondition() 함수를 사용하면 특정 조건을 알림 조건으로 미리 정의해둘 수 있습니다.
파인스크립트 자체는 차트 지표와 신호 생성에 특화되어 있습니다. 자동 매매를 구현하려면 트레이딩뷰 웹훅 알림을 거래소 API와 연동하는 별도의 프로그램이 필요합니다. 파인스크립트는 그 신호 생성 역할을 담당하고, 실제 주문 실행은 외부 시스템이 처리하는 구조입니다.
트레이딩뷰에서 보조지표를 추가하려면 차트 상단 '지표(Indicators)' 버튼을 클릭하고 원하는 지표명을 검색한 뒤 클릭하면 즉시 차트에 적용됩니다. 모바일 앱에서도 동일한 방식으로 추가할 수 있습니다.
트레이딩뷰 알림은 지표 이름을 우클릭하거나 상단 알람 시계 아이콘을 눌러 조건을 설정하면 되며, 이메일·앱 푸시·웹훅으로 수신할 수 있습니다. 무료 계정은 활성 알림 1개로 제한됩니다.
트레이딩뷰에서 멀티 타임프레임은 화면 상단 레이아웃 아이콘으로 화면을 2~4개로 분할하고 각 창에 동일 심볼과 다른 시간대를 설정하면 구성됩니다. 심볼 동기화 옵션으로 종목 변경을 한 번에 반영할 수 있습니다.
이동평균선은 일정 기간 종가의 평균을 이어 그린 선으로, 추세의 방향과 지지·저항 기준을 제공하는 가장 기본적인 보조지표입니다. 한국에서는 5·20·60·120일선이 표준 조합으로 쓰입니다.