본문으로 건너뛰기

주식투자_자동매매 시스템 구축 사례

Robin

2026.07.27

주식투자_자동매매 시스템 구축 사례 본문 이미지

소개

시도하고자 했던 것과 그 이유를 알려주세요.

현재 진행하는 주식투자에 시간이 소요되고 신경쓰이는 부분이 많아서

주식 거래 업무를 자동화하고 일정 이상 손실이 발생하는 경우 자동 로스컷을 하도록

진행 방법

어떤 도구를 사용했고, 어떻게 활용하셨나요?

클로드를 이용해서 마크다운 파일을 생성하였음.

Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.

국내주식투자를 가치투자자 입장에서 하려고해.
나는 직장인이고 많은 시간을 낼수 없으니 장기적인 관점에서 
주식을 매수하고 오래 보유하려고 해 
매수는 자동매수를 하고 일정 이상 손실이 발생하면 로스컷을 하도록 설정하고 싶어   
증권사 API와 연동해서 자동화 하도록 설계를 해줘

Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.

국내 가치투자를 자동화하려면 "스크리닝 → 매수 판단 → 자동 주문 → 로스컷 → 모니터링"이 하나의 파이프라인으로 돌아가야 합니다. 성규님이 이미 DART API 자동화 파이프라인을 만들어보신 경험이 있으니, 그 위에 증권사 API 레이어와 리스크 관리 레이어를 얹는 방식으로 설계하는 게 자연스러울 것 같습니다.

먼저 전체 구조를 그림으로 보여드리겠습니다.

V

visualize

V

visualize show_widget

전체 흐름은 "스크리닝 → 시그널 → 자동 주문 → 로스컷 모니터링 → 알림"으로 이어지는 파이프라인입니다. 성규님이 이미 DART API + Python/Node.js 파이프라인을 구축해보신 경험이 있으니, 그 자산을 그대로 재활용할 수 있는 구조로 설계했습니다.

1. 증권사 API 선택

바쁜 직장인 입장에서 자동화 안정성이 가장 중요하니 한국투자증권 KIS Developers를 추천드립니다.

  • REST 방식이라 별도 프로그램 설치 없이 클라우드 서버(AWS/GCP 소형 인스턴스나 홈서버)에서 24시간 돌릴 수 있고, Mac/Linux 개발 환경과도 궁합이 좋습니다.

  • 실시간 웹소켓도 지원해서 체결/호가 모니터링이 가능합니다.

  • python-kis 같은 커뮤니티 라이브러리와 한투 공식 GitHub 샘플이 잘 정비되어 있어 개발 부담이 적습니다.

  • 모의투자 환경을 제공해서 실전 투입 전 충분히 검증할 수 있습니다.

  • 다만 API 호출은 초당 최대 20건 제한이 있으니, 스크리닝 대상 종목 수가 많다면 배치 처리 + 딜레이 로직이 필요합니다.

키움 OpenAPI+(REST 신버전 포함)나 LS증권도 대안이 될 수 있지만, REST 기반 + 서버 자동화 편의성 면에서는 KIS가 가장 무난합니다.

2. 모듈별 설계

① 종목 스크리닝 (배치, 하루 1회 또는 주 1회)

  • DART API로 재무제표 수집(이미 파이프라인 있으심) → PBR, ROE, 부채비율, FCF, 배당수익률 등 가치투자 팩터로 유니버스 필터링

  • KOSPI/KOSDAQ 전종목 대상 스크리닝은 시세 데이터를 KIS API에서, 재무 데이터는 DART에서 가져와 병합

② 매수 시그널 생성

  • 팩터별 점수화(예: PBR 낮을수록, ROE 높을수록 가점) → 랭킹 상위 N개 종목 선정

  • 이미 보유 중인 종목은 제외하거나 비중 재조정 로직 추가

  • 결과를 큐(예: 파일 기반 job queue 또는 SQLite)에 적재

