Claude Code와 함께 한투 API 트레이딩 자동화를 만든 과정
2026.06.01
감 매매에서 기준 기반 매매로: Claude Code와 함께 KIS API 트레이딩 자동화를 만든 과정
소개
지난번 5명의 에이전트를 사용했는데 이번에는 좀더 현실적인 트레이딩을 목표로 새롭게 워크스페이스를 구성했다.
시간이 있을때 주식투자를 하곤 하는데, 주식 트레이딩을 하다 보면 매일 반복되는 일이 꽤 많습니다.
장 시작 전 뉴스를 확인하고, 전날 강했던 섹터를 살펴보고, 거래대금 순위를 보고, 텔레그램 채널을 돌며 재료를 확인하는 일들입니다.
처음에는 “이 정도는 직접 해야지”라고 생각했지만, 시간이 지나면서 세 가지 문제가 반복된 경험이 있습니다
장 전 리서치에 너무 많은 시간이 들었습니다.
뉴스, HTS, 거래대금 순위, 텔레그램 채널을 따로 확인하다 보니 장 시작 전에 이미 지치는 경우가 많았습니다.매매 기준이 일관되게 적용되지 않았습니다.
거래대금, 수급, 뉴스 신선도, 재료 선반영 여부를 알고는 있었지만 매번 같은 기준으로 체크하기는 어려웠습니다.정보가 여러 곳에 흩어져 있었습니다.
텔레그램, 증권사 화면, 뉴스 사이트, 거래대금 페이지를 동시에 보면서 판단하다 보니 놓치는 정보가 생겼습니다.
그래서 AI시대에 이렇게 해야하나 생각이 들었습니다.
“내가 트레이딩할때 반복해서 확인하는 기준들을 AI에게 맡길 수 없을까?”
이번 사례는 Claude Code 하네스기법과 한투 KIS OpenAPI를 활용해, 개인 투자자가 2일 동안 트레이딩 자동화 시스템을 만들어본 경험입니다.
진행 방법
1. 먼저 AI에게 “트레이딩 팀”을 설계하게 했습니다
처음부터 코드를 작성해달라고 요청하기보다, 제가 어떤 방식으로 투자하는 사람인지 먼저 설명했습니다.
국내주식투자를 단기트레이더입장에서 하려고해.
보통 데일리, 길어야 한달이내 일정매매를 하고자해
이 요청을 바탕으로 Claude Code는 하나의 자동화 프로그램이 아니라, 역할이 나뉜 에이전트 팀을 설계해줬습니다.
시장분석 에이전트: 코스피·코스닥 지수와 외국인·기관 수급 확인
종목스크리닝 에이전트: 조건에 맞는 종목 추리기
기술분석 에이전트: 차트 패턴, RSI, MACD 등 분석
뉴스분석 에이전트: 뉴스 신선도와 종목 연관성 체크
매매전략 에이전트: 진입가, 손절가, 목표가 제안
프리마켓 에이전트: 장 시작 전 강세 종목 추적
인상적이었던 점은, 제가 “이런 에이전트를 만들어줘”라고 하나하나 말하지 않았다는 것입니다.
투자 스타일을 설명하자 AI가 필요한 역할을 먼저 나눠줬습니다.
2. 매매 기준은 숫자로 구체화했습니다
자동화 시스템을 만들 때 가장 중요했던 것은 “내 기준”을 명확히 말하는 일이었습니다.
처음에는 막연하게 “좋은 종목을 찾아줘”라고 할 수도 있었지만, 그렇게 하면 결과도 막연해질 수밖에 없습니다. 그래서 제가 실제로 보는 기준을 숫자와 조건으로 구체화했습니다.
당일트레이딩이 시작된 경우 시간대별 매매전략이 필요해. 하루에도 테마순환도 있을수 있어.
그리고 거래대금이 최소 1000억이상은 되어야해. 시총도 동전주는 하면 안돼.
역대최고치를 갱신하는 지도 체크해야 하고.. 뉴스가 있는 경우는 그 뉴스가 신선한지,
연관성이 있는지, 재료선반영 여부도 체크해야 해.
거래대금도 당일순위 10위까지하고, 프로그램매수, 외국인매수가 플러스인 종목 중심으로 선정한다.
뉴스의 경우 재료의 신선도가 제일중요하다. 재탕뉴스는 힘이 약하다. 처음나오는 뉴스가 임팩이 강하다.
이 과정에서 배운 점은 단순했습니다.
AI에게는 “많은 종목”보다 “거래대금 1,000억 이상”이 훨씬 좋은 요청입니다.
숫자가 들어가면 AI가 코드를 만들 때 조건문으로 반영할 수 있습니다.
반대로 기준이 흐릿하면 결과물도 흐릿해졌습니다.
3. KIS OpenAPI 연동에서 막혔고, 공식 레포를 참고하게 했습니다
이번 자동화에서 핵심은 실시간 시세와 거래 정보를 가져오는 일이었습니다. 그래서 한국투자증권의 KIS OpenAPI를 연동하기로 했습니다.
처음에는 이렇게 물었습니다.
실시간으로 종목거래상황 모니터링이 가능한가? 증권사와 연결되어 있어야 하나?
Claude Code가 Python 기반 연동 코드를 만들어줬고, 앱키와 시크릿 키를 설정한 뒤 실행했습니다. 그런데 실제 실행 과정에서 API 경로 오류와 시장 구분 코드 문제가 발생했습니다.
이때 직접 문서를 뒤져서 원인을 찾기보다, 공식 GitHub 레포를 Claude Code에게 전달했습니다.
https://github.com/koreainvestment/open-trading-api를 참조했나?
이거 한국투자증권 오픈api인거 같아
그러자 AI가 레포 구조를 참고해 다음 문제들을 찾아 수정했습니다.
API 경로 오타
시장 구분 코드 오류
토큰 발급 관련 제한 사항
REST/WebSocket 사용 방식 차이
제가 한 일은 “공식 자료 링크를 알려준 것”이었습니다.
오류 원인을 제가 모두 이해하지 못해도, AI가 공식 자료를 기준으로 수정 방향을 찾아줬습니다.
4. 시간대별 자동 모니터링 구조를 만들었습니다
국내 주식은 시간대에 따라 봐야 할 데이터가 다릅니다.
장 전에는 NXT 시장이나 시간외 단일가를 보고, 9시 이후에는 정규장 데이터를 봐야 합니다.
그래서 다음과 같이 요청했습니다.
8시부터 nxt시장을 모니터링하다가, 8시30분에 krx시간외단일가를 보자.
그러다가 9시부터 본장을 모니터하도록 하자
이를 바탕으로 3단계 모니터링 구조를 만들었습니다.
시간 | 모드 | 데이터 소스 |
|---|---|---|
08:00~08:30 | NXT 시장 | NXT 거래대금 순위 |
08:30~09:00 | 시간외 단일가 | KRX 시간외 단일가 |
09:00~15:30 | 정규장 | 코스피·코스닥 실시간 |
이 구조 덕분에 시간에 따라 직접 화면을 바꾸지 않아도 됩니다.
정해진 시간이 되면 시스템이 자동으로 다음 단계로 넘어가고, 조건을 만족하는 종목이 나오면 알림을 줄 수 있는 구조가 되었습니다.
5. 실제 장 전 분석에 적용했습니다
시스템을 만든 다음 날 아침, 실제로 프리마켓 분석을 실행했습니다.
지금 KST 08:00입니다. 오늘 프리마켓 분석을 시작하세요.
08:00~09:00 시간외 단일가 강세 종목을 분석하고 오늘의 매매 전략을 수립하세요.
실행 흐름은 다음과 같았습니다.
프리마켓 스캔
시장 분석
종목 스크리닝
기술 분석과 뉴스 분석 병렬 실행
최종 매매 전략 수립
텔레그램 뉴스 채널 10개도 함께 읽도록 구성해, 뉴스가 단순 재탕인지 새롭게 나온 재료인지 확인하는 흐름도 추가했습니다.
결과와 배운 점
결과물
이번 작업을 통해 다음과 같은 결과물이 만들어졌습니다.
Claude Code 기반 트레이딩 자동화 하네스
시장분석, 종목스크리닝, 기술분석, 뉴스분석 등 6종 에이전트
KIS OpenAPI 연동 Python 클라이언트
시간대별 3단계 자동 전환 모니터링 스크립트
텔레그램 뉴스 10개 채널 자동 수집 파이프라인
아직 실전 운용 초기라 수익률을 말하기에는 이릅니다.
하지만 가장 큰 변화는 분명했습니다.
감으로 매매하던 흐름에서 벗어나, 기준을 세우고 그 기준을 반복적으로 확인하는 구조가 생겼습니다.
Before / After
항목 | Before | After |
|---|---|---|
장 전 리서치 | 수동으로 1~2시간 확인 | 명령 한 줄로 자동 실행 |
종목 선정 | 감과 경험에 의존 | 거래대금·수급·뉴스 기준으로 필터링 |
정보 확인 | 텔레그램, HTS, 뉴스 사이트를 따로 확인 | API와 뉴스 채널을 한 흐름으로 통합 |
매매 원칙 | 머릿속에만 존재 | 손절, 목표가, 조건을 시스템에 반영 |
이번 경험에서 배운 AI 활용 팁
1. 숫자로 말하면 결과가 달라집니다
거래대금이 많은 종목을 찾아줘
보다 아래 요청이 훨씬 효과적이었습니다.
거래대금 1,000억 이상이고, 당일 거래대금 순위 10위 이내이며,
프로그램 매수와 외국인 매수가 플러스인 종목을 우선 선정해줘.
AI는 구체적인 기준이 있을수록 더 정확하게 구현합니다.
2. 공식 문서나 레포 링크를 함께 주면 좋습니다
API 연동은 자주 막히는 영역입니다.
이때 오류 메시지만 던지는 것보다 공식 문서나 GitHub 레포를 함께 주면 AI가 훨씬 잘 도와줬습니다.
[API 이름]을 연동했는데 오류가 발생합니다.
공식 문서/레포: [링크]
오류 메시지: [오류 내용]
이 레포를 참고해서 오류 원인을 찾고 수정해줘.
이 방식은 KIS OpenAPI뿐 아니라 다른 업무용 API를 연결할 때도 그대로 사용할 수 있을 것 같습니다.
3. 코딩을 몰라도 “업무 흐름”은 설명할 수 있어야 합니다
이번 작업에서 제가 직접 복잡한 코드를 작성한 것은 아닙니다.
대신 제가 한 일은 다음에 가까웠습니다.
어떤 정보를 보는지 설명하기
어떤 기준으로 판단하는지 말하기
실행해보고 안 되는 부분을 알려주기
더 필요한 조건을 추가하기
즉, 코딩 실력보다 중요한 것은 내가 반복하는 업무를 말로 풀어내는 능력이었습니다.
다른 업무에도 적용할 수 있는 부분
이번 경험은 주식 트레이딩 자동화 사례지만, 핵심은 투자에만 있지 않습니다.
여러 곳에 흩어진 정보를 모아, 반복적으로 판단해야 하는 일은 AI 자동화의 좋은 대상입니다.
예를 들면 다음과 같은 분야에도 적용할 수 있습니다.
부동산 투자자: 매물 정보, 실거래가, 지역 뉴스 *동 수집
사업 운영자: 경쟁사 가격, 리뷰, SNS 반응 모니터링
콘텐츠 크리에이터: 트렌드 키워드, 인기 영상, 커뮤니티 반응 정리
마케터: 캠페인 성과, 광고 지표, 고객 반응 요약
반복해서 확인하는 정보가 있다면, 먼저 AI에게 이렇게 물어볼 수 있습니다.
내가 매일 반복해서 확인하는 정보는 다음과 같습니다.
이 작업을 자동화하려면 어떤 데이터, 도구, 워크플로우가 필요할지 설계해줘.
앞으로의 계획
다음 단계로는 두 가지를 추가할 예정입니다.
승률 통계 자동 집계
매매 결과가 쌓이면 어떤 조건에서 성공률이 높았는지 자동으로 분석하고 싶습니다.
예를 들어 거래대금, 뉴스 신선도, 외국인 수급, 시간대별 진입 조건을 기준으로 승률을 비교할 수 있습니다.
텔레그램 봇 알림 연동
장중에 거래대금이 급증하거나 특정 조건을 만족하는 종목이 나오면, 텔레그램으로 바로 알림을 받는 구조를 만들 계획입니다.
계속 모니터를 보고 있지 않아도 중요한 신호를 놓치지 않는 것이 목표입니다.
도움 받은 글
한국투자증권 KIS Developers Open API 공식 개발자센터
한국투자증권 KIS Open API 공식 GitHub 샘플 코드 저장소
재사용 가능한 프롬프트
프롬프트 1. 자동화 시스템 초기 설계
나는 [투자 스타일 — 예: 국내 주식 단기 트레이더]입니다.
매일 [반복하는 작업 — 예: 장 전 리서치, 종목 선별, 뉴스 확인]을 자동화하고 싶습니다.
내 기준은 [핵심 조건 — 예: 거래대금 1,000억 이상, 동전주 제외, 뉴스 신선도 체크]입니다.
이 작업을 자동화하는 에이전트 팀과 워크플로우를 설계해줘.
프롬프트 2. API 오류 해결
[API 이름]을 연동했는데 오류가 발생합니다.
공식 문서/레포: [링크]
오류 메시지: [오류 내용]
이 레포를 참고해서 오류 원인을 찾고 수정해줘.
프롬프트 3. 내 원칙을 시스템에 반영하기
내 매매 원칙은 다음과 같습니다:
- 손절: [예: -3%]
- 목표가: [예: +10%]
- 매매 금지 시간: [예: 오전 11:30~12:30]
- 기타 규칙: [예: 오후장 돌파 금지, 물타기 최대 1회]
이 원칙들을 시스템에 반영해줘.
로그인하고 댓글을 남겨 주세요
레오님의 글에선 매번 고수의 내공이 느껴집니다. 흩어진 정보를 빠르고 정확하게 수집해서 의사결정에 도움을 받는 것, 이게 정말 투자의 핵심인 것 같습니다.
저 같은 경우는 단타를 할 물리적 시간이나 여력이 안 되다 보니, 레오님 사례처럼 트레이딩 봇을 직접 구축하시는게 너무 대단해 보입니다.
특히 '승률 통계 자동 집계'를 어떻게 구현하셨는지 그 부분도 정말 궁금해지네요! 실제 장에서 봇이 어느 정도의 퍼포먼스를 내주고 있는지도 나중에 기회가 된다면 꼭 한번 들어보고 싶습니다.
다른 스터디원분들께도 도움이 될 상세한 글 남겨주셔서 감사합니다. 오늘도 행복한 하루 보내세요~



"내가 반복하는 업무를 말로 풀어내는 능력"이 중요하다는 말씀 200% 공감하고 있는 요즘입니다
크~! 핵심을 관통하셨구먼요!