[바이브 코딩] Cursor AI Agent로 30분 만에 만드는 파이썬 주식 자동매매 봇 (프롬프트 포함)

[바이브 코딩] Cursor AI Agent로 30분 만에 만드는 파이썬 주식 자동매매 봇

3줄 핵심 요약

파이썬 문법을 한 줄도 몰라도 Cursor AI의 Agent 모드를 활용하면 자연어 지시만으로 주식 자동매매 봇을 완성할 수 있습니다.

API 토큰 만료, 호출 제한(Rate Limit) 등 초보자가 겪는 주요 에러는 .cursorrules 파일 세팅 하나로 사전에 방지할 수 있습니다.

본문에 제공된 실전 프롬프트 템플릿을 복사해 한국투자증권 모의계좌 환경에서 안전하게 첫 매매를 테스트해 보세요.

왜 2026년 주식 자동매매는 '바이브 코딩'인가?
준비 단계: 한국투자증권 Open API & Cursor 세팅
[핵심] 실패 확률을 0%로 줄이는 .cursorrules 템플릿
3단계로 끝내는 자동매매 스크립트 제작 프롬프트
초보자가 반드시 겪는 에러 트러블슈팅 2가지
실전 매매 전 필수 체크리스트 & 다음 단계

1. 왜 2026년 주식 자동매매는 '바이브 코딩'인가?

예전에는 파이썬으로 주식 자동매매 프로그램을 만들려면 문법 공부에만 한 달, 증권사 REST API 문서를 분석하는 데 또 몇 주가 걸렸습니다.

하지만 이제는 자연어로 의도와 로직만 전달하면 AI가 코드를 직접 설계하고 터미널 실행까지 알아서 처리하는 '바이브 코딩(Vibe Coding)' 시대입니다. 특히 최신 Cursor AI Agent는 파일 생성, 패키지 설치(pip), 실시간 디버깅까지 한 화면에서 수행하므로 비전공자도 30분이면 실제 작동하는 봇을 만들 수 있습니다.

구분	기존 전통적 코딩 방식	Cursor Agent 기반 바이브 코딩
요구 지식	파이썬 기본 문법, 클래스/비동기 처리	프로그램의 매매 로직 기획력
제작 소요 시간	최소 1~2주 소요	약 30분 ~ 1시간 내외
에러 해결	스택오버플로우 검색 및 수동 디버깅	에러 로그를 보고 AI Agent가 자가 수정
API 연동 난이도	수십 장의 공식 문서 정독 필요	API 스펙 문서 복사 후 Agent에 전달

2. 준비 단계: 한국투자증권 Open API & Cursor 세팅

실전 계좌로 바로 시작하면 작은 코드 오류에도 자산 손실이 발생할 수 있습니다. 반드시 모의투자 계좌로 시작해야 합니다.

한국투자증권 KIS Developers 접속: 회원가입 후 [모의투자] API Key(App Key) 및 App Secret 발급
Cursor 실행 및 작업 폴더 생성: 바탕화면에 stock-bot 폴더를 만들고 Cursor에서 열기
환경 변수 파일(.env) 생성: 보안을 위해 API 키는 별도 파일로 분리합니다.

# .env 파일에 본인의 정보를 입력하세요 (절대 외부 유출 금지)
KIS_APP_KEY=여러분의_모의투자_APP_KEY
KIS_APP_SECRET=여러분의_모의투자_APP_SECRET
KIS_ACCOUNT_NO=모의계좌번호_8자리
KIS_ACCOUNT_PRDT=01

3. [핵심] 실패 확률을 줄이는 `.cursorrules` 템플릿

Cursor가 엉뚱한 코드를 짜거나 구버전 라이브러리를 쓰지 않도록 작업 폴더 루트에 .cursorrules 파일을 만들고 아래 내용을 그대로 복사해 붙여넣으세요.

