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

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관련 사례 · 더 보기