KIS SP Homework KIS 과제 워크북 0 / 100 점
📝 HOMEWORK
KIS

KIS 모의투자 완전 정복
한국 주식 자동매매

총점 100점 · 필수 60 + 심화 40
🎯 KIS 학습 목표 복습

한국 주식 자동매매의 완전체. OAuth + HashKey + 호가 단위 + AI 에이전트 통합. 국내 시장 대응력 완성.

🔧 핵심 도구
KIS Open API
HashKey
AI 에이전트 통합
⏱ 예상 시간
필수 4~5시간
심화 +3시간
📊 과제 배점표
과제 1
20
과제 2
20
과제 3
20
과제 4
20
과제 5
20
합계 100점 · 필수 60 + 심화 40
📍 빠른 이동
🔴 REQUIRED — 과제 1
KIS 모의투자 계좌 + OAuth 토큰 발급
배점 20

한국투자증권 Open API 가입 → 모의투자 계좌 개설 → AppKey 발급 → OAuth 토큰 획득 성공.

필수 요구사항
  • 한국투자증권 Open API 포털 가입 + 신청
  • 모의투자 계좌 개설 (가상자본 5천만원)
  • AppKey + AppSecret 발급 (36자 + 180자)
  • /oauth2/tokenP로 access_token 발급 성공 (Body: grant_type, appkey, appsecret)
  • 토큰을 Google Sheets에 캐싱해 하루 1회 재발급 원칙 구현

Paper Trading Base URL

BASE_URL: https://openapivts.koreainvestment.com:29443
TR_ID 접두어: V (모의) ← 절대 T(실전) 사용 금지!

토큰 발급:
POST /oauth2/tokenP
Body:
{
  "grant_type": "client_credentials",
  "appkey": "{{ $credentials.kis.appkey }}",
  "appsecret": "{{ $credentials.kis.appsecret }}"
}
⚠️ 1일 1회 재발급: 토큰 유효기간 24시간. 과도 발급 시 장기 차단 위험. Sheets에 token, expiry 캐싱 → 매번 체크 후 재사용.
채점 기준 (20점 만점)
A. 모의투자 계좌 개설3점
B. AppKey 발급 + 보안 관리4점
C. 토큰 발급 성공5점
D. 토큰 캐싱 로직5점
E. 24시간 재사용 검증3점
🔴 REQUIRED — 과제 2
시세 조회 + 잔고 조회 3종
배점 20

현재가 · 일봉 30일 · 잔고 3개 API를 모두 성공적으로 호출.

필수 요구사항
  • 현재가: TR_ID FHKST01010100로 삼성전자(005930) 현재가
  • 일자별 시세: TR_ID FHKST01010400로 최근 30일 OHLCV
  • 잔고 조회: TR_ID VTTC8434R로 계좌 잔고 + output1/output2 파싱
  • 필수 헤더 5종 완벽 구성 (content-type, authorization, appkey, appsecret, tr_id)
  • 응답 JSON 각 필드 의미 주석 (부록 C 참조)
채점 기준 (20점 만점)
A. 3개 API 모두 성공7점
B. 헤더 구성 정확성4점
C. 응답 파싱 품질4점
D. 에러 핸들링 (rt_cd 체크)3점
E. 주석·문서화2점
🔴 REQUIRED — 과제 3
HashKey + 매수 주문 완주
배점 20

HashKey 생성 후 시장가 매수 1건 성공 + 체결까지 확인. KIS 주문의 핵심 난관 극복.

필수 요구사항
  • 매수 Body 구성 (CANO, ACNT_PRDT_CD, PDNO, ORD_DVSN='01', ORD_QTY, ORD_UNPR='0')
  • /uapi/hashkey로 HashKey 먼저 생성
  • 완전히 동일한 Body로 실제 주문 엔드포인트 호출
  • TR_ID VTTC0802U (모의 매수), hashkey 헤더 필수
  • 응답 rt_cd='0' 확인 + ODNO(주문번호) 기록
🚨 HashKey 3대 실수:
① Body 한 글자라도 다름 → EGW00121
② HashKey 생성 후 수 분 내 주문 안 하면 무효 가능성
③ JSON 필드 순서·공백도 동일해야

안전 패턴: n8n Set 노드로 Body 객체 하나 만들고, HashKey 노드와 주문 노드 두 군데에서 같은 객체 참조.
채점 기준 (20점 만점)
A. Body 정확 구성4점
B. HashKey 생성 성공5점
C. 주문 체결 성공5점
D. ODNO 기록3점
E. EGW00121 대응 경험3점
🟣 ADVANCED — 과제 4
호가 단위 자동 계산기
배점 20

KIS 주문 실패 원인 Top 3 "호가 단위 위반"을 방지하는 자동 보정 로직.

필수 요구사항
  • 현재가에 따른 호가 단위 자동 계산 함수:
      ~100원 1원 / ~1000원 5원 / ~1만원 10원 / ~5만원 50원 / 5만원+ 100원
  • 주문 가격을 호가 단위에 맞게 자동 보정 (Math.round 사용)
  • 보정 전/후 가격 비교 로그 기록
  • Rate Limit(EGW00201) 발생 시 2초 대기 후 재시도
  • 다양한 가격대(500원/3000원/5만원/10만원) 테스트

호가 단위 계산 함수

function getTickSize(price) {
  if (price < 1000)   return price < 100 ? 1 : 5;
  if (price < 10000)  return 10;
  if (price < 50000)  return 50;
  return 100;
}

function roundToTick(price, tick) {
  return Math.round(price / tick) * tick;
}

// 사용 예
const raw = 67823;
const tick = getTickSize(raw);  // 100
const adjusted = roundToTick(raw, tick);  // 67800
채점 기준 (20점 만점)
A. 호가 단위 함수 정확성5점
B. 자동 보정 구현5점
C. 가격대 테스트4점
D. Rate Limit 재시도3점
E. 로그 기록3점
🟣 ADVANCED — 과제 5
AI 에이전트 → KIS 통합 완전체
배점 20

W7 Orchestrator의 verdict가 자동으로 KIS 한국 주식 주문으로 이어지는 통합 시스템.

필수 요구사항
  • W7 Orchestrator + Korean Stock Agent → KIS 매수 워크플로 연결
  • verdict BUY + confidence≥4 시 자동 주문 실행
  • Risk Guards 4단계 통과 시에만 주문 (부록 E)
  • 2단계 승인 시스템: Discord 버튼 승인 → 주문 실행 (5분 타임아웃)
  • 2주 이상 무중단 운영 + 체결 내역 전부 로그
🎯 완성도 체크: 이 과제를 성공하면 여러분은 "AI 분석 → 판단 → 승인 → 한국 주식 자동 주문"의 완전체를 구축한 것입니다. 입문자 수준에서 드문 성취. 이력서·포트폴리오의 핵심 프로젝트가 됩니다.
채점 기준 (20점 만점)
A. 에이전트 + KIS 통합5점
B. Risk Guards 통합4점
C. Discord 승인 시스템4점
D. 2주 무중단 운영4점
E. 로그·리포트 품질3점
Submit

📤 제출 방법 + 기한

⏰ 제출 기한: 다음 주 수업 시작 전까지. 지연 시 하루당 -2점.
📝 KIS HOMEWORK COMPLETE
한국 주식 · KIS API · HashKey · 통합 시스템
5 tasks · 100 pt · 4~8 hours