# Project: Python Stock Trading Bot via KIS Developers API
- Role: 너는 한국투자증권 Open API와 파이썬 금융 자동화 전문 시니어 개발자야.
- Rules:
  1. 모든 API 호출은 모의투자 서버(https://openapivts.koreainvestment.com:29443)를 기본으로 작성할 것.
  2. 중요한 보안 정보(AppKey, Secret, 계좌번호)는 절대 코드에 하드코딩하지 말고 python-dotenv로 .env에서 불러올 것.
  3. API 호출 제한(초당 건수 제한)을 방지하기 위해 time.sleep(0.2) 이상의 간격을 반드시 둘 것.
  4. 접근 토큰(Access Token)은 24시간 동안 유효하므로 매번 재발급받지 않고 token.json에 캐싱하여 재사용하는 로직을 포함할 것.
  5. 모든 함수에는 한글 주석과 명확한 print 로그를 남겨 초보자도 실행 흐름을 터미널에서 볼 수 있게 할 것.

4. 3단계로 끝내는 자동매매 스크립트 제작 프롬프트

이제 Cursor의 우측 채팅창을 Agent 모드(단축키 Ctrl+I 또는 Cmd+I)로 전환하고, 아래 프롬프트를 차례대로 입력합니다.

1단계: 토큰 발급 및 잔고 조회 스크립트 작성

프롬프트 복사하기:
"한국투자증권 모의투자 API를 이용해 OAuth 접근 토큰을 발급받고, 내 계좌의 현재 예수금과 보유 주식 잔고를 조회해 콘솔에 깔끔한 표 형태로 출력하는 account_check.py를 작성해 줘. .env 파일을 참조하고 필요한 패키지(requests, python-dotenv) 설치 명령어까지 터미널에서 실행해 줘."

2단계: 실시간 시세 조회 및 매수/매도 로직

프롬프트 복사하기:
"삼성전자(005930)의 현재가를 5초 간격으로 조회하는 로직을 만들어 줘. 간단한 이동평균선(5일선이 20일선을 상향 돌파하는 골든크로스) 조건 만족 시 모의투자 지정가 매수 주문 1주를 실행하고, 목표 수익률 +2% 달성 시 전량 매도하는 trading_strategy.py를 작성해 줘."

3단계: 통합 실행 봇 구축

프롬프트 복사하기:
"장 시작 시간(09:00)부터 장 마감(15:30)까지만 동작하며, 매수/매도 내역을 trade_log.csv에 기록하는 무한 루프 스크립트를 작성해 줘. 주말이나 공휴일에는 프로그램을 대기 상태로 유지해 줘."

5. 초보자가 반드시 겪는 에러 트러블슈팅 2가지

Cursor로 작업할 때 가장 자주 마주치는 2가지 허들과 해결 프롬프트입니다.

오류 1: `EGW00123: 초당 거래건수를 초과하였습니다` (Rate Limit)

원인: 증권사 API는 개인 사용자의 초당 호출 수를 엄격히 제한(보통 초당 5건)합니다.
해결법: 반복문 루프에 지연 시간을 주어야 합니다.
대응 프롬프트: "API 호출 시 Rate Limit 에러가 발생했어. 모든 API 요청 전후에 0.3초의 딜레이를 추가하고 재시도(Retry) 로직 3회를 적용해 줘."

오류 2: 터미널 한글 깨짐 (`UnicodeDecodeError` / 깨진 문자 출력)

원인: 윈도우 환경(CP949)과 API 응답(UTF-8) 간 인코딩 충돌입니다.
해결법: 파일 입출력 및 응답 디코딩 옵션을 명시합니다.
대응 프롬프트: "윈도우 터미널에서 print 출력 시 한글이 깨져. UTF-8 인코딩을 강제 적용하도록 스크립트 상단 설정을 수정해 줘."

6. 실전 매매 전 필수 체크리스트 & 다음 단계

모의투자 모드(openapivts) URL로 연결되어 있는가?
.gitignore에 .env와 token.json이 등록되어 GitHub 유출 위험이 없는가?
1회 주문당 매수 금액에 상한선(Safety Cap)이 걸려 있는가?

오늘 완성한 봇은 가장 기초적인 로직입니다. 실전 수익률을 높이려면 다양한 지표를 결합한 백테스팅이 필수적입니다.

[바이브 코딩] Cursor AI Agent로 30분 만에 만드는 파이썬 주식 자동매매 봇 (프롬프트 포함)