③ 자동 주문 실행

  • 스케줄러(cron 또는 APScheduler)가 매수 큐를 읽어 KIS API로 지정가/시장가 주문

  • 분할매수가 핵심입니다 — 한 번에 몰빵하지 말고, 예산을 3~5회로 나눠 며칠/몇 주에 걸쳐 매수하도록 설계하면 단가 리스크가 줄어듭니다

  • 종목당 최대 투입 비중(예: 전체 포트의 5~10% 이내) 하드캡을 코드 레벨에서 강제

④ 포지션 모니터링 & 로스컷

  • 장중 또는 장마감 후 배치로 보유 종목의 평가손익률 계산

  • 손절 기준선(예: 매입가 대비 -15%, 또는 종목별 변동성 기반 ATR 손절선)에 도달하면 자동 매도 주문 트리거

  • 여기서 반드시 "체결 확인 → 재시도 → 실패시 알림" 흐름을 넣어야 합니다. 로스컷 주문이 API 오류로 미체결되면 손실이 방치될 수 있으니, 이 부분은 가장 꼼꼼하게 설계해야 할 지점입니다.

  • 가치투자 관점에서는 단순 주가 하락이 아니라 "펀더멘털 훼손 여부"도 함께 봐야 하므로, 순수 가격 기반 로스컷 외에 분기 실적 발표 후 재무 팩터 재검증 로직을 별도로 두는 것도 고려해볼 만합니다.

⑤ 알림 & 로그

  • 매수/매도/로스컷 발생 시 Slack이나 이메일로 즉시 알림 (이미 MCP로 Slack 연동 환경 갖고 계시니 활용 가능)

  • 모든 주문 이력과 판단 근거(스크리닝 점수, 손절 트리거 조건)를 DB나 Notion에 로그로 남겨 추후 전략 점검에 활용

3. 안전장치 (필수)

  • 모의투자 최소 1~2개월 검증 후 실전 투입

  • 일일/월간 최대 손실 한도(킬스위치): 특정 손실률 도달 시 전체 자동매매 중단 + 알림

  • API 키 보안: 앱키/시크릿은 환경변수 또는 .env로 관리, .gitignore 등록 (KIS 개발 가이드에서도 강조하는 부분)

  • 수동 개입 채널: 자동 로직이 이상 동작할 때 즉시 중단할 수 있는 관리자 명령(예: Slack 명령으로 killswitch 발동) 마련

참고

자동매매 시스템은 어디까지나 도구이고, 실제 종목 선정 기준(어떤 팩터에 가중치를 둘지)이나 손절 폭 설정은 투자 성향과 리스크 허용도에 따라 달라지는 부분이라 이건 성규님이 직접 결정하셔야 하는 영역입니다. 저는 투자자문업 자격이 없어서 구체적인 손절 % 나 팩터 가중치를 추천해드리긴 어렵고요.

원하시면 위 파이프라인 중 특정 모듈(예: KIS API 인증/주문 코드, 로스컷 트리거 로직, 스케줄러 설계)부터 구체적인 코드로 같이 짜볼 수 있습니다. 어느 부분부터 시작해볼까요?

(내용 입력)

"스크리닝 → 시그널 → 자동 주문 → 로스컷 모니터링 → 알림" 순서로 진행

진행 절차

1단계 — 프로젝트 폴더 준비

mkdir 가치투자_자동매매 && cd 가치투자_자동매매
git init

앞서 만든 설계서를 이 폴더 안에 DESIGN.md로 넣어두세요. Claude Code가 세션마다 이걸 참조하게 만드는 게 핵심입니다.

2단계 — Claude Code 설치

Node.js 18 이상이 필요합니다.

npm install -g @anthropic-ai/claude-code
claude --version   # 설치 확인

프로젝트 폴더에서 claude를 실행하면 브라우저가 열리며 Anthropic 계정으로 로그인하는 절차를 안내합니다. 로그인 후엔 자격 정보가 저장되어 다음부터는 다시 로그인할 필요가 없습니다. Claude Code

3단계 — CLAUDE.md 생성

