트레이딩뷰 웹훅으로 한투 미국주식 다계좌 자동매매

01배경과 고객 요구사항

고객은 이미 TradingView에서 Pine Script로 미국주식 ETF 매매 전략을 만들어 차트 알림을 받고 있었습니다. 다만 신호를 보고 주문은 직접 넣어야 했습니다. 미국장은 우리 시간으로 밤부터 새벽까지 열리니, 자는 동안 뜬 신호는 놓치기 일쑤였습니다.

요청은 이랬습니다. TradingView 전략은 그대로 두고, 신호가 뜨면 바로 실거래 주문이 나갈 것. 해외 브로커를 새로 트지 않고 한국투자증권 계좌로 운영할 것. 여기에 계좌 여러 개를 각각 다른 자금과 비율로 따로 운용하고 싶다는 요구가 더해졌습니다.

실제로는 3개 계좌로 나눠, 계좌마다 예수금, 매수 비율, 손절 기준을 따로 두었습니다. 대상은 미국 ETF 몇 종목(예: TQQQ, SOXL)으로 한정했고 목록에 없는 종목은 주문하지 않습니다. 밤사이 신호에 사람이 대응하지 않아도 되는 것, 그리고 계좌마다 따로 운용되는 것이 이 작업에서 가장 중요했습니다.

02구현 방식

TradingView 알림을 받아 실거래로 넘기는 웹훅 서버를 가운데에 두었습니다.

• TradingView 전략이 조건을 충족하면 웹훅 메시지를 보냅니다. 메시지에는 계좌 번호, 종목, 방향이 들어 있습니다.
• 수신 서버는 시크릿을 검증하고 중복을 걸러낸 뒤, 메시지를 읽어 어느 계좌로 보낼지 정합니다.
• 한투 KIS API로 계좌별 예수금을 조회하고, 지정가 주문을 보내고, 체결을 확인해 포지션을 갱신합니다.
• 웹 대시보드에 계좌별 포지션과 손익이 실시간으로 표시되고, 체결과 손절 내역은 텔레그램으로 옵니다.

TradingView 쪽 전략은 한 줄도 고치지 않았습니다. 알림 메시지 형식만 정해서 그대로 썼습니다. 고객이 직접 입력하는 알림이라 일반 텍스트와 JSON을 둘 다 받게 했습니다.

1 TQQQ 매수 같은 텍스트나 같은 내용의 JSON이 오면, 먼저 시크릿 토큰으로 위조 여부를 확인합니다. 같은 신호가 5초 안에 다시 오면 버립니다. 그다음 계좌, 종목, 방향을 읽어 해당 계좌의 주문으로 바꿉니다. 계좌마다 인증과 주문 대기열을 분리해서, 한 계좌에서 생긴 일이 다른 계좌에 영향을 주지 않습니다.

03어려웠던 부분

• KIS는 같은 명의라도 계좌마다 App Key와 Secret을 따로 발급합니다. 그래서 인증과 토큰을 계좌별로 분리했고, 한 계좌가 인증에 실패해도 다른 계좌는 계속 운영됩니다.
• KIS 해외주식은 시장가 주문이 안 됩니다. 매수는 매도호가에 틱 버퍼를 더한 지정가, 매도는 매수호가에서 틱 버퍼를 뺀 지정가로 냅니다. 기본 30초 동안 체결되지 않으면 취소하고 최신 호가로 다시 주문하며, 최대 3회까지 반복합니다.
• TradingView는 같은 알림을 다시 보내는 일이 있어서, 같은 신호가 5초 안에 또 오면 무시합니다. 미리 정해 둔 시크릿 토큰이 없는 호출은 받지 않습니다.
• 해외주식 WebSocket은 이미 사용 중이라는 세션 충돌이 나고 재연결 처리도 까다롭습니다. 시세와 잔고 조회를 REST로 통일하니 코드가 단순해졌습니다.
• 토큰은 만료가 가까워지면 자동으로 갱신합니다. 인증 오류 응답이 오면 바로 재발급하고 한 번 더 시도해서 밤사이 신호를 놓치지 않게 했습니다.

04

주요 기능

• 3개 계좌가 따로 움직입니다. 계좌별로 예수금, 매수 비율(또는 고정 금액), 매도 비율, 손절 기준을 설정합니다.
• 평단가에서 설정한 %만큼 내려가면 손절합니다. 미국 정규장 마감 전 청산은 옵션이고, 손절한 날의 재진입을 막는 토글도 있습니다.
• 정규장, 프리마켓, 애프터마켓 거래는 프로그램을 다시 띄우지 않고 바로 켜고 끕니다.
• 웹 대시보드에서 누적 손익 곡선, 월간 손익 달력, 실시간 포지션과 청산 버튼, 계좌별 통계(승률, 손익, MDD)를 봅니다.
• 텔레그램 봇은 매수, 매도, 손절, 오류를 알리고, 현황 조회나 비율 변경, 전량 청산 같은 원격 명령을 받습니다. 대시보드 이미지도 보내 줍니다.
• 과거 알림과 yfinance 시세로 시뮬레이션해 PDF 성과 리포트를 만드는 백테스트가 들어 있습니다.
• 리눅스 서버에서 상시 가동하므로 PC를 꺼도 미국장 새벽 신호에 대응합니다.

