키움증권 OpenAPI 사용자 가이드 안녕하세요, 키움증권입니다. 이 문서 하나만 따라 하면 키 발급 → 설치 → 인증 → 샘플코드/Postman 실행까지 끝낼 수 있습니다. 처음 사용하는 분을 기준으로, 위에서 아래로 순서대로 진행하면 됩니다. 운영체제별로 명령이 다른 곳은 macOS/Linux와 Windows PowerShell을 나누어 표기했습니다. --- 이 저장소에 포함된 것 - kiwoom/: OAuth·REST·WebSocket 런타임과 전체 337 API 스펙 - examples/: 함수명 기반 Python 예제 362개 - OAuth 2개, 국내주식 226개, 미국주식 134개 - postman/kiwoom-openapi.postmancollection.json - HTTP API 306개를 PRD/MOCK 환경별로 제공(총 요청 612개) - mcpexec/, mcpspec/: 키움 OpenAPI를 AI 에이전트에 노출하는 MCP(Model Context Protocol) 서버. 사용법은 각 폴더의 README.md를 참고하세요. - mcpb/: 쓰는 MCP 클라이언트에 따라 둘 중 하나만 고르면 됩니다 — Claude Desktop이면 사전 빌드 .mcpb 번들(mcpexec/, mcpspec/를 packing한 것), Claude Code·Codex 같은 CLI 클라이언트면 설치 스크립트 setup-mcp-cli.sh/.ps1. 사용법은 mcpb/README.md를 참고하세요. - .env.example, pyproject.toml, uv.lock, LICENSE.md CLI 소스(kiwoomcli/)는 이 공개 저장소에 포함되지 않습니다. 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이 운영체제 자격 증명 저

⚠ No verified equity curve — no track-record source connected.

No score history is stored yet — only the current score is shown.

⚠ No live verification account connected — ask for proof before buying.

Alerts on changes: coming soon

Prop-firm compatibility not provided.

Data-completeness & trust index (not a profitability rating)