Pine Script와 Webhook 기반 자동매매 시스템 연동: alertcondition() 및 JSON 페이로드(Payload) 활용법

 안녕하세요, 트레이더 여러분!

매일 차트 앞을 지키며 손가락이 부르트도록 매수·매도 버튼을 누르느라 피곤하셨죠? " 내가 자는 동안에도 내 전략대로 알맞게 주문이 나갔으면 좋겠다"라는 생각, 차트를 보며 다들 한 번쯤은 해보셨을 텐데요.

오늘은 트레이딩뷰(TradingView)의 강력한 지표 언어인 Pine Script와 외부 서버를 연결해 주는 Webhook(웹훅), 그리고 데이터의 전달 매개체인 JSON 페이로드를 활용해 완전 자동매매 시스템의 초석을 다지는 방법을 아주 쉽게 풀어드리려고 합니다. 천천히 따라오시면 여러분의 훌륭한 전략이 24시간 일하는 나만의 분신으로 탈바꿈할 거예요!

1. Webhook 기반 자동매매의 동작 원리 이해하기

자동매매 시스템을 구축하기에 앞서, 데이터가 어떻게 흘러가는지 구조를 파악하는 것이 중요합니다.


[ 트레이딩뷰 (Pine Script) ] 

                  │  ▼ (신호 발생 및 알림) 

[ Webhook (JSON Payload 전달) ] 

                  │ ▼ (HTTP POST 요청) 

[ 중계 서버 (Python / Node.js 등) ] 

                  │ ▼ (API 키 서명 및 서명 생성)

 [ 거래소 API (Binance, Bitget, Upbit 등) ]


  1. 지표/전략 감지: 트레이딩뷰 차트에서 Pine Script로 작성한 기술적 지표나 전략 조건이 충족됩니다.

  2. 웹훅 알림(Alert) 발송: 조건이 만족되면 트레이딩뷰가 설정된 Webhook URL로 HTTP POST 요청을 보냅니다. 이때 매수/매도 정보가 담긴 JSON 페이로드가 함께 전송됩니다.

  3. 중계 서버 수신 및 시그널 처리: 서버(Python, Node.js 등)가 웹훅 데이터를 전달받아 요청을 검증하고, 거래소 규격에 맞는 API 서명(Signature)을 생성합니다.

  4. 거래소 API 주문 실행: 최종적으로 바이낸스, 비트겟, 업비트 등 거래소에 실제로 주문(Market/Limit Order)이 제출됩니다.

2. Pine Script에서 alertcondition() 작성법

Pine Script 버전 4와 버전 5에서는 알림을 발생시키기 위해 alertcondition() 함수를 사용합니다. 특정 조건이 참(True)이 되었을 때 알림 팝업을 띄우거나 웹훅을 호출할 수 있도록 설정하는 역할을 합니다.

기본 문법 구조

alertcondition(condition, title, message)

  • condition: 알림이 실행될 조건 (예: 이동평균선 골든크로스)

  • title: 트레이딩뷰 알림 설정 창에 표시될 이름

  • message: 웹훅 호출 시 기본으로 전달할 메시지 (JSON 형태로 작성)

실제 코드 예시 (EMA 크로스오버 전략)

Below is an example Pine Script v5 code using alertcondition() to generate long and short signals.

//@version=5

indicator("EMA Crossover Webhook Alert", overlay=true)


// 이동평균선 설정

fastLen = input.int(9, title="Fast EMA Length")

slowLen = input.int(21, title="Slow EMA Length")


fastEMA = ta.ema(close, fastLen)

slowEMA = ta.ema(close, slowLen)


// 차트 플롯

plot(fastEMA, color=color.blue, title="Fast EMA")

plot(slowEMA, color=color.orange, title="Slow EMA")


// 매수 / 매도 조건 정의

longCondition  = ta.crossover(fastEMA, slowEMA)

shortCondition = ta.crossunder(fastEMA, slowEMA)


// alertcondition 함수 등록

alertcondition(longCondition, title="Long Signal (Buy)", message='{"action": "buy", "symbol": "{{ticker}}", "price": {{close}}, "volume": 0.01}')

alertcondition(shortCondition, title="Short Signal (Sell)", message='{"action": "sell", "symbol": "{{ticker}}", "price": {{close}}, "volume": 0.01}')

3. 웹훅 전달용 JSON 페이로드(Payload) 최적화

