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

01배경 · 고객 요구사항

고객은 이미 TradingView에서 Pine Script로 미국주식 ETF 매매 전략을 만들어 차트에서 알림을 받고 있었습니다. 문제는 그 신호를 사람이 직접 보고 주문해야 했다는 것. 미국장은 우리 시간으로 밤~새벽에 열려, 신호가 떠도 잠들어 있으면 놓치기 일쑤였습니다.

요청은 명확했습니다. ① TradingView 전략은 그대로 두고, ② 신호가 뜨는 즉시 자동으로 실거래 주문이 나가고, ③ 별도 해외 브로커를 새로 트지 않고 국내 증권사(한국투자증권) 계좌로 운영하는 것. 여기에 더해 여러 계좌를 각각 다른 자금·비율로 독립 운용하고 싶다는 요구가 있었습니다.

실제로는 3개 계좌를 분리해, 계좌마다 예수금·매수 비율·손절 기준을 따로 두고 운용했습니다. 대상은 미국 ETF 몇 종목(예: TQQQ·SOXL 등)으로 한정한 화이트리스트 방식이라, "밤사이 신호가 떠도 사람이 대응하지 않아도 되는 완전 자동화"와 "계좌별 독립 운용" 두 가지가 이 프로젝트의 핵심이었습니다.

02구현 방식

TradingView 알림을 받아 실거래로 연결하는 웹훅(Webhook) 브릿지 구조로 설계했습니다. 흐름은 이렇습니다:

• TradingView 전략 알림 → 조건 충족 시 웹훅 메시지 발송 (계좌 번호·종목·방향 정보 포함)
• 웹훅 수신 서버 → 시크릿 검증·중복 방지 후 메시지를 파싱해 어느 계좌로 보낼지 라우팅
• 한투 KIS API → 계좌별로 예수금 조회 · 지정가 주문 전송 · 체결 확인 · 포지션 갱신
• 웹 대시보드 & 텔레그램 → 계좌별 포지션·손익을 실시간 표시하고 체결·손절 내역을 알림

TradingView 쪽 전략은 한 줄도 고치지 않고, 알림 메시지 형식만 표준화해 그대로 재사용했습니다. 비전공자인 고객이 직접 입력하는 알림이라, 파서는 플레인 텍스트와 JSON 본문 양쪽을 모두 수용하도록 만들었습니다.

구체적으로는 — 1 TQQQ 매수 같은 텍스트 또는 { "account":1, "ticker":"TQQQ", "side":"buy" } 형태의 JSON을 받아 ① 시크릿 토큰으로 위조 여부 검증 → ② 동일 신호 5초 내 재수신 폐기 → ③ 계좌·종목·방향으로 파싱해 해당 계좌 주문으로 변환하는 순서로 처리합니다. 계좌마다 인증과 주문 큐를 분리한 덕분에, 한 계좌에서 일어난 일이 다른 계좌에 영향을 주지 않습니다.

03해결한 기술 난제

• 다계좌 인증 격리 — KIS는 한 명의로도 계좌마다 App Key/Secret을 따로 발급 → 인증·토큰 캐시를 계좌별로 분리하고, 한 계좌가 인증 실패해도 정상 계좌는 그대로 운영
• 공격적 지정가 + 자동 재주문 — KIS 해외주식은 시장가 불가 → 매수는 매도호가+틱버퍼, 매도는 매수호가−틱버퍼 지정가로 즉시 체결 유도, 미체결 시(기본 30초) 최신 호가로 자동 취소·재주문(최대 3회)
• 웹훅 멱등·위조 방어 — 동일 신호가 5초 내 재수신되면 무시(TradingView 재전송 대응)하고, 사전 공유 시크릿 토큰으로 무단 호출을 차단
• REST 폴링 일원화 — 해외주식 WebSocket의 "이미 사용 중" 세션 충돌·재연결 복잡성을 피해 시세·잔고 조회를 REST 폴링으로 통일 → 코드 단순화와 안정성을 동시에 확보
• 토큰 선제 재발급 — 24시간 만료 토큰을 만료 임박 시 자동 갱신하고, 401 응답 시 즉시 재발급 후 1회 재시도해 밤사이 신호 유실을 방지

04

핵심 기능

• 3계좌 독립 자동매매 — 계좌별 예수금·매수 비율(또는 고정 금액)·매도 비율·손절 기준을 따로 설정
• 자동 청산 — 평단가 대비 −X% 손절, 미국 정규장 마감 전 장마감 청산(옵션), 손절 후 당일 재진입 차단 토글
• 거래 세션 토글 — 정규장·프리마켓·애프터마켓을 재기동 없이 즉시 켜고 끄기
• 웹 대시보드 — 누적 손익 곡선, 월간 손익 달력, 실시간 포지션·청산 버튼, 계좌별 통계(승률·손익·MDD)
• 텔레그램 봇 — 매수·매도·손절·에러 실시간 알림 + 원격 명령(현황 조회·비율 변경·전량 청산 등 다수) + 대시보드 이미지 전송
• 백테스트 리포트 — 과거 Alert + yfinance 시세로 시뮬레이션 후 PDF 성과 리포트 생성
• 24시간 클라우드 운영 — 리눅스 서버에 systemd + nginx로 무중단 상시 가동, PC를 꺼도 미국장 새벽 신호까지 자동 대응

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

• 1주차 · 연동 설계 — 웹훅 메시지 포맷 표준화(텍스트·JSON 유연 파서), KIS 인증·주문·잔고 연동 뼈대, 계좌별 설정 구조 설계
• 2주차 · 핵심 엔진 — 공격적 지정가·자동 재주문, 손절·장마감·재진입, 거래 세션 토글, 다계좌 라우팅·인증 격리 구현
• 3주차 · 화면 · 부가 — 웹 대시보드(손익곡선·캘린더·포지션), 텔레그램 봇, yfinance 백테스트·PDF 리포트
• 4주차 · 배포 · 검증 — 클라우드 배포(systemd·nginx), 모의계좌 통합 테스트 후 소액 실계좌로 실체결 검증·인수인계

06납품 결과물

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

07기술 스택

08실물 — 웹훅 페이로드와 KIS 주문 매핑

실제로 오가는 데이터가 어떻게 생겼는지가 이 구조에서 가장 궁금한 지점이라, 형식만 공개합니다 (계좌번호·키 값은 전부 플레이스홀더입니다).

① TradingView 알림 본문 — 비전공자도 직접 고칠 수 있도록 텍스트·JSON 양쪽을 받습니다.

// JSON 형태
{ "secret": "<사전 공유 토큰>",
  "account": 1,          // 1~3 : 어느 계좌로 보낼지
  "ticker":  "TQQQ",
  "side":    "buy" }

// 플레인 텍스트 형태 (같은 의미)
1 TQQQ 매수

② 수신 서버가 만드는 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 지정가
}

③ 계좌별 설정 — 계좌마다 자금·비율·손절이 독립입니다.

accounts:
  - id: 1
    cano: "<계좌 8자리>"
    buy_ratio: 0.30        # 예수금의 30%
    stop_loss_pct: -4.0
    tick_buffer: 0.02
    sessions: [regular]
  - id: 2
    cano: "<계좌 8자리>"
    buy_amount: 2000       # 고정 금액(USD)
    stop_loss_pct: -2.5
    tick_buffer: 0.03
    sessions: [pre, regular, after]

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에 따로 정리해 뒀습니다.