# kiwoompy

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

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

- [홈](/index.md): 키움증권 REST API Python 라이브러리
- [시작하기](/getting-started.md): kiwoompy 설치부터 접근토큰 발급까지의 기본 흐름을 안내합니다.

## 가이드

- [계좌·잔고 조회](/guides/account.md): 계좌번호 목록, 예수금, 보유 종목 잔고, 수익률, 미체결·체결 내역을 조회하는 방법을 안내합니다.
- [주문하기](/guides/order.md): 매수·매도·정정·취소 주문 흐름과 각 메서드 사용법을 안내합니다.
- [시세·종목 정보](/guides/market-data.md): 현재가, 종목 기본정보, 일별 주가, 차트 데이터, 순위 정보를 조회하는 방법을 안내합니다.
- [실시간 시세](/guides/realtime.md): WebSocket을 통해 주식 체결, 호가, 주문체결 등 실시간 데이터를 수신하는 방법을 안내합니다.
## 예제

- [포트폴리오 모니터링](/examples/portfolio-monitor.md): 보유 종목의 현재 평가금액, 손익, 수익률을 조회해서 출력하는 예제입니다.
- [조건부 자동 주문](/examples/auto-order.md): 현재가를 조회해서 조건에 맞으면 자동으로 주문을 제출하는 예제입니다.
- [실시간 현재가 수신](/examples/realtime-price.md): WebSocket으로 주식 체결 데이터를 실시간으로 수신하는 예제입니다.
## API 레퍼런스

- [개요](/api/index.md): kiwoompy의 전체 공개 API 목록입니다.
- [인증 (auth)](/api/auth.md): 키움증권 OAuth2 접근토큰 발급 및 유효성 관리를 담당하는 모듈입니다.
- [HTTP 클라이언트 (api)](/api/client.md): KiwoomApi와 KiwoomAuth를 통합한 사용자 진입점 파사드입니다.
- [모델 (models)](/api/models.md): 요청·응답 데이터 구조 및 타입 별칭을 정의하는 모듈입니다.
- [예외 (exceptions)](/api/exceptions.md): kiwoompy 커스텀 예외 계층을 정의하는 모듈입니다.
- [유틸리티 (utils)](/api/utils.md): 입력값 정규화 등 공통 유틸리티 함수를 제공하는 모듈입니다.
- [조회 (query)](/api/query.md): 시세, 잔고, 계좌, 종목 정보 등 각종 조회 기능을 담당하는 모듈입니다.
- [주문 (order)](/api/order.md): 매수·매도·정정·취소 등 주문 기능을 담당하는 모듈입니다.

모든 페이지 전체 내용(API 레퍼런스 포함)은 [/llms-full.txt](/llms-full.txt)에서 확인할 수 있습니다.