koreainvestment/open-trading-api

Korea Investment & Securities Open API Github

What it solves

이 프로젝트는 Korea Investment & Securities(KIS) Open API와 통합하기 위한 포괄적인 샘플 코드와 도구를 제공합니다. 시장 데이터 접근, 계좌 관리, 거래 실행 과정을 단순화하며, 국내·해외 주식, 채권, 선물/옵션 등 다양한 금융 상품을 지원합니다.

How it works

레포지토리는 사용자의 필요에 따라 다음과 같이 계층화되어 있습니다:

  • LLM-Optimized Samples (examples_llm/): AI 에이전트가 쉽게 탐색하고 특정 API 기능을 호출할 수 있도록 설계된 작고 단일 함수 코드 스니펫.
  • User-Integrated Samples (examples_user/): 자산 클래스별로 정리된 함수와 실행 예제로, 인간 개발자를 위한 것입니다.
  • Strategy Builder: 기술 지표를 사용해 거래 전략을 시각적으로 설계하고 매수/매도/보유 신호를 생성하는 UI 도구.
  • Backtester: Docker 기반 엔진(QuantConnect Lean 사용)으로 설계된 전략을 과거 데이터로 검증합니다.
  • Authentication: kis_auth.py 모듈이 토큰 발급 및 환경 전환(실거래 vs. 모의거래)을 중앙에서 관리합니다.

Who it’s for

  • KIS Open API를 처음 사용하는 Python 개발자.
  • 기존 API 구현이나 구조를 개선하고자 하는 트레이더.
  • 주식 검색, 가격 분석, 자동 거래를 수행하는 AI 기반 트레이딩 에이전트를 구축하는 개발자.

Highlights

  • AI-Ready Structure: llms.txt 파일과 특정 폴더 구조를 포함해 ChatGPT, Claude 등 LLM이 API에 쉽게 접근할 수 있도록 설계되었습니다.
  • End-to-End Pipeline: Strategy Builder에서 전략 설계, Backtester에서 히스토리 검증, 실행까지 전체 워크플로우를 지원합니다.
  • Broad Asset Support: 국내·해외 주식, 채권, ELW, ETF/ETN, 선물/옵션을 포괄합니다.
  • Preset Strategies: Golden Cross, Momentum, Mean Reversion 등 10개의 사전 정의된 거래 전략을 제공해 빠르게 시작할 수 있습니다.