프로젝트 소개

이 저장소는 한국투자증권 KIS Open API를 연동하기 위한 샘플 코드와 보조 도구를 제공한다. examples_user는 상품별로 통합된 함수와 실행 예제를 제공하며, examples_llm은 단일 API 기능별로 최소 호출 파일과 검증 파일을 분리해 LLM 코드 에이전트가 탐색하기 쉽게 구성했다고 명시한다. 공통 kis_auth.py는 접근 토큰 발급 및 관리, 실전/모의 환경 전환, 공통 API 호출, 웹소켓 연결 설정을 다룬다. 다루는 API 카테고리는 인증, 국내주식, 국내채권, 국내선물옵션, 해외주식, 해외선물옵션, ELW, ETF/ETN이다. REST 예시와 함께 웹소켓을 통한 실시간 호가 구독 예시도 있다. 사용하려면 KIS Open API 신청 후 앱키, 앱시크릿, HTS ID, 계좌번호를 kis_devlp.yaml에 설정해야 하며, Python 3.11 이상과 uv 사용을 권장한다. 추가 도구로 strategy_builder는 비주얼 UI로 매매 전략을 설계하고 BUY/SELL/HOLD 신호를 생성하며, 80개 기술지표와 10개 프리셋 전략을 지원한다. backtester는 Docker 기반 QuantConnect Lean으로 과거 데이터 검증, 파라미터 최적화, HTML 리포트를 제공하고, 전략은 .kis.yaml 형식으로 공유된다. MCP 디렉터리는 KIS Code Assistant와 Trading MCP를 통한 AI 도구 연결을 다룬다. 전략 도구 사용에는 Node.js 18+와 Docker Desktop이 필요할 수 있다. 제공사는 샘플 코드를 참고용으로 안내하며, 코드는 별도 공지 없이 갱신될 수 있고 이를 활용한 프로그램으로 인한 손해에 대해 책임지지 않는다고 명시한다.