kiwoompy

키움증권 REST API Python 라이브러리

키움증권 OpenAPI(https://openapi.kiwoom.com)를 Python에서 간편하게 사용할 수 있도록 만든 라이브러리입니다.

특징

• OAuth2 인증 — 접근토큰 발급·만료 관리 자동화
• 환경 분리 — 모의투자(demo) / 실계좌(real) 한 줄로 전환
• 유량 제어 내장 — 모의 2건/초, 실전 20건/초 자동 적용 (커스터마이징 가능)
• 자동 재시도 — 네트워크 오류·5xx 서버 오류 지수 백오프 재시도
• 입력값 보완 — 계좌번호 상품코드 누락 시 자동 보완 + 경고 로그
• 타입 힌트 완전 지원 — IDE 자동완성 및 정적 분석 최적화
• Python 3.12+

빠른 시작

from kiwoompy import KiwoomClient

# 모의투자 환경 — 토큰 발급까지 한 줄로
client = KiwoomClient(
    env="demo",
    appkey="YOUR_APP_KEY",
    secretkey="YOUR_APP_SECRET",
)

시작하기 → API 레퍼런스 →

키움증권 REST API 알리미

키움증권 REST API 공지사항·변경 사항을 텔레그램으로 받아볼 수 있는 채널입니다.

📢 텔레그램 채널 구독하기

새 공지가 등록될 때마다 자동으로 알림이 전송됩니다.

AI / LLM 지원

이 문서 사이트는 llms.txt 스펙을 지원합니다.

AI 에이전트나 LLM이 kiwoompy를 파악할 때 아래 파일을 활용할 수 있습니다.

• /llms.txt — 문서 구조 및 주요 페이지 링크 요약
• /llms-full.txt — 전체 문서 + API 레퍼런스 (함수 시그니처·파라미터·반환값 포함)