프로젝트 폴더에서 claude 실행 후 /init을 입력하면 현재 코드베이스를 분석해서 CLAUDE.md 초안을 자동 생성해줍니다. 이 파일은 매 세션 시작마다 자동으로 읽히는 파일이라, 여기에 다음을 꼭 적어두세요: Purdue University

  • "DESIGN.md의 설계를 따라 구현할 것"

  • 모의투자 계좌로만 실제 주문 테스트를 진행할 것 (실전 계좌 실수 방지)

  • 코딩 컨벤션 (타입 힌트, pydantic 사용 등)

4단계 — 설계서 순서대로 세션 진행

이전에 정리한 8절 순서(config/broker → screening → signal → execution → risk → notify → scheduler)대로, 한 세션 = 한 모듈로 나눠 진행하시길 권합니다. 예를 들어 첫 세션에서:

> DESIGN.md의 1단계(config + broker)를 구현해줘.
> KIS Developers REST API로 인증, 시세조회, 잔고조회까지만 먼저 만들고
> 테스트 코드도 같이 작성해줘.

5단계 — 권한 관리 및 검토

Claude Code는 파일을 수정하기 전 항상 승인을 요청합니다. 개별 변경을 하나씩 승인하거나, 신뢰할 수 있는 세션에서는 "accept all" 모드로 진행할 수 있습니다. 주문 실행/로스컷 모듈처럼 민감한 부분은 자동 승인 모드를 끄고 한 줄 한 줄 검토하시길 권합니다. Claudecn

6단계 — git 커밋 습관화

모듈 하나가 끝날 때마다 커밋해두면, 나중에 문제가 생겼을 때 어느 시점까지가 안전한지 되돌아가기 쉽습니다.

> 이번 모듈 구현이 끝났으니 테스트까지 통과한 상태로 git commit 해줘.

7단계 — 모의투자 검증

모듈이 하나씩 완성될 때마다 실전 계좌가 아닌 모의투자 계좌 키로 전환해서 동작을 확인하고, 최소 1개월 정도는 모의투자로 전체 파이프라인을 돌려본 뒤 실전 소액 투입으로 넘어가는 걸 권합니다 (설계서 9절 체크리스트 참고).

결과와 배운 점

배운 점과 나만의 꿀팁을 알려주세요.

원하는 결과를 입력하면 클로드가 알아서 설계를 해주고 MD 파일을 만들어 줌

클로드코드가 개발을 진행을 해줌

단계별로 나누어서 개발을 진행하고 중간에 검증하는 절차가 좋았음.

과정 중에 어떤 시행착오를 겪었나요?

내가 주로 사용하는 증권사는 삼성증권인데 API를 제공하지 않아서

예전에 사용하던 한국투자증권 계좌에서 api를 발급받는데 생각보다 절차가 복잡했음.

모의계좌를 개설하는 것으로 추천을 했는데 실제거래 계좌를 api로 발급하니 에러가 발생했으나 클로드가 원인을 파악하고 수정을 해주었음.

도움이 필요한 부분이 있나요?

주식투자 자동화를 완료하고 개별기업과 산업에 대한 분석 자동화도 추가를 하고 싶은데

이부분은 어떻게 구현할지 먼저 고민하신 선배분들의 도움이 필요합니다.

앞으로의 계획이 있다면 들려주세요.

앞으로 단계적으로 7단계까지 개발을 완료하고

텔레그램과 연동하는 기능을 추가하려고 합니다.

도움 받은 글 (옵션)

텔레그램 연동하는 부분에 대한 도움이 필요해요..

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

디
디디DD2026.07.27

매수 시그널 생성 이후 자동 주문으로의 프로세스에 사람 개입을 어느 정도 수준으로 하실지가 궁금하네요.

텔레그램 채널로의 연결은 클로드나 코덱스에서 직접 하기보다 헤르메스 이용하시는것도 좋을듯해요.

멍멍_ 프로필 이미지
멍멍_2026.07.29

역시 그간 쌓아오신 깊은 내공과 차별화된 지식 수준이 느껴집니다. 오늘도 많은 가르침 부탁 드립니다~

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기