한국투자증권 오픈API(KIS Developers)와 파이썬으로 주식 자동매매 프로그램을 만들고, 맥 한 대에서 사람 손 없이 굴리는 방법을 다루는 책입니다.

토큰을 받고 시세를 조회하고 주문을 한 번 내는 예제는 많습니다. 이 책은 그다음을 다룹니다. 실계좌에서 몇 달을 굴리면 나오는 문제들입니다. 재기동하다 보유 종목을 잃는 문제, 같은 주문이 반복해서 나가는 문제, 백테스트는 좋았는데 실전에서 어긋나는 문제를 원인, 확인 방법, 고치는 설계, 고쳤는지 검증하는 방법 순서로 정리했습니다.

[이런 분께 맞습니다]

- 한국투자증권 API로 시세 조회와 주문까지는 해 봤는데, 계속 켜 두기가 불안한 분
- 백테스트 수익률을 믿어도 되는지 판단할 기준이 필요한 분
- 윈도우나 클라우드 서버 없이 맥에서 자동매매를 돌리고 싶은 분
- 매매 아이디어를 조건과 판단 표로 옮기는 과정을 보고 싶은 분

[끝까지 따라 하면 갖게 되는 것]

- 토큰을 캐시해 발급 제한에 걸리지 않고, 초당 호출 제한을 지키는 API 연결부
- launchd로 자동 기동되고, 재기동해도 보유 포지션을 잃지 않는 실행 구조
- 파일 하나로 켜고 끄는 3단계 킬스위치와 중복 없는 알림
- 주문 기록과 체결 원장을 나눈 손익 장부
- 전방참조, 과최적화, 거래비용 누락을 걸러 내는 백테스트 점검표

[다른 자료와 다른 점]

1. 연결이 아니라 운영을 다룹니다. 3부 전체가 무인 운영과 사고 복구입니다.
2. 모든 장에 "고쳤는지 어떻게 아는가"가 있습니다. 저자가 확인한 결과를 표로 싣습니다.
3. 맥 기준으로 씁니다. launchd 등록, 파이썬 절대 경로, 환경변수와 작업 폴더 지정을 다룹니다.
4. 백테스트를 믿기 전에 확인할 것을 일곱 장에 걸쳐 다룹니다.

[구성]

- 0편 모의투자에서는 보이지 않는 것들
- 1부 연결한다: REST 방식, 앱키와 토큰, 시세 응답, 호출 제한, 모의투자와 실계좌
- 2부 주문을 낸다: 준비 중
- 3부 무인으로 굴린다: launchd, 재기동, 킬스위치, 알림, 사고 복구, 로그와 원장
- 4부 전략을 검증한다: 채택 기준, 전방참조, 이상치, 구간 분리, 연도별 확인, 비용, 실전 괴리
- 5부 매매방법을 구현한다: 규칙을 조건식으로, 진입·청산 분리, 공시 데이터, 포지션 크기, 여러 매매법
- 부록: 약관, 공개 데이터, 세금, 자주 나오는 오류, 자주 묻는 질문

[알려 드릴 것]

이 책은 프로그램을 안정적으로 굴리는 방법을 다룹니다. 특정 종목을 추천하지 않고, 수익을 약속하지 않습니다. 필자는 유사투자자문업자가 아니며 개별 상담을 하지 않습니다. 세금과 약관 내용은 2026년 9월 기준이며 법률·세무 자문이 아닙니다.