{"repo":"Kiwoom-Securities/Kiwoom-REST-API","free":true,"listed":false,"github":"https://github.com/Kiwoom-Securities/Kiwoom-REST-API","clone":"git clone https://github.com/Kiwoom-Securities/Kiwoom-REST-API.git","description":"키움증권 공식 REST API 클라이언트 · 샘플코드 · CLI(kwcli)","language":"Python","stars":31,"topics":["cli","fintech","kiwoom","korea","openapi","python","rest-api","securities","stock-trading","algorithmic-trading"],"license":null,"category":"api-integrations-sdks","readme_excerpt":"Kiwoom OpenAPI 사용자 가이드 이 문서 하나만 따라 하면 키 발급 → 설치 → 인증 → 샘플코드/Postman 실행 까지 끝낼 수 있습니다. 처음 사용하는 분을 기준으로, 위에서 아래로 순서대로 진행하면 됩니다. 운영체제별로 명령이 다른 곳은 macOS/Linux 와 Windows PowerShell 을 나누어 표기했습니다. --- 이 저장소에 포함된 것 - kiwoom/ : OAuth·REST·WebSocket 런타임과 전체 337 API 스펙 - examples/ : 함수명 기반 Python 예제 362개 - OAuth 2개, 국내주식 226개, 미국주식 134개 - postman/kiwoom-openapi.postman collection.json - HTTP API 306개를 PRD/MOCK 환경별로 제공(총 요청 612개) - .env.example , pyproject.toml , uv.lock , LICENSE.md CLI 소스( kiwoom cli/ )는 이 공개 저장소에 포함되지 않습니다. CLI가 필요하면 PyPI 패키지 kwcli 를 별도로 설치하며, 설치 후 명령은 kiwoomcli 입니다. Postman Collection에는 OAuth 2, 국내 HTTP 183, 미국 HTTP 121개가 포함되고, WebSocket API 31개는 Python 예제로 제공합니다. --- 시작하기 전에 - 인증은 PyPI CLI( uv tool install kwcli 후 kiwoomcli setup )로 하는 것을 권장합니다. App Key/Secret이 운영체제 자격 증명 저장소(macOS Keychain, Windows 자격 증명 관리자, Linux Secret Service)에 저장되며, 프로젝트 폴더나 Git에는 저장되지 않습니다. - CLI로 인증하면 같은 자격 증명을 샘플코드( examples/ )도 그대로 사용합니다. 즉 CLI 인증만 마치면 .env 를 따로 만들지 않아도 예제가 실행됩니다. - 반대로 .env 를 만들어 두면 예제가 그쪽을 먼저 사용하므로, CLI로 인증하는 경우에는 .env 를 만들지 마세요. .env 방식은 자격 증명 저장소를 쓸 수 없는 환경을 위한 대체 경로이며 부록 A에서 다룹니다. --- 빠른 시작 (Quickstart) App Key/Secret을 이미 발급받았다면, 아래 순서대로 진행하면 됩니다. 각 단계의 자세한 설명은 이어지는 절에 있습니다. macOS/Linux Windows PowerShell --- 1단계: 키움 App Key / Secret 발급 키움증권 OpenAPI를 호출하려면 App Key 와 App Secret 이 필요합니다. - 운영(real) 과 모의투자(demo) 는 키가 서로 다릅니다. 사용할 환경의 키를 발급받으세요. - 발급받은 키는 외부에 노출되지 않도록 보관합니다. 문자 메시지/메일/공유 문서에 그대로 두지 마세요. 발급 절차(요약): 1. 키움증권 OpenAPI 포털에 로그인합니다. 2. OpenAPI 사용 신청 후 앱(App)을 등록합니","default_branch":null,"files":null,"tree":[],"storefront":"/r/Kiwoom-Securities","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Kiwoom-Securities/Kiwoom-REST-API/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}