콘텐츠로 이동

KIS-Agent

한국투자증권 OpenAPI Python 래퍼 — CLI & Python SDK

PyPI version PyPI Downloads Python License: MIT

주요 특징

  • CLI 도구 — pip install kis-agent 하면 kis 명령이 바로 설치됩니다
  • LLM Agent 연동 — JSON 출력 + 스키마 탐색으로 AI 에이전트 도구로 활용
  • 고성능 — 지능형 캐싱으로 API 호출 80-95% 감소
  • 실시간 — WebSocket을 통한 실시간 데이터 스트리밍
  • 국내시장 — KOSPI, KOSDAQ, NXT(넥스트) 시장 지원
  • 해외시장 — 미국, 일본, 중국, 홍콩, 베트남 9개 거래소 지원
  • 선물옵션 — 국내/해외 선물옵션 거래 지원
  • 타입 안정성 — 96개 TypedDict 응답 모델, 100% 타입힌팅

빠른 설치

pip install kis-agent

30초 만에 시작하기

CLI

kis price 005930                    # 삼성전자 현재가
kis balance --holdings              # 계좌 잔고 + 보유종목
kis overseas NAS AAPL               # AAPL 시세
kis futures 101S03                  # 선물 시세

Python

from kis_agent import Agent
import os

agent = Agent(
    app_key=os.environ['KIS_APP_KEY'],
    app_secret=os.environ['KIS_APP_SECRET'],
    account_no=os.environ['KIS_ACCOUNT_NO'],
    account_code=os.environ.get('KIS_ACCOUNT_CODE', '01'),
)

price = agent.get_stock_price("005930")
print(f"삼성전자 현재가: {price['output']['stck_prpr']}원")

다음 단계