unohee/kis-agent

KIS-Agent

한국투자증권 OpenAPI Python 래퍼 - Korea Investment & Securities Trading API Client

pip install kis-agent

📖 공식 문서: unohee.github.io/kis-agent — 설치, 빠른 시작, CLI · Python API 레퍼런스, LLM Agent · MCP 연동, 아키텍처 가이드.

CLI

pip install kis-agent 하면 kis 명령이 바로 설치됩니다.

kis price 005930                    # 삼성전자 현재가
kis price 005930 --daily --days 5   # 일별 시세 5일

kis overseas NAS AAPL               # AAPL 시세
kis overseas NAS AAPL --detail      # PER/PBR/시총 포함

kis balance --holdings              # 계좌 잔고 + 보유종목
kis orderbook 005930                # 호가 10호가
kis futures 101S03                  # 선물 시세

kis trades                          # 당일 체결내역
kis trades --from 7d --pretty       # 최근 7일 (사람 읽기용)
kis trades --from 30d --sell        # 최근 30일 매도만
kis trades --from 3m --profit       # 기간별 실현손익

kis query stock get_stock_price code=005930  # API 직접 호출
kis schema Stock                    # 타입 스키마 (LLM introspection)

• JSON 출력 (LLM 파싱 최적화), --pretty로 사람 읽기용
• 한투 필드명 자동 변환: stck_prpr → currentPrice, prdy_ctrt → changeRate
• 휴장일/장외 시간 자동 감지 — 직전 영업일 기준 데이터 안내

주요 특징

• CLI 도구: 설치 즉시 터미널에서 시세 조회
• LLM Agent 연동: JSON 출력 + 스키마 탐색으로 AI 에이전트 도구로 활용
• 고성능: 지능형 캐싱으로 API 호출 80-95% 감소
• 안정성: 실측 기반 Rate Limiting (18 RPS / 900 RPM)
• 실시간: WebSocket을 통한 실시간 데이터 스트리밍
• 국내시장: KOSPI, KOSDAQ, NXT(넥스트) 시장 지원
• 해외시장: 미국, 일본, 중국, 홍콩, 베트남 9개 거래소 지원
• 선물옵션