이미 검증된 TradingView 전략을 손 하나 대지 않고, 나스닥 선물 실거래로 자동 연결하고 싶다 —
이 요청을 한국투자증권 KIS API로 구현한 사례입니다. 해외 브로커를 새로 트지 않고 국내 증권사 계좌 그대로 운영했습니다.
플랫폼
한국투자증권 KIS API + TradingView
유형
해외선물 · 롱/숏 양방향
운영
클라우드 서버 24/7
제작 기간
약 2~3주
제작한 자동매매 프로그램 대시보드 — 실시간 포지션·손익·TradingView 시그널 로그 (예시 화면)
01배경 · 고객 요구사항
고객은 이미 TradingView에서 Pine Script로 롱·숏 진입/청산 전략을 만들어 차트에서 알림을 받고 있었습니다.
문제는 그 신호를 사람이 직접 보고 주문해야 했다는 것. 나스닥 선물은 우리 시간으로 밤에 크게 움직이는 경우가 많아,
신호가 떠도 잠들어 있으면 놓치기 일쑤였습니다.
요청은 명확했습니다. ① TradingView 전략은 그대로 두고, ② 신호가 뜨는 즉시 자동으로 실거래 주문이 나가고,
③ 별도 해외 브로커를 새로 트지 않고 국내 증권사(한국투자증권) 계좌로 운영하는 것.
나스닥 선물은 한국 시간 기준 밤~새벽에 크게 움직여, 잠든 사이 신호가 떠도 사람이 직접 대응하기 어렵습니다.
게다가 마이크로 나스닥(MNQ)처럼 틱이 촘촘한 종목은 몇 초만 늦어도 체결가가 밀리기 때문에,
"신호 도착 → 즉시 주문"의 속도와 체결가 통제 두 가지가 이 프로젝트의 핵심이었습니다.
02구현 방식
TradingView 알림을 받아 실거래로 연결하는 웹훅(Webhook) 브릿지 구조로 설계했습니다. 흐름은 이렇습니다:
TradingView 전략 알림 → 롱/숏/청산 조건 충족 시 웹훅 메시지 발송 (종목·방향·수량 정보 포함)
수신 서버 → 웹훅을 받아 유효성 검증(중복·지연·위조 방지) 후 주문 요청으로 변환
한투 KIS API → 해외선물 주문 전송 · 체결 확인 · 포지션 상태 갱신
GUI 대시보드 & 텔레그램 → 현재 포지션·손익·계약 수를 실시간 표시하고 체결 내역을 알림
시스템 구성 — 신호 수신부터 실거래·실시간 모니터링까지
TradingView 쪽 전략은 한 줄도 고치지 않고, 알림 메시지 형식만 표준화해 그대로 재사용했습니다.
고객이 앞으로 전략을 수정하더라도 브릿지는 그대로 동작합니다.
구체적으로는 — TradingView 알림을 { "action":"buy/sell/close", "symbol":"MNQ", "qty":2 } 형태의
표준 JSON으로 통일하고, 수신 서버가 ① 비밀 토큰으로 위조 여부 검증 → ② 동일 신호 재수신·지연 신호 폐기 →
③ 주문 요청으로 변환해 KIS API로 전송하는 순서로 처리합니다. 이 "브릿지"를 사이에 둔 덕분에 전략과 실거래가 느슨하게 분리돼,
한쪽을 바꿔도 다른 쪽은 그대로 갑니다.
03해결한 기술 난제
시장가 주문 제약 → 지정가 자동 산출로 우회
한투 KIS 해외선물은 상황에 따라 시장가 주문에 제약이 있어, 신호가 떠도 "그냥 시장가로 던지기"가 늘 되는 게 아닙니다.
그래서 신호가 도착하는 순간 현재 호가를 조회해 즉시 체결 가능한 지정가를 자동으로 계산하도록 만들었습니다.
덕분에 시장가 없이도 신호 즉시 진입하면서, 체결 가격이 통제돼 슬리피지 위험도 함께 낮췄습니다.
지정가 자동 산출 — 최우선 호가 기준으로 즉시 체결 가능한 지정가를 실시간 계산
지정가 자동 산출 — 신호 도착 시 최우선 호가를 조회해 +N틱(설정값) 지정가를 계산하고, 미체결이면 호가를 다시 읽어 재주문. 시장가 없이도 즉시 진입하되 슬리피지 상한을 통제
웹훅 중복·지연 방어 — 동일 신호가 두 번 오면 무시하고, 수신 지연이 설정 시간(수 초)을 넘으면 폐기해 "늦은 신호로 잘못 진입"을 차단
토큰 자동 재발급 — KIS 접근 토큰은 발급 후 24시간이면 만료 → 만료 임박을 감지해 선제 재발급하고, 재접속 시 실제 잔고·포지션을 다시 동기화
포지션 정합성 체크 — 실제 체결 결과와 내부 포지션 상태가 어긋나면 즉시 텔레그램으로 경고하고 재조회·보정
04핵심 기능
롱·숏 양방향 자동 진입·청산 — 진입/청산 신호를 그대로 실행
GUI 대시보드 — 현재 포지션·진입가·평가손익·계약 수·시간봉을 실시간 표시
텔레그램 실시간 알림 — 진입/청산/에러/토큰 재발급까지 즉시 통보
클라우드 서버 24/7 무중단 운영 — PC를 꺼도 미국장 새벽 신호까지 자동 대응
설정 저장·불러오기 — 계약 수·틱 여유·시간봉 등 파라미터를 GUI에서 조정·저장
05제작 과정 (약 2~3주)
1주차 · 요구사항·연동 설계 — 전략 신호 규칙과 주문 방식 확정, 웹훅 메시지 포맷 표준화, KIS API 인증·주문 연동 뼈대 구축
2주차 · 핵심 로직·화면 — 지정가 자동 산출·재주문 로직, GUI 대시보드, 텔레그램 알림 구현
3주차 · 배포·검증 — 클라우드 서버 배포, 토큰 재발급·재접속 안정성 점검, 소액 실계좌로 실체결 검증 후 인수인계
06납품 결과물
실행 프로그램 (GUI 대시보드 포함)
TradingView 웹훅 수신 서버 + 클라우드 배포 설정 (24/7 운영)
텔레그램 알림 봇 연동
사용설명서 + API·서버 설정 가이드
납품 후 30일 무료 AS (협의 범위 내)
07기술 스택
한국투자증권 KIS API (REST · 해외선물)TradingView Webhook (Pine Script Alert)Python웹훅 수신 서버 (Flask/FastAPI)클라우드 서버 (VPS/AWS · 24/7)Telegram Bot API
※ 본 사례는 과거 고객 요구사항을 익명 처리하여 재구성한 것이며, 수익률·수익금은 공개하지 않습니다.
알고랩은 매매 자동화 프로그램 제작 서비스이며, 종목 추천·투자 자문·수익 보장 서비스가 아닙니다.
과거 백테스트 결과가 미래 실거래 수익을 보장하지 않습니다. 해외선물·파생상품 투자는 원금 손실 위험이 있습니다.
이런 자동매매, 바로 견적 받아보세요
TradingView 전략이 이미 있으셔도, 아직 아이디어 단계여도 괜찮습니다.
알고랩이 24시간 빠르게 답변드립니다.