트레이딩뷰에서 중계 서버로 전송할 메시지는 표준 JSON(JavaScript Object Notation) Format을 준수해야 합니다. 구문 오류(Syntax Error)가 발생하면 중계 서버에서 데이터를 해석하지 못하므로 쌍따옴표(") 처리에 주의해야 합니다.

필수 및 주요 파라미터 구성

파라미터 키설명예시 값
action매수/매도 및 수량 조절 명령어"buy", "sell", "close"
symbol거래 대상 종목 / 틱기호"BTCUSDT", "ETHUSDT"
price신호 발생 시점의 가격{{close}}
quantity / volume주문 수량 또는 시드 비중0.01, "5%"
passphrase인증용 보안 비밀번호 (선택)"my_secret_token_123"

동적 변수 동기화 (TradingView Dynamic Variables)

트레이딩뷰는 메시지 안에 중괄호 두 개({{ }})를 사용해 차트의 실시간 데이터를 동적으로 삽입할 수 있습니다.

  • {{ticker}}: 종목 코드 (예: BTCUSDT)

  • {{close}}: 신호 발생 봉의 종가

  • {{timenow}}: 신호 발생 시각 (Unix Timestamp)

  • {{strategy.order.contracts}}: 전략 주문 수량

웹훅 전송용 JSON 예시

[ 매수 진입 메시지 ]

{

  "passphrase": "secret_key_value",

  "action": "buy",

  "symbol": "{{ticker}}",

  "price": {{close}}, "qty": 0.002,

  "timestamp": "{{timenow}}"

}

4. 트레이딩뷰 알림(Alert) 및 Webhook URL 설정 단계

스크립트 작성을 마쳤다면 트레이딩뷰 UI에서 웹훅 연결을 활성화해야 합니다.

  1. 차트에 지표 추가: Pine Editor에서 코드를 저장하고 차트에 넣기(Add to Chart)를 클릭합니다.

  2. 알림 생성 (Create Alert):

    • 차트 상단의 시계 아이콘(Alert)을 누르거나 Alt + A 단축키를 입력합니다.

  3. 조건(Condition) 선택:

    • 드롭다운 메뉴에서 적용한 지표 이름(EMA Crossover Webhook Alert)을 찾고, Long Signal (Buy) 또는 Short Signal (Sell)을 선택합니다.

  4. 메시지(Message) 확인:

    • alertcondition()에서 미리 작성한 JSON 문자열이 자동으로 입력되어 있는지 확인합니다.

  5. 알림 탭(Notifications) 설정:

    • Webhook URL 체크박스를 활성화합니다.

    • 중계 서버의 엔드포인트주소(예: [https://your-server-domain.com/webhook](https://your-server-domain.com/webhook))를 입력합니다.

  6. 만들기(Create) 클릭: 설정이 마무리되면 해당 조건이 충족될 때마다 지정한 서버 URL로 POST 요청이 전달됩니다.

5. 중계 서버 수신 예시 (Python Flask 기준)

웹훅 데이터를 받아 거래소 API로 전달하는 간단한 파이썬 서버 코드 구조는 다음과 같습니다.

from flask import Flask, request, jsonify


app = Flask(__name__)


# 보안용 토큰 설정

SECRET_PASSPHRASE = "secret_key_value"


@app.route('/webhook', methods=['POST'])

def webhook():

    data = request.get_json()


    # Passphrase 검증

    if data.get('passphrase') != SECRET_PASSPHRASE:

        return jsonify({"status": "error", "message": "Unauthorized"}), 401


    action = data.get('action')

    symbol = data.get('symbol')

    price = data.get('price')

    qty = data.get('qty')


    print(f"[시그널 수신] {action.upper()} | 종목: {symbol} | 가격: {price} | 수량: {qty}")


    # TODO: 이곳에 바이낸스, 비트겟 등 거래소 API 주문 함수(CCXT 등)를 연동합니다.

    # execute_order(action, symbol, qty)


    return jsonify({"status": "success", "message": "Order executed"}), 200


if __name__ == '__main__':

    app.run(host='0.0.0.0', port=5000)

6. 자주 발생하는 오류 및 주의사항

  • JSON 구문 오류: JSON 문법 내에 쉼표(,) 오타나 큰따옴표 누락이 없는지 반드시 파이썬 json.loads() 등으로 검증하세요.

  • 봉 완성 전 신호 튀김(Repainting): 알림 발생 빈도를 봉 마감 시 1회(Once Per Bar Close)로 설정해야 봉이 바뀌는 과정에서 임시로 발생했다 사라지는 가짜 신호에 실거래가 나가는 것을 막을 수 있습니다.

  • 서버 보안: Webhook URL이 외부에 노출될 경우 악의적인 주문 요청이 들어올 수 있습니다. 반드시 JSON 내부에 인증용 passphrase 필드를 두고 서버에서 이를 검증하도록 설계하세요.

어떠셨나요? 처음에는 Pine Script 코드와 JSON이라는 용어 때문에 어렵게 느껴질 수 있지만, 개념을 차근차근 따라가다 보면 생각보다 직관적이라는 걸 알게 되실 거예요!

트레이딩뷰의 시그널 감지 능력과 거래소 API의 빠른 주문 속도가 합쳐지면 뇌동매매를 줄이고 훨씬 정교한 나만의 매매 시스템을 완성할 수 있답니다.

오늘 정리해 드린 내용을 바탕으로 소액부터 차근차근 테스트해 보시길 권장해요. 개발하시다가 막히는 부분이나 궁금한 점이 있다면 언제든 댓글로 편하게 남겨주세요! 여러 트레이더분들의 성투를 늘 응원합니다. 대박 나세요!








Location: 대한민국

댓글

댓글 쓰기

이 블로그의 인기 게시물

엔트로픽 상장일 전망과 관련주 총정리: 클로드(Claude) 개발사의 IPO 주식 투자 가이드

이미지
  인공지능(AI) 시장의 판도가 변화하고 있습니다. ChatGPT의 강력한 창대항마로 꼽히는 클로드(Claude) 개발사 엔트로픽(Anthropic)이 본격적인 상장(IPO) 절차에 착수하면서 글로벌 증시와 국내 주식 시장이 크게 요동치고 있습니다. 엔트로픽 주식 상장이 왜 이토록 큰 관심을 받고 있는지, 예상 상장일부터 핵심 관련주, 그리고 최고경영진의 오픈AI 퇴사 비하인드 까지 한 번에 정리해 드리겠습니다. 1. 엔트로픽(Anthropic)은 어떤 회사인가? (클로드와 엔트로픽 퇴사 스토리) 엔트로픽을 이해하려면 인공지능 업계의 최대 이슈였던 '오픈AI 집단 퇴사 사건'을 알아야 합니다. 오픈AI 퇴사파가 설립한 기술 기업 2021년, 오픈AI(OpenAI)의 핵심 연구원이었던 다리오 아모데이(Dario Amodei)와 다니엘라 아모데이(Daniela Amodei) 남매를 비롯한 핵심 연구 인력이 오픈AI를 퇴사했습니다. 이들은 AI의 급격한 상업화 과정에서 '안전성(Safety)'이 경시되는 것을 우려하여, '헌법적 AI(Constitutional AI)'라는 철학을 바탕으로 엔트로픽을 설립했습니다. 독주를 위협하는 AI 모델 '클로드(Claude)' 엔트로픽이 출시한 LLM 클로드(Claude 3, 3.5, 3.7 등)는 방대한 텍스트 처리 능력, 뛰어난 코딩 퍼포먼스, 그리고 엄격한 윤리적 가이드라인을 갖추며 기업용(B2B) AI 시장을 급속도로 점유했습니다. 아마존(Amazon)과 구글(Google)로부터 수조 원대 투자를 유치하며 단숨에 생성형 AI 시장의 3강 체제를 구축했습니다. 2. 엔트로픽 상장(IPO) 추이 및 예상 상장일 글로벌 투자자들의 가장 큰 관심사는 "엔트로픽 상장일이 언제인가?"입니다. 상장 신청 진행 상황: 엔트로픽은 미국 증권거래위원회(SEC)에 비공개 상장 예비 심사(Confidential IPO Filing)를 제출한 것으...
Read more »

RSI와 MACD를 결합한 나만의 커스텀 다중 하단 지표 제작 완벽 가이드

이미지
  보조지표를 활용한 기술적 분석 시 가장 흔히 발생하는 문제는 '지표 과다로 인한 차트의 가독성 저하'와 '단일 지표가 유발하는 속임수(False Signal)'입니다. 대표적인 역추세 및 강도 지표인 RSI(Relative Strength Index)와 추세 모멘텀 지표인 MACD(Moving Average Convergence Divergence)를 하나로 융합하면, 차트 하단 영역을 효율적으로 절약하면서 신호의 신뢰도를 획기적으로 높일 수 있습니다. 1. 개별 지표의 원리와 결합 시너지 ① RSI (상대강도지수) 원리: 일정 기간 동안 가격의 상승폭과 하락폭의 상대적 크기를 수치화하여 $0 \sim 100$ 사이로 나타냅니다. 장점: 시장이 불타오르거나(과매수, 보통 70 이상) 침체된 상태(과매도, 보통 30 이하)를 명확하게 포착합니다. 단점: 강한 추세장에서는 RSI가 과매수/과매도 영역에 오랫동안 머물며 조기 진입에 따른 손실을 유발할 수 있습니다. ② MACD (이동평균수렴·다이버전스) 원리: 단기 이동평균선과 장기 이동평균선 사이의 거리를 측정하여 추세의 방향과 모멘텀 변화를 파악합니다. 장점: 추세의 전환 시점을 시각적(MACD 선, Signal 선, Histogram)으로 직관적으로 보여줍니다. 단점: 이동평균 기반이므로 신호가 다소 후행하는 경향이 있습니다. ③ 결합 시너지 효과 RSI와 MACD를 결합하면 "RSI가 극단적 과매도 구간에 도달한 상태에서 MACD의 골든크로스가 발생할 때만 진입"하는 등의 조건부 필터링이 가능해집니다. 이를 통해 RSI의 조기 진입 위험과 MACD의 후행성을 상호 보완할 수 있습니다. 2. 커스텀 지표 설계 구조 하나의 지표 창 내에 RSI와 MACD를 직관적으로 배치하기 위한 설계 알고리즘입니다. 메인 축 (Y축): RSI의 기본 스케일인 $0 \sim 100$ 을 메인 축으로 설정합니다. 기준선 설정: 과매수( $70$ ), 과매도( $3...
Read more »

[파이썬 자동매매] CCXT 웹소켓(WebSocket)으로 해외 거래소 호가창 실시간 수집 및 DataFrame 재구성

 안녕하세요! 요즘 코인 자동매매나 알고리즘 트레이딩에 푹 빠져 계신가요? 트레이딩봇을 만들 때 가장 심장이 되는 데이터가 바로 실시간 호가창(Order Book) 정보인데요. 오늘은 개발자들 사이에서 끝판왕 라이브러리로 불리는 CCXT 와 실시간 데이터의 핵심인 웹소켓(WebSocket)을 결합하여, 해외 거래소의 오더북을 실시간으로 긁어오고 판다스(Pandas) 데이터프레임으로 깔끔하게 정리하는 방법을 완벽하게 파헤쳐 보겠습니다. 1. 왜 REST API 대신 웹소켓(WebSocket)과 CCXT를 써야 할까? 암호화폐 시장은 1초가 아니라 밀리초(ms) 단위로 가격이 급변합니다. REST API 방식: 우리가 흔히 쓰는 fetch_order_book() 방식은 거래소에 "지금 호가 줘!" 하고 요청(Request)을 보내야만 응답(Response)을 받는 구조입니다. 이걸 0.1초마다 반복하면 거래소로부터 IP 차단(Rate Limit) 폭탄을 맞기 딱 좋죠. WebSocket(웹소켓) 방식: 반면 웹소켓은 거래소 서버와 한 번 연결을 맺어두면, 호가창에 변동이 생길 때마다 거래소에서 알아서 실시간으로 데이터를 쑤셔 넣어주는(Push) 방식입니다. CCXT 라이브러리의 장점: 바이낸스, 바이비트, OKX 등 수십 개가 넘는 해외 거래소마다 API 규격이 다릅니다. 하지만 CCXT 를 사용하면 표준화된 코드로 이 거대한 거래소들을 일관되게 제어할 수 있어 개발 생산성이 하늘과 땅 차이로 올라갑니다. 2. 개발 환경 세팅 및 필수 라이브러리 설치 이 작업을 수행하기 위해서는 파이썬 환경이 필요하며, 실시간 비동기 처리를 위해 ccxt (특히 웹소켓을 지원하는 ccxt.pro )와 pandas 패키지가 필수적입니다. 터미널이나 명령 프롬프트에서 아래 명령어를 입력해 필요한 라이브러리를 설치해 주세요. pip install ccxt pandas asyncio 참고: CCXT는 프로 버전( ccxt.pro )을 통해 웹소켓 비동기 기...
Read more »