05제작 과정 (약 3~4주)

• 1주차에 웹훅 메시지 형식을 정하고 텍스트와 JSON을 모두 읽는 파서를 만들었습니다. KIS 인증, 주문, 잔고 연동의 뼈대와 계좌별 설정 구조도 이때 잡았습니다.
• 2주차에는 지정가 주문과 자동 재주문, 손절, 장마감 청산, 재진입 차단, 거래 세션 토글, 계좌별 라우팅과 인증 분리를 구현했습니다.
• 3주차에 웹 대시보드(손익 곡선, 달력, 포지션), 텔레그램 봇, yfinance 백테스트와 PDF 리포트를 붙였습니다.
• 4주차에는 클라우드에 배포하고 모의계좌로 통합 테스트를 한 뒤, 소액 실계좌로 실제 체결을 확인하고 인수인계했습니다.

06납품 결과물

• 서버 프로그램 (웹훅 수신, 주문 엔진, 손절과 장마감 모니터링, 텔레그램 봇, 웹 대시보드)
• 웹 대시보드 (손익 통계, 월간 달력, 거래 히스토리, 로그인 인증)
• 텔레그램 알림과 원격 조정 봇 연동
• 백테스트 모듈 (PDF 리포트 포함)
• 클라우드 24시간 배포 설정 (리눅스 systemd, nginx)
• 사용설명서, API와 서버 설정 가이드, 설정 파일 템플릿
• 납품 후 30일 무료 AS (협의 범위 내)

07기술 스택

08웹훅 메시지와 KIS 주문 형식

실제로 오가는 데이터의 형식만 공개합니다. 계좌번호와 키 값은 전부 자리 표시입니다.

TradingView 알림 본문은 고객이 직접 고칠 수 있게 텍스트와 JSON을 둘 다 받습니다. 텍스트라면 1 TQQQ 매수처럼 계좌 번호(1~3), 종목, 방향을 적습니다. JSON에는 미리 정한 토큰이 함께 들어갑니다.

수신 서버는 이 메시지를 아래와 같은 KIS 해외주식 주문으로 바꿉니다. 수량과 틱 버퍼는 계좌별 설정에서 계산해 채웁니다.

POST /uapi/overseas-stock/v1/trading/order
tr_id: TTTT1002U            # 미국 매수 (매도는 TTTT1006U)
                            # 모의투자: 매수 VTTT1002U / 매도 VTTT1001U
{
  "CANO":            "<계좌 8자리>",
  "ACNT_PRDT_CD":    "<상품코드 2자리>",
  "OVRS_EXCG_CD":    "NASD",   // NASD, NYSE, AMEX
  "PDNO":            "TQQQ",
  "ORD_QTY":         "12",
  "OVRS_ORD_UNPR":   "78.42",  // 매도호가 + 틱 버퍼
  "ORD_SVR_DVSN_CD": "0",
  "ORD_DVSN":        "00"      // 00 지정가
}

계좌별 설정은 서로 독립입니다. 예를 들어 1번 계좌는 예수금의 30%를 매수하고 -4.0%에 손절하며 정규장에만 거래합니다. 2번 계좌는 고정 금액 2,000달러, 손절 -2.5%에 프리마켓부터 애프터마켓까지 거래하도록 둘 수 있습니다.

09자주 묻는 것

TradingView 웹훅으로 미국주식 자동매매가 실제로 되나요?

됩니다. 다만 두 가지가 꼭 있어야 합니다. TradingView가 같은 알림을 다시 보내는 경우가 있어서 중복 방지가 필요하고, 웹훅 주소는 누구나 호출할 수 있어서 시크릿 검증이 필요합니다. 이 사례에서는 같은 신호가 5초 안에 다시 오면 버리고, 미리 정한 토큰으로 위조 호출을 막았습니다. 웹훅 연동의 원리는 트레이딩뷰 웹훅 자동매매 가이드에 적어 두었습니다.

계좌를 여러 개 돌리면 뭐가 어려워지나요?

인증과 호출량이 계좌 수만큼 늘어납니다. 토큰을 계좌별로 따로 관리해야 하고 (KIS access_token 재발급 규칙), 같은 시각에 나가는 호출이 몇 배가 되어 초당 거래건수 초과(EGW00201)에 먼저 걸립니다. 계좌번호 항목을 잘못 채워서 나는 오류도 흔합니다. 그건 CANO와 ACNT_PRDT_CD 정리를 보시면 됩니다.

국내주식으로도 같은 구조가 되나요?

됩니다. 다만 국내는 장중에 개별 종목 거래가 잠깐 멈추는 구간이 있어서 주문 전에 확인할 것이 하나 더 있습니다. VI(변동성완화장치) 발동 구간에서는 시장가 주문도 바로 체결되지 않습니다. 증권사를 아직 고르는 중이라면 증권사 API 비교부터 보시기를 권합니다.

10관련 사례

이 사례에서 쓴 KIS 해외주식 주문 API의 tr_id, 거래소 코드, ORD_DVSN 명세는 KIS API 미국주식 주문: TTTT1002U와 ORD_DVSN에 따로 적어 두었습니다.