koreainvestment/open-trading-api

ChatGPT, Claude 등 LLM(Large Language Model)과 AI 에이전트가 이 저장소를 보다 쉽게 탐색할 수 있도록 llms.txt를 제공합니다.
llms.txt
[당사에서 제공하는 샘플코드에 대한 유의사항]
샘플 코드는 한국투자증권 Open API(KIS Developers)를 연동하는 예시입니다. 고객님의 개발 부담을 줄이고자 참고용으로 제공되고 있습니다.
샘플 코드는 별도의 공지 없이 지속적으로 업데이트될 수 있습니다.
샘플 코드를 활용하여 제작한 고객님의 프로그램으로 인한 손해에 대해서는 당사에서 책임지지 않습니다.
# KIS Open API 샘플 코드 저장소 (LLM 지원)
> [!NOTE]
> KIS Developers 신규 서비스 오픈 안내
> 2026년 10월 23일부터 KIS Developers에서 OpenAPI AI 에이전트와 투자전략 플레이그라운드를 새롭게 제공합니다.
> 1. OpenAPI AI 에이전트
> OpenAPI 이용 중 궁금한 사항을 AI 에이전트에게 질문해 보세요. API 사용 방법, 샘플코드 작성, 오류 해결 등 개발 과정에서 필요한 도움을 받을 수 있습니다.
> KIS Developers 로그인 후 화면 우측 하단의 챗봇 버튼을 클릭하여 이용하실 수 있습니다.
> 2. 투자전략 플레이그라운드
> 기존 GitHub에서 샘플코드로 제공하던 투자전략 생성 기능을 이제 웹에서도 직접 체험하실 수 있습니다. 별도의 개발환경 구축 없이 투자전략을 간편하게 생성해 보세요.
> - 이용 경로: KIS Developers > AI도구
> 자세한 내용은 KIS Developers 공지사항에서 확인하실 수 있습니다.
## 1. 제작 의도 및 대상
### 🎯 제작 의도
이 저장소는 ChatGPT, Claude 등 LLM(Large Language Model) 기반 자동화 환경과 Python 개발자 모두가
한국투자증권(Korea Investment & Securities) Open API를 쉽게 이해하고 활용할 수 있도록 구성된 샘플 코드 모음입니다.
examplesllm/: LLM이 단일 API 기능을 쉽게 탐색하고 호출할 수 있도록 구성된 기능 단위 샘플 코드
examplesuser/: 사용자가 실제 투자 및 자동매매 구현에 활용할 수 있도록 상품별로 통합된 API 호출 예제 코드
strategybuilder/: 비주얼 UI로 매매 전략을 설계하고, 생성된 시그널 바탕으로 매수/매도 가능
backtester/: 설계한 전략을 과거 데이터로 검증하는 백테스팅 엔진
> AI와 사람이 모두 활용하기 쉬운 구조를 지향합니다.
한국투자증권 Open API 포털 바로가기
### 👤 대상 사용자
한국투자증권 Open API를 처음 사용하는 Python 개발자
기존 Open API 사용자 중 코드 개선 및 구조 학습이 필요한 사용자
LLM 기반 코드 에이전트를 활용해 종목 검색, 시세 분석, 자동매매 등을 구현하고자 하는 사용자
## 2. 폴더 구조 및 주요 파일 설명
### 2.1. 폴더 구조
# 프로젝트 구조
├── README.md # 프로젝트 설명서
├── strategybuilder/ # 전략 설계 + 시그널 생성 엔진 ← New
├── backtester/ # 백테스팅 엔진 (QuantConnect Lean) ← New
├── docs/
│ └── convention.md # 코딩 컨벤션 가이드
├── examplesllm/ # LLM용 샘플 코드
│ ├── kisauth.py # 인증 공통 함수
│ ├── auth # 인증(토큰 발급)
│ │ ├── authtoken # REST 접근토큰 발급
│ │ └── authwstoken # 웹소켓 접속키 발급
│ ├── domesticbond # 국내채권
│ │ └── inquireprice # API 단일 기능별 폴더
│ │ ├── inquireprice.py # 한줄 호출 파일 (예: 채권 가격 조회)
│ │ └── chkinquireprice.py # 테스트 파일 (예: 채권 가격 조회 결과 검증)
│ ├── domesticfutureoption # 국내선물옵션
│ ├── domesticstock # 국내주식
│ ├── elw # ELW
│ ├── etfetn # ETF/ETN
│ ├── overseasfutureoption # 해외선물옵션
│ └── overseasstock # 해외주식
├── examplesuser/ # user용 실제 사용 예제
│ ├── kisauth.py # 인증 공통 함수
│ ├── auth # 인증(토큰 발급)
│ │ ├── authfunctions.py # 인증 함수 모음
│ │ └── authexamples.py # 인증 실행 예제
│ ├── domesticbond # 국내채권
│ │ ├── domesticbondfunctions.py # (REST) 통합 함수 파일 (모든 API 함수 모음)
│ │ ├── domesticbondexamples.py # (REST) 실행 예제 파일 (함수 사용법)
│ │ ├── domesticbondfunctionsws.py # (Websocket) 통합 함수 파일
│ │ └── domesticbondexamplesws.py # (Websocket) 실행 예제 파일
│ ├── domesticfutureoption # 국내선물옵션
│ ├── domesticstock # 국내주식
│ ├── elw # ELW
│ ├── etfetn # ETF/ETN
│ ├── overseasfutureoption # 해외선물옵션
│ └── overseasstock # 해외주식
├── legacy/ # 구 샘플코드 보관
├── stocksinfo/ # 종목정보파일 참고 데이터
├── kisdevlp.yaml # API 설정 파일 (개인정보 입력 필요)
├── pyproject.toml # (uv)프로젝트 의존성 관리
└── uv.lock # (uv)의존성 락 파일
### 2.2. 지원되는 주요 API 카테고리
아래 카테고리 및 폴더 구조는 examplesllm/, examplesuser/ 폴더 모두 동일하게 적용됩니다.
| 카테고리 | 설명 | 폴더명 |
| 인증 | 접근토큰 발급, 웹소켓 접속키 발급 | auth |
| 국내주식 | 국내 주식 시세, 주문, 잔고 등 | domesticstock |
| 국내채권 | 국내 채권 시세, 주문 등 | domesticbond |
| 국내선물옵션 | 국내 파생상품 관련 | domesticfutureoption |
| 해외주식 | 해외 주식 시세, 주문 등 | overseasstock |