kwcli 1.0.2__tar.gz → 1.0.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. {kwcli-1.0.2 → kwcli-1.0.3}/PKG-INFO +41 -76
  2. {kwcli-1.0.2 → kwcli-1.0.3}/README.md +40 -75
  3. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/mapped.py +17 -1
  4. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/spec.py +30 -2
  5. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/streams.py +6 -0
  6. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/api_commands.csv +42 -42
  7. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/arguments.csv +10 -10
  8. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/output.py +9 -3
  9. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/registry.py +2 -0
  10. {kwcli-1.0.2 → kwcli-1.0.3}/pyproject.toml +1 -1
  11. {kwcli-1.0.2 → kwcli-1.0.3}/LICENSE.md +0 -0
  12. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/__init__.py +0 -0
  13. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/_data/kiwoom_api_spec.json +0 -0
  14. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/__init__.py +0 -0
  15. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/auth.py +0 -0
  16. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/client.py +0 -0
  17. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/errors.py +0 -0
  18. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/platform_paths.py +0 -0
  19. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/profiles.py +0 -0
  20. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/runtime.py +0 -0
  21. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/secrets.py +0 -0
  22. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/settings.py +0 -0
  23. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/token_store.py +0 -0
  24. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/types.py +0 -0
  25. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/ws_client.py +0 -0
  26. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/__init__.py +0 -0
  27. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/decoders.py +0 -0
  28. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/events.py +0 -0
  29. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/packets.py +0 -0
  30. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/schemas.py +0 -0
  31. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/stream.py +0 -0
  32. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/specs.py +0 -0
  33. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/README.md +0 -0
  34. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/__init__.py +0 -0
  35. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/__main__.py +0 -0
  36. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/argument_maps.py +0 -0
  37. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/arguments.py +0 -0
  38. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/auth_context.py +0 -0
  39. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/banner.py +0 -0
  40. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/__init__.py +0 -0
  41. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/auth.py +0 -0
  42. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/exchange.py +0 -0
  43. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/groups.py +0 -0
  44. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/orders.py +0 -0
  45. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/stocks.py +0 -0
  46. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/doctor.py +0 -0
  47. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/errors.py +0 -0
  48. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/executor/__init__.py +0 -0
  49. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/executor/condition.py +0 -0
  50. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/executor/rest.py +0 -0
  51. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/executor/waits.py +0 -0
  52. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/executor/websocket.py +0 -0
  53. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/main.py +0 -0
  54. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/README.md +0 -0
  55. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/coupled_arguments.csv +0 -0
  56. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/order_confirmation_commands.csv +0 -0
  57. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/order_confirmation_fields.csv +0 -0
  58. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/order_price_policies.csv +0 -0
  59. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/order_value_labels.csv +0 -0
  60. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/positional_arguments.csv +0 -0
  61. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/order_confirmation.py +0 -0
  62. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/safety.py +0 -0
  63. {kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/setup.py +0 -0
{kwcli-1.0.2 → kwcli-1.0.3}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: kwcli
3
- Version: 1.0.2
3
+ Version: 1.0.3
4
4
  Summary: Kiwoom OpenAPI toolkit
5
5
  License-File: LICENSE.md
6
6
  Requires-Python: >=3.13
@@ -11,19 +11,13 @@ Requires-Dist: requests>=2.33.1
11
11
  Requires-Dist: websockets>=15.0.1
12
12
  Description-Content-Type: text/markdown
13
13
 
14
- # Kiwoom CLI
14
+ # 키움증권 CLI (Kiwoom CLI)
15
15
 
16
- `kiwoomcli`는 키움증권 OpenAPI를 위한 커맨드라인 클라이언트입니다. 터미널에서
17
- 키움 OpenAPI 데이터를 조회하고, 인증 상태를 관리하며, 안전장치가 적용된 주문
18
- 작업을 수행해야 하는 사람과 AI 에이전트를 위한 **탐색(discovery) 중심**의 운영
19
- 도구입니다.
16
+ `kiwoomcli`는 키움증권 OpenAPI를 위한 커맨드라인 클라이언트입니다. 터미널에서 키움 OpenAPI 데이터를 조회하고, 인증 상태를 관리하며, 안전장치가 적용된 주문 작업을 수행해야 하는 사람과 AI 에이전트를 위한 **탐색(discovery) 중심**의 운영 도구입니다.
20
17
 
21
18
  배포 패키지 이름은 `kwcli` 이며, 설치 후 사용하는 콘솔 명령은 `kiwoomcli` 입니다.
22
19
 
23
- > **키움증권 공식 프로젝트**
24
- > 본 프로젝트는 **키움증권(Kiwoom Securities)이 공식적으로 제공·관리**하는 도구입니다.
25
- > PyPI 패키지 [`kwcli`](https://pypi.org/project/kwcli/)는 키움증권이 게시한 공식 배포본입니다.
26
- > 키움 REST API 공식 포털: <https://openapi.kiwoom.com> (API 가이드: <https://openapi.kiwoom.com/guide/apiguide>)
20
+ > **키움증권 공식 프로젝트** 본 프로젝트는 **키움증권(Kiwoom Securities)이 공식적으로 제공·관리**하는 도구입니다. PyPI 패키지 [`kwcli`](https://pypi.org/project/kwcli/)는 키움증권이 게시한 공식 배포본입니다. 키움 REST API 공식 포털: <https://openapi.kiwoom.com> (API 가이드: <https://openapi.kiwoom.com/guide/apiguide>)
27
21
 
28
22
  ## 설치
29
23
 
@@ -43,9 +37,7 @@ kiwoomcli setup
43
37
 
44
38
  ## 빠른 시작
45
39
 
46
- 일상적인 흐름은 **먼저 탐색하고, 그다음 명령 하나를 실행**하는 것입니다. 어떤
47
- 명령이든 `-h`를 붙이면 실시간으로 매핑된 계약 정보(요약 / 동작 / 예시 / OpenAPI
48
- 매핑)를 볼 수 있습니다.
40
+ 일상적인 흐름은 **먼저 탐색하고, 그다음 명령 하나를 실행**하는 것입니다. 어떤 명령이든 `-h`를 붙이면 실시간으로 매핑된 계약 정보(요약 / 동작 / 예시 / OpenAPI 매핑)를 볼 수 있습니다.
49
41
 
50
42
  ```sh
51
43
  kiwoomcli setup # 온보딩: 별칭, demo/real, 키, 검증
@@ -60,19 +52,9 @@ kiwoomcli domestic orders buy --code 005930 --qty 1 --price 70000 --order-type l
60
52
 
61
53
  ## 인증과 프로필
62
54
 
63
- - `kiwoomcli setup`은 온보딩 초기화 명령입니다. 환경 사전 점검(OS 자격 증명
64
- 저장소 사용 가능 여부와 PATH 모호성 경고)을 수행하고, 계정 별칭을 만들며,
65
- `demo`/`real`을 선택하고, App Key / Secret을 저장한 뒤, 안전한 읽기 전용
66
- 호출로 검증하고, 현재 프로필을 지정한 다음 준비 상태 요약을 출력합니다.
67
- 비대화형 셸에서는 멈추지 않고 안내 메시지와 함께 실패합니다(`--mode` 전달).
68
- - `kiwoomcli doctor`는 읽기 전용 진단 명령입니다. 어떤 인증 컨텍스트가
69
- 선택됐는지(우선순위 `--profile`/`KIWOOM_PROFILE` > `--mode`/`KIWOOM_MODE` >
70
- 현재 프로필), 프로필별 자격 증명/토큰 상태, 권장 조치를 보여줍니다.
71
- - `--profile NAME`은 저장된 계정 별칭(OS 자격 증명 저장소의 App Key / Secret)을
72
- 사용합니다. `--mode demo|real`은 저장된 별칭을 쓰지 않으며, mode 단독 실행에는
73
- 환경변수가 필요합니다. 이때 환경변수 이름은 모드별로 다릅니다 —
74
- `real`은 `APP_KEY` / `APP_SECRET`, `demo`는 `APP_KEY_MOCK` / `APP_SECRET_MOCK`.
75
- 자격 증명이 없을 때는 진입 방식에 맞는 해결책을 함께 안내합니다.
55
+ - `kiwoomcli setup`은 온보딩 초기화 명령입니다. 환경을 먼저 점검(OS 자격 증명 저장소 사용 가능 여부, PATH 중복 경고)한 뒤, 계정 별칭 입력 → `demo`/`real` 선택 → App Key/Secret 저장 → 안전한 읽기 전용 호출로 검증 → 현재 프로필 지정 순서로 진행하고, 마지막에 준비 상태 요약을 보여줍니다. 비대화형 셸에서는 멈추지 않고 안내 메시지와 함께 실패합니다(`--mode` 전달).
56
+ - `kiwoomcli doctor`는 읽기 전용 진단 명령입니다. 어떤 인증 컨텍스트가 선택됐는지(우선순위 `--profile`/`KIWOOM_PROFILE` > `--mode`/`KIWOOM_MODE` > 현재 프로필), 프로필별 자격 증명/토큰 상태, 권장 조치를 보여줍니다.
57
+ - `--profile NAME`은 저장된 계정 별칭(OS 자격 증명 저장소의 App Key / Secret)을 사용합니다. `--mode demo|real`은 저장된 별칭을 쓰지 않으며, mode 단독 실행에는 환경변수가 필요합니다. 이때 환경변수 이름은 모드별로 다릅니다 — `real`은 `APP_KEY` / `APP_SECRET`, `demo`는 `APP_KEY_MOCK` / `APP_SECRET_MOCK`. 자격 증명이 없을 때는 진입 방식에 맞는 해결책을 함께 안내합니다.
76
58
 
77
59
  자주 쓰는 인증 명령:
78
60
 
@@ -88,13 +70,10 @@ kiwoomcli auth remove <alias>
88
70
  kiwoomcli auth export [--profile NAME | --mode demo|real] [--dir DIR] [--yes]
89
71
  ```
90
72
 
91
- - `auth clear`는 비밀 정보만 삭제합니다(기본은 토큰 캐시, `--all`을 주면 OS에
92
- 저장된 App Key / Secret까지). 별칭 등록 자체는 유지됩니다.
93
- - `auth remove <alias>`는 계정을 완전히 등록 해제합니다(프로필 항목, 토큰 캐시,
94
- 저장된 자격 증명 모두).
73
+ - `auth clear`는 비밀 정보만 삭제합니다(기본은 토큰 캐시, `--all`을 주면 OS에 저장된 App Key / Secret까지). 별칭 등록 자체는 유지됩니다.
74
+ - `auth remove <alias>`는 계정을 완전히 등록 해제합니다(프로필 항목, 토큰 캐시, 저장된 자격 증명 모두).
95
75
  - `auth revoke`는 서버에서 현재 토큰을 폐기하고 로컬 토큰 캐시도 삭제합니다.
96
- - `auth export`는 저장된 App Key/Secret을 화면에 출력하지 않고 `.env` 파일로
97
- 내보냅니다. 비대화형 환경에서는 `--yes`가 필요합니다.
76
+ - `auth export`는 저장된 App Key/Secret을 화면에 출력하지 않고 `.env` 파일로 내보냅니다. 비대화형 환경에서는 `--yes`가 필요합니다.
98
77
 
99
78
  ## 명령 그룹
100
79
 
@@ -107,8 +86,7 @@ kiwoomcli spec groups [--format pretty|json|yaml]
107
86
  kiwoomcli spec apis [--group <text>] [--limit N] [--format pretty|json|yaml]
108
87
  ```
109
88
 
110
- 국내 리소스 명령은 주제별 그룹으로 나뉩니다. 대표 예시는 아래와 같습니다(어떤
111
- 명령이든 `-h`를 붙이면 전체 옵션 계약을 볼 수 있습니다).
89
+ 국내 리소스 명령은 주제별 그룹으로 나뉩니다. 대표 예시는 아래와 같습니다(어떤 명령이든 `-h`를 붙이면 전체 옵션 계약을 볼 수 있습니다).
112
90
 
113
91
  | 그룹 | 예시 |
114
92
  | --- | --- |
@@ -144,13 +122,9 @@ kiwoomcli spec apis [--group <text>] [--limit N] [--format pretty|json|yaml]
144
122
  | `exchange` | `kiwoomcli overseas exchange rate --direction krw-to-usd` |
145
123
  | `streams` | `kiwoomcli overseas streams trades --exchange NASDAQ --code AAPL --count 1` |
146
124
 
147
- 전체 API 337개(OAuth 2, 국내주식 206, 미국주식 129)가 로컬 스펙과 CLI
148
- 맵에 포함됩니다. 정확한 옵션은 각 명령의 `-h` 출력으로 확인하세요.
125
+ 전체 API 337개(OAuth 2, 국내주식 206, 미국주식 129)가 로컬 스펙과 CLI 맵에 포함됩니다. 정확한 옵션은 각 명령의 `-h` 출력으로 확인하세요.
149
126
 
150
- 미국주식 `--exchange` 값의 대소문자는 명령별 API 계약을 따릅니다. 종목·시세·
151
- 호가·캔들·계좌·스트림은 `AMEX|NASDAQ|NYSE`, 순위는
152
- `all|nyse|nasdaq|amex`, 업종의 `period-returns`는
153
- `ALL|NYSE|AMEX|NASDAQ`을 사용합니다. 항상 해당 명령의 `-h`를 확인하세요.
127
+ 미국주식 `--exchange` 값의 대소문자는 명령별 API 계약을 따릅니다. 종목·시세· 호가·캔들·계좌·스트림은 `AMEX|NASDAQ|NYSE`, 순위는 `all|nyse|nasdaq|amex`, 업종의 `period-returns`는 `ALL|NYSE|AMEX|NASDAQ`을 사용합니다. 항상 해당 명령의 `-h`를 확인하세요.
154
128
 
155
129
  ## 출력 형식
156
130
 
@@ -167,34 +141,25 @@ kiwoomcli spec apis [--group <text>] [--limit N] [--format pretty|json|yaml]
167
141
  - `json`은 에이전트가 파싱하기 좋은 한 줄 압축 출력입니다.
168
142
  - `jsonl`은 한 줄에 JSON 레코드 하나씩 출력합니다(목록 행이나 스트림에 유용).
169
143
  - `yaml`은 YAML 형식으로 출력합니다.
170
- - `--pages`는 REST 연속조회 페이지 수입니다. 기본값은 1이며, 0은 서버가
171
- 제공하는 모든 페이지를 조회합니다. `spec` 명령에는 적용되지 않습니다.
144
+ - `--pages`는 REST 연속조회 페이지 수입니다. 기본값은 1이며, 0은 서버가 제공하는 모든 페이지를 조회합니다. `spec` 명령에는 적용되지 않습니다.
172
145
  - REST 명령의 `--named`는 응답 필드 코드를 스펙의 한글명으로 변환합니다.
173
146
 
174
- 안전장치가 적용된 계좌/주문 조회와 스트림에서는 출력 계층이 계좌 식별자를
175
- 마스킹합니다. 다만 주문번호(`ord_no`, `orig_ord_no` 등)는 `orders modify`/`cancel`
176
- 에 필요하므로 **마스킹하지 않습니다**. 마스킹은 `pretty`, `json`, `jsonl`, `yaml`
177
- 전반에서 동일하게 적용됩니다.
147
+ 안전장치가 적용된 계좌/주문 조회와 스트림에서는 출력 계층이 계좌 식별자를 마스킹합니다. 다만 주문번호(`ord_no`, `orig_ord_no` 등)는 `orders modify`/`cancel` 에 필요하므로 **마스킹하지 않습니다**. 마스킹은 `pretty`, `json`, `jsonl`, `yaml` 전반에서 동일하게 적용됩니다.
178
148
 
179
149
  ## 스트리밍 (WebSocket)
180
150
 
181
- 스트림 명령은 포그라운드에서 실행되며 키움 서버 메시지를 출력합니다. 유한한
182
- 실행을 원하면 `--count`/`--duration`을 사용하세요.
151
+ 스트림 명령은 포그라운드에서 실행되며 키움 서버 메시지를 출력합니다. 유한한 실행을 원하면 `--count`/`--duration`을 사용하세요.
183
152
 
184
153
  ```sh
185
154
  kiwoomcli domestic streams trades --code 005930 --count 1 --named --format json
186
155
  kiwoomcli overseas streams trades --exchange NASDAQ --code AAPL --count 1 --named --format json
187
156
  ```
188
157
 
189
- - `--count`는 `REAL` 데이터 메시지만 셉니다. `REG`/`REMOVE`/`SYSTEM`은 제어
190
- 메시지입니다.
191
- - `--check`는 유한한 등록/수집을 수행하며, `REAL` 틱이 오지 않아도 정상 종료
192
- 합니다.
193
- - 스트림 명령의 `--named`는 키움 스펙 기반 내장 스키마로 `REAL` 프레임 FID를
194
- 변환합니다. 알 수 없는 FID는 `unknown` 아래에 보존됩니다.
158
+ - `--count`는 `REAL` 데이터 메시지만 셉니다. `REG`/`REMOVE`/`SYSTEM`은 제어 메시지입니다.
159
+ - `--check`는 유한한 등록/수집을 수행하며, `REAL` 틱이 오지 않아도 정상 종료합니다.
160
+ - 스트림 명령의 `--named`는 키움 스펙 기반 내장 스키마로 `REAL` 프레임 FID를 변환합니다. 알 수 없는 FID는 `unknown` 아래에 보존됩니다.
195
161
 
196
- 장시간 구독을 저장하려면 파일로 출력하고 OS 도구로 프로세스를 백그라운드로
197
- 돌리세요(CLI는 자체 작업 관리자를 제공하지 않습니다).
162
+ 장시간 구독을 저장하려면 파일로 출력하고 OS 도구로 프로세스를 백그라운드로 돌리세요(CLI는 자체 작업 관리자를 제공하지 않습니다).
198
163
 
199
164
  ```sh
200
165
  # 계속 수신하며 이벤트를 파일에 추가 기록
@@ -207,30 +172,21 @@ nohup kiwoomcli domestic streams trades --codes 005930,000660 --watch --output t
207
172
  Start-Process kiwoomcli -ArgumentList 'domestic streams trades --codes 005930,000660 --watch --output trades.jsonl'
208
173
  ```
209
174
 
210
- 조건검색식의 생성과 수정은 키움 영웅문 HTS에서 합니다. CLI는 HTS에 이미 저장된
211
- 조건식을 목록 조회, 선택, 조회, 구독, 해제만 합니다.
175
+ 조건검색식의 생성과 수정은 키움 영웅문 HTS에서 합니다. CLI는 HTS에 이미 저장된 조건식을 목록 조회, 선택, 조회, 구독, 해제만 합니다.
212
176
 
213
177
  ## 주문 안전장치
214
178
 
215
- 국내·미국주식 주문 쓰기 명령(`orders buy/sell/modify/cancel`,
216
- `credit-*`, `gold-*`)과 미국주식 환전 신청(`overseas exchange request`)에는
217
- 안전장치가 적용됩니다.
179
+ 국내·미국주식 주문 쓰기 명령(`orders buy/sell/modify/cancel`, `credit-*`, `gold-*`)과 미국주식 환전 신청(`overseas exchange request`)에는 안전장치가 적용됩니다.
218
180
 
219
- - `--confirm`이 없으면 짧은 미전송 주문 요약을 출력하고 주문 API를 호출하지
220
- 않습니다.
181
+ - `--confirm`이 없으면 짧은 미전송 주문 요약을 출력하고 주문 API를 호출하지 않습니다.
221
182
  - `--confirm`이 있으면 실제 엔드포인트로 전송합니다.
222
- - `overseas exchange request`도 `--confirm`이 없으면 미전송 환전 확인만
223
- 출력하며, `--confirm`이 있어야 실제 환전 API를 호출합니다.
224
- - 주문 유형별 가격 규칙은 전송 경로 이전에 검증됩니다. 예를 들어
225
- `--order-type limit`에는 `--price`가 필요하고, `--order-type market`에는
226
- `--price`를 넣으면 안 됩니다. 잘못된 주문 식별자는 전송 전에 보고됩니다.
227
- - 주문 쓰기는 `--profile`/`--mode`로 인증 대상을 선택합니다. 먼저 데모(모의투자)
228
- 서버에서 검증하세요.
183
+ - `overseas exchange request`도 `--confirm`이 없으면 미전송 환전 확인만 출력하며, `--confirm`이 있어야 실제 환전 API를 호출합니다.
184
+ - 주문 유형별 가격 규칙은 전송 경로 이전에 검증됩니다. 예를 들어 `--order-type limit`에는 `--price`가 필요하고, `--order-type market`에는 `--price`를 넣으면 안 됩니다. 잘못된 주문 식별자는 전송 전에 보고됩니다.
185
+ - 주문 쓰기는 `--profile`/`--mode`로 인증 대상을 선택합니다. 먼저 데모(모의투자) 서버에서 검증하세요.
229
186
 
230
187
  ## 용어
231
188
 
232
- 안정적인 사용자 대상 옵션 이름이 키움 원본 필드명을 숨깁니다. 구체적인 코드
233
- 종류는 명령 맥락에 따라 결정됩니다.
189
+ 각 옵션 이름은 키움 원본 필드명 대신 안정적인 사용자 대상 이름으로 노출됩니다. 구체적으로 어떤 코드를 넣어야 하는지는 명령마다 다릅니다.
234
190
 
235
191
  | 개념 | 옵션 | 예시 |
236
192
  | --- | --- | --- |
@@ -253,7 +209,16 @@ Start-Process kiwoomcli -ArgumentList 'domestic streams trades --codes 005930,00
253
209
  ## 안전 유의사항
254
210
 
255
211
  - 개발과 검증 단계에서는 `demo` 모드를 우선 사용하세요.
256
- - 자격 증명, 토큰, 계좌번호, 정제되지 않은 실제 호출 출력은 절대 로그로 남기거나
257
- 커밋하지 마세요.
258
- - 자격 증명·네트워크·계좌 안전 제약으로 실제 호출이 막히면, CLI는 결과를
259
- 지어내지 않고 차단됨/미실행으로 보고합니다.
212
+ - 자격 증명, 토큰, 계좌번호, 정제되지 않은 실제 호출 출력은 절대 로그로 남기거나 커밋하지 마세요.
213
+ - 자격 증명·네트워크·계좌 안전 제약으로 실제 호출이 막히면, CLI는 결과를 지어내지 않고 차단됨/미실행으로 보고합니다.
214
+
215
+ ## 알려진 제약
216
+
217
+ - 국내 주문 취소(`domestic orders cancel`)는 `--qty`로 수량 일부만 취소할 수 있지만, 해외 주문 취소(`overseas orders cancel`)는 **전량만** 가능합니다. 해외 주문 정정(`overseas orders modify`)은 수량은 바꿀 수 없고 **가격만** 바꿀 수 있습니다(원주문이 STOP 주문이면 `--stop-price` 필수).
218
+ - `domestic orders list-open`의 `--exchange`는 주문용 값인 `SOR`을 받지 않습니다 — `ALL`로 조회하세요. `overseas accounts open-orders`는 `--exchange`를 `--code` 없이 받지 않습니다(서버 제약) — 종목을 지정하지 않는 미체결 조회는 거래소 없이 전체로 조회하세요.
219
+ - 너무 짧은 간격으로 연속 조회하면 유량 제한(429) 오류가 날 수 있습니다. 반복 호출에는 간격을 두세요.
220
+ - 모의투자(demo) 계좌에서는 환율 조회, 주문가능금액 조회가 거절됩니다(실전 계좌에서만 가능).
221
+ - 계좌마다 거래할 수 있는 시장이 다를 수 있습니다. 해당 계좌가 다루지 않는 시장은 주문이 거절되거나 조회 결과가 오류 없이 빈 목록으로 돌아올 수 있으므로, 결과가 비어 있다면 먼저 `--profile`/`--mode`로 선택한 계좌를 확인하세요. 장 운영 시간이 아닐 때 국내 주문을 시도하면 이와는 다른 이유(장 종료)로 거절됩니다.
222
+ - 현재가 조회(`domestic quotes price`) 응답에는 전일대비 값이 직접 포함되어 있지 않습니다 — 현재가와 전일 종가의 차이로 직접 계산해야 합니다.
223
+ - `auth list`/`auth status`는 `--format json`을 지원하지 않고 사람이 읽는 텍스트만 출력합니다.
224
+ - 일부 계좌 조회 명령(`accounts valuation`/`accounts holdings`)에는 `--named`가 없어, 응답 필드가 키움 원본 코드로 나옵니다.
{kwcli-1.0.2 → kwcli-1.0.3}/README.md RENAMED
@@ -1,16 +1,10 @@
1
- # Kiwoom CLI
1
+ # 키움증권 CLI (Kiwoom CLI)
2
2
 
3
- `kiwoomcli`는 키움증권 OpenAPI를 위한 커맨드라인 클라이언트입니다. 터미널에서
4
- 키움 OpenAPI 데이터를 조회하고, 인증 상태를 관리하며, 안전장치가 적용된 주문
5
- 작업을 수행해야 하는 사람과 AI 에이전트를 위한 **탐색(discovery) 중심**의 운영
6
- 도구입니다.
3
+ `kiwoomcli`는 키움증권 OpenAPI를 위한 커맨드라인 클라이언트입니다. 터미널에서 키움 OpenAPI 데이터를 조회하고, 인증 상태를 관리하며, 안전장치가 적용된 주문 작업을 수행해야 하는 사람과 AI 에이전트를 위한 **탐색(discovery) 중심**의 운영 도구입니다.
7
4
 
8
5
  배포 패키지 이름은 `kwcli` 이며, 설치 후 사용하는 콘솔 명령은 `kiwoomcli` 입니다.
9
6
 
10
- > **키움증권 공식 프로젝트**
11
- > 본 프로젝트는 **키움증권(Kiwoom Securities)이 공식적으로 제공·관리**하는 도구입니다.
12
- > PyPI 패키지 [`kwcli`](https://pypi.org/project/kwcli/)는 키움증권이 게시한 공식 배포본입니다.
13
- > 키움 REST API 공식 포털: <https://openapi.kiwoom.com> (API 가이드: <https://openapi.kiwoom.com/guide/apiguide>)
7
+ > **키움증권 공식 프로젝트** 본 프로젝트는 **키움증권(Kiwoom Securities)이 공식적으로 제공·관리**하는 도구입니다. PyPI 패키지 [`kwcli`](https://pypi.org/project/kwcli/)는 키움증권이 게시한 공식 배포본입니다. 키움 REST API 공식 포털: <https://openapi.kiwoom.com> (API 가이드: <https://openapi.kiwoom.com/guide/apiguide>)
14
8
 
15
9
  ## 설치
16
10
 
@@ -30,9 +24,7 @@ kiwoomcli setup
30
24
 
31
25
  ## 빠른 시작
32
26
 
33
- 일상적인 흐름은 **먼저 탐색하고, 그다음 명령 하나를 실행**하는 것입니다. 어떤
34
- 명령이든 `-h`를 붙이면 실시간으로 매핑된 계약 정보(요약 / 동작 / 예시 / OpenAPI
35
- 매핑)를 볼 수 있습니다.
27
+ 일상적인 흐름은 **먼저 탐색하고, 그다음 명령 하나를 실행**하는 것입니다. 어떤 명령이든 `-h`를 붙이면 실시간으로 매핑된 계약 정보(요약 / 동작 / 예시 / OpenAPI 매핑)를 볼 수 있습니다.
36
28
 
37
29
  ```sh
38
30
  kiwoomcli setup # 온보딩: 별칭, demo/real, 키, 검증
@@ -47,19 +39,9 @@ kiwoomcli domestic orders buy --code 005930 --qty 1 --price 70000 --order-type l
47
39
 
48
40
  ## 인증과 프로필
49
41
 
50
- - `kiwoomcli setup`은 온보딩 초기화 명령입니다. 환경 사전 점검(OS 자격 증명
51
- 저장소 사용 가능 여부와 PATH 모호성 경고)을 수행하고, 계정 별칭을 만들며,
52
- `demo`/`real`을 선택하고, App Key / Secret을 저장한 뒤, 안전한 읽기 전용
53
- 호출로 검증하고, 현재 프로필을 지정한 다음 준비 상태 요약을 출력합니다.
54
- 비대화형 셸에서는 멈추지 않고 안내 메시지와 함께 실패합니다(`--mode` 전달).
55
- - `kiwoomcli doctor`는 읽기 전용 진단 명령입니다. 어떤 인증 컨텍스트가
56
- 선택됐는지(우선순위 `--profile`/`KIWOOM_PROFILE` > `--mode`/`KIWOOM_MODE` >
57
- 현재 프로필), 프로필별 자격 증명/토큰 상태, 권장 조치를 보여줍니다.
58
- - `--profile NAME`은 저장된 계정 별칭(OS 자격 증명 저장소의 App Key / Secret)을
59
- 사용합니다. `--mode demo|real`은 저장된 별칭을 쓰지 않으며, mode 단독 실행에는
60
- 환경변수가 필요합니다. 이때 환경변수 이름은 모드별로 다릅니다 —
61
- `real`은 `APP_KEY` / `APP_SECRET`, `demo`는 `APP_KEY_MOCK` / `APP_SECRET_MOCK`.
62
- 자격 증명이 없을 때는 진입 방식에 맞는 해결책을 함께 안내합니다.
42
+ - `kiwoomcli setup`은 온보딩 초기화 명령입니다. 환경을 먼저 점검(OS 자격 증명 저장소 사용 가능 여부, PATH 중복 경고)한 뒤, 계정 별칭 입력 → `demo`/`real` 선택 → App Key/Secret 저장 → 안전한 읽기 전용 호출로 검증 → 현재 프로필 지정 순서로 진행하고, 마지막에 준비 상태 요약을 보여줍니다. 비대화형 셸에서는 멈추지 않고 안내 메시지와 함께 실패합니다(`--mode` 전달).
43
+ - `kiwoomcli doctor`는 읽기 전용 진단 명령입니다. 어떤 인증 컨텍스트가 선택됐는지(우선순위 `--profile`/`KIWOOM_PROFILE` > `--mode`/`KIWOOM_MODE` > 현재 프로필), 프로필별 자격 증명/토큰 상태, 권장 조치를 보여줍니다.
44
+ - `--profile NAME`은 저장된 계정 별칭(OS 자격 증명 저장소의 App Key / Secret)을 사용합니다. `--mode demo|real`은 저장된 별칭을 쓰지 않으며, mode 단독 실행에는 환경변수가 필요합니다. 이때 환경변수 이름은 모드별로 다릅니다 — `real`은 `APP_KEY` / `APP_SECRET`, `demo`는 `APP_KEY_MOCK` / `APP_SECRET_MOCK`. 자격 증명이 없을 때는 진입 방식에 맞는 해결책을 함께 안내합니다.
63
45
 
64
46
  자주 쓰는 인증 명령:
65
47
 
@@ -75,13 +57,10 @@ kiwoomcli auth remove <alias>
75
57
  kiwoomcli auth export [--profile NAME | --mode demo|real] [--dir DIR] [--yes]
76
58
  ```
77
59
 
78
- - `auth clear`는 비밀 정보만 삭제합니다(기본은 토큰 캐시, `--all`을 주면 OS에
79
- 저장된 App Key / Secret까지). 별칭 등록 자체는 유지됩니다.
80
- - `auth remove <alias>`는 계정을 완전히 등록 해제합니다(프로필 항목, 토큰 캐시,
81
- 저장된 자격 증명 모두).
60
+ - `auth clear`는 비밀 정보만 삭제합니다(기본은 토큰 캐시, `--all`을 주면 OS에 저장된 App Key / Secret까지). 별칭 등록 자체는 유지됩니다.
61
+ - `auth remove <alias>`는 계정을 완전히 등록 해제합니다(프로필 항목, 토큰 캐시, 저장된 자격 증명 모두).
82
62
  - `auth revoke`는 서버에서 현재 토큰을 폐기하고 로컬 토큰 캐시도 삭제합니다.
83
- - `auth export`는 저장된 App Key/Secret을 화면에 출력하지 않고 `.env` 파일로
84
- 내보냅니다. 비대화형 환경에서는 `--yes`가 필요합니다.
63
+ - `auth export`는 저장된 App Key/Secret을 화면에 출력하지 않고 `.env` 파일로 내보냅니다. 비대화형 환경에서는 `--yes`가 필요합니다.
85
64
 
86
65
  ## 명령 그룹
87
66
 
@@ -94,8 +73,7 @@ kiwoomcli spec groups [--format pretty|json|yaml]
94
73
  kiwoomcli spec apis [--group <text>] [--limit N] [--format pretty|json|yaml]
95
74
  ```
96
75
 
97
- 국내 리소스 명령은 주제별 그룹으로 나뉩니다. 대표 예시는 아래와 같습니다(어떤
98
- 명령이든 `-h`를 붙이면 전체 옵션 계약을 볼 수 있습니다).
76
+ 국내 리소스 명령은 주제별 그룹으로 나뉩니다. 대표 예시는 아래와 같습니다(어떤 명령이든 `-h`를 붙이면 전체 옵션 계약을 볼 수 있습니다).
99
77
 
100
78
  | 그룹 | 예시 |
101
79
  | --- | --- |
@@ -131,13 +109,9 @@ kiwoomcli spec apis [--group <text>] [--limit N] [--format pretty|json|yaml]
131
109
  | `exchange` | `kiwoomcli overseas exchange rate --direction krw-to-usd` |
132
110
  | `streams` | `kiwoomcli overseas streams trades --exchange NASDAQ --code AAPL --count 1` |
133
111
 
134
- 전체 API 337개(OAuth 2, 국내주식 206, 미국주식 129)가 로컬 스펙과 CLI
135
- 맵에 포함됩니다. 정확한 옵션은 각 명령의 `-h` 출력으로 확인하세요.
112
+ 전체 API 337개(OAuth 2, 국내주식 206, 미국주식 129)가 로컬 스펙과 CLI 맵에 포함됩니다. 정확한 옵션은 각 명령의 `-h` 출력으로 확인하세요.
136
113
 
137
- 미국주식 `--exchange` 값의 대소문자는 명령별 API 계약을 따릅니다. 종목·시세·
138
- 호가·캔들·계좌·스트림은 `AMEX|NASDAQ|NYSE`, 순위는
139
- `all|nyse|nasdaq|amex`, 업종의 `period-returns`는
140
- `ALL|NYSE|AMEX|NASDAQ`을 사용합니다. 항상 해당 명령의 `-h`를 확인하세요.
114
+ 미국주식 `--exchange` 값의 대소문자는 명령별 API 계약을 따릅니다. 종목·시세· 호가·캔들·계좌·스트림은 `AMEX|NASDAQ|NYSE`, 순위는 `all|nyse|nasdaq|amex`, 업종의 `period-returns`는 `ALL|NYSE|AMEX|NASDAQ`을 사용합니다. 항상 해당 명령의 `-h`를 확인하세요.
141
115
 
142
116
  ## 출력 형식
143
117
 
@@ -154,34 +128,25 @@ kiwoomcli spec apis [--group <text>] [--limit N] [--format pretty|json|yaml]
154
128
  - `json`은 에이전트가 파싱하기 좋은 한 줄 압축 출력입니다.
155
129
  - `jsonl`은 한 줄에 JSON 레코드 하나씩 출력합니다(목록 행이나 스트림에 유용).
156
130
  - `yaml`은 YAML 형식으로 출력합니다.
157
- - `--pages`는 REST 연속조회 페이지 수입니다. 기본값은 1이며, 0은 서버가
158
- 제공하는 모든 페이지를 조회합니다. `spec` 명령에는 적용되지 않습니다.
131
+ - `--pages`는 REST 연속조회 페이지 수입니다. 기본값은 1이며, 0은 서버가 제공하는 모든 페이지를 조회합니다. `spec` 명령에는 적용되지 않습니다.
159
132
  - REST 명령의 `--named`는 응답 필드 코드를 스펙의 한글명으로 변환합니다.
160
133
 
161
- 안전장치가 적용된 계좌/주문 조회와 스트림에서는 출력 계층이 계좌 식별자를
162
- 마스킹합니다. 다만 주문번호(`ord_no`, `orig_ord_no` 등)는 `orders modify`/`cancel`
163
- 에 필요하므로 **마스킹하지 않습니다**. 마스킹은 `pretty`, `json`, `jsonl`, `yaml`
164
- 전반에서 동일하게 적용됩니다.
134
+ 안전장치가 적용된 계좌/주문 조회와 스트림에서는 출력 계층이 계좌 식별자를 마스킹합니다. 다만 주문번호(`ord_no`, `orig_ord_no` 등)는 `orders modify`/`cancel` 에 필요하므로 **마스킹하지 않습니다**. 마스킹은 `pretty`, `json`, `jsonl`, `yaml` 전반에서 동일하게 적용됩니다.
165
135
 
166
136
  ## 스트리밍 (WebSocket)
167
137
 
168
- 스트림 명령은 포그라운드에서 실행되며 키움 서버 메시지를 출력합니다. 유한한
169
- 실행을 원하면 `--count`/`--duration`을 사용하세요.
138
+ 스트림 명령은 포그라운드에서 실행되며 키움 서버 메시지를 출력합니다. 유한한 실행을 원하면 `--count`/`--duration`을 사용하세요.
170
139
 
171
140
  ```sh
172
141
  kiwoomcli domestic streams trades --code 005930 --count 1 --named --format json
173
142
  kiwoomcli overseas streams trades --exchange NASDAQ --code AAPL --count 1 --named --format json
174
143
  ```
175
144
 
176
- - `--count`는 `REAL` 데이터 메시지만 셉니다. `REG`/`REMOVE`/`SYSTEM`은 제어
177
- 메시지입니다.
178
- - `--check`는 유한한 등록/수집을 수행하며, `REAL` 틱이 오지 않아도 정상 종료
179
- 합니다.
180
- - 스트림 명령의 `--named`는 키움 스펙 기반 내장 스키마로 `REAL` 프레임 FID를
181
- 변환합니다. 알 수 없는 FID는 `unknown` 아래에 보존됩니다.
145
+ - `--count`는 `REAL` 데이터 메시지만 셉니다. `REG`/`REMOVE`/`SYSTEM`은 제어 메시지입니다.
146
+ - `--check`는 유한한 등록/수집을 수행하며, `REAL` 틱이 오지 않아도 정상 종료합니다.
147
+ - 스트림 명령의 `--named`는 키움 스펙 기반 내장 스키마로 `REAL` 프레임 FID를 변환합니다. 알 수 없는 FID는 `unknown` 아래에 보존됩니다.
182
148
 
183
- 장시간 구독을 저장하려면 파일로 출력하고 OS 도구로 프로세스를 백그라운드로
184
- 돌리세요(CLI는 자체 작업 관리자를 제공하지 않습니다).
149
+ 장시간 구독을 저장하려면 파일로 출력하고 OS 도구로 프로세스를 백그라운드로 돌리세요(CLI는 자체 작업 관리자를 제공하지 않습니다).
185
150
 
186
151
  ```sh
187
152
  # 계속 수신하며 이벤트를 파일에 추가 기록
@@ -194,30 +159,21 @@ nohup kiwoomcli domestic streams trades --codes 005930,000660 --watch --output t
194
159
  Start-Process kiwoomcli -ArgumentList 'domestic streams trades --codes 005930,000660 --watch --output trades.jsonl'
195
160
  ```
196
161
 
197
- 조건검색식의 생성과 수정은 키움 영웅문 HTS에서 합니다. CLI는 HTS에 이미 저장된
198
- 조건식을 목록 조회, 선택, 조회, 구독, 해제만 합니다.
162
+ 조건검색식의 생성과 수정은 키움 영웅문 HTS에서 합니다. CLI는 HTS에 이미 저장된 조건식을 목록 조회, 선택, 조회, 구독, 해제만 합니다.
199
163
 
200
164
  ## 주문 안전장치
201
165
 
202
- 국내·미국주식 주문 쓰기 명령(`orders buy/sell/modify/cancel`,
203
- `credit-*`, `gold-*`)과 미국주식 환전 신청(`overseas exchange request`)에는
204
- 안전장치가 적용됩니다.
166
+ 국내·미국주식 주문 쓰기 명령(`orders buy/sell/modify/cancel`, `credit-*`, `gold-*`)과 미국주식 환전 신청(`overseas exchange request`)에는 안전장치가 적용됩니다.
205
167
 
206
- - `--confirm`이 없으면 짧은 미전송 주문 요약을 출력하고 주문 API를 호출하지
207
- 않습니다.
168
+ - `--confirm`이 없으면 짧은 미전송 주문 요약을 출력하고 주문 API를 호출하지 않습니다.
208
169
  - `--confirm`이 있으면 실제 엔드포인트로 전송합니다.
209
- - `overseas exchange request`도 `--confirm`이 없으면 미전송 환전 확인만
210
- 출력하며, `--confirm`이 있어야 실제 환전 API를 호출합니다.
211
- - 주문 유형별 가격 규칙은 전송 경로 이전에 검증됩니다. 예를 들어
212
- `--order-type limit`에는 `--price`가 필요하고, `--order-type market`에는
213
- `--price`를 넣으면 안 됩니다. 잘못된 주문 식별자는 전송 전에 보고됩니다.
214
- - 주문 쓰기는 `--profile`/`--mode`로 인증 대상을 선택합니다. 먼저 데모(모의투자)
215
- 서버에서 검증하세요.
170
+ - `overseas exchange request`도 `--confirm`이 없으면 미전송 환전 확인만 출력하며, `--confirm`이 있어야 실제 환전 API를 호출합니다.
171
+ - 주문 유형별 가격 규칙은 전송 경로 이전에 검증됩니다. 예를 들어 `--order-type limit`에는 `--price`가 필요하고, `--order-type market`에는 `--price`를 넣으면 안 됩니다. 잘못된 주문 식별자는 전송 전에 보고됩니다.
172
+ - 주문 쓰기는 `--profile`/`--mode`로 인증 대상을 선택합니다. 먼저 데모(모의투자) 서버에서 검증하세요.
216
173
 
217
174
  ## 용어
218
175
 
219
- 안정적인 사용자 대상 옵션 이름이 키움 원본 필드명을 숨깁니다. 구체적인 코드
220
- 종류는 명령 맥락에 따라 결정됩니다.
176
+ 각 옵션 이름은 키움 원본 필드명 대신 안정적인 사용자 대상 이름으로 노출됩니다. 구체적으로 어떤 코드를 넣어야 하는지는 명령마다 다릅니다.
221
177
 
222
178
  | 개념 | 옵션 | 예시 |
223
179
  | --- | --- | --- |
@@ -240,7 +196,16 @@ Start-Process kiwoomcli -ArgumentList 'domestic streams trades --codes 005930,00
240
196
  ## 안전 유의사항
241
197
 
242
198
  - 개발과 검증 단계에서는 `demo` 모드를 우선 사용하세요.
243
- - 자격 증명, 토큰, 계좌번호, 정제되지 않은 실제 호출 출력은 절대 로그로 남기거나
244
- 커밋하지 마세요.
245
- - 자격 증명·네트워크·계좌 안전 제약으로 실제 호출이 막히면, CLI는 결과를
246
- 지어내지 않고 차단됨/미실행으로 보고합니다.
199
+ - 자격 증명, 토큰, 계좌번호, 정제되지 않은 실제 호출 출력은 절대 로그로 남기거나 커밋하지 마세요.
200
+ - 자격 증명·네트워크·계좌 안전 제약으로 실제 호출이 막히면, CLI는 결과를 지어내지 않고 차단됨/미실행으로 보고합니다.
201
+
202
+ ## 알려진 제약
203
+
204
+ - 국내 주문 취소(`domestic orders cancel`)는 `--qty`로 수량 일부만 취소할 수 있지만, 해외 주문 취소(`overseas orders cancel`)는 **전량만** 가능합니다. 해외 주문 정정(`overseas orders modify`)은 수량은 바꿀 수 없고 **가격만** 바꿀 수 있습니다(원주문이 STOP 주문이면 `--stop-price` 필수).
205
+ - `domestic orders list-open`의 `--exchange`는 주문용 값인 `SOR`을 받지 않습니다 — `ALL`로 조회하세요. `overseas accounts open-orders`는 `--exchange`를 `--code` 없이 받지 않습니다(서버 제약) — 종목을 지정하지 않는 미체결 조회는 거래소 없이 전체로 조회하세요.
206
+ - 너무 짧은 간격으로 연속 조회하면 유량 제한(429) 오류가 날 수 있습니다. 반복 호출에는 간격을 두세요.
207
+ - 모의투자(demo) 계좌에서는 환율 조회, 주문가능금액 조회가 거절됩니다(실전 계좌에서만 가능).
208
+ - 계좌마다 거래할 수 있는 시장이 다를 수 있습니다. 해당 계좌가 다루지 않는 시장은 주문이 거절되거나 조회 결과가 오류 없이 빈 목록으로 돌아올 수 있으므로, 결과가 비어 있다면 먼저 `--profile`/`--mode`로 선택한 계좌를 확인하세요. 장 운영 시간이 아닐 때 국내 주문을 시도하면 이와는 다른 이유(장 종료)로 거절됩니다.
209
+ - 현재가 조회(`domestic quotes price`) 응답에는 전일대비 값이 직접 포함되어 있지 않습니다 — 현재가와 전일 종가의 차이로 직접 계산해야 합니다.
210
+ - `auth list`/`auth status`는 `--format json`을 지원하지 않고 사람이 읽는 텍스트만 출력합니다.
211
+ - 일부 계좌 조회 명령(`accounts valuation`/`accounts holdings`)에는 `--named`가 없어, 응답 필드가 키움 원본 코드로 나옵니다.
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/mapped.py RENAMED
@@ -16,6 +16,19 @@ from kiwoom_cli.registry import CommandDefinition, get_implemented_command
16
16
 
17
17
  CommandHelp = tuple[str, str]
18
18
 
19
+ RESPONSE_NOTE_MARKER = "응답 주의:"
20
+
21
+
22
+ def response_note(notes: str) -> str | None:
23
+ """maps의 notes 컬럼에서 사용자 노출용 '응답 주의' 문구만 추출한다.
24
+
25
+ 마커 앞부분은 내부 구현 메모이므로 버린다. 마커가 없으면 None.
26
+ """
27
+ _, found, tail = notes.partition(RESPONSE_NOTE_MARKER)
28
+ if not found or not tail.strip():
29
+ return None
30
+ return f"{RESPONSE_NOTE_MARKER} {tail.strip()}"
31
+
19
32
 
20
33
  def add_mapped_command_parser(
21
34
  subparsers: argparse._SubParsersAction,
@@ -27,7 +40,10 @@ def add_mapped_command_parser(
27
40
  parser_kwargs: dict[str, Any] | None = None,
28
41
  ) -> argparse.ArgumentParser:
29
42
  definition = get_implemented_command(group, command)
30
- kwargs = {"help": help_text}
43
+ kwargs: dict[str, Any] = {"help": help_text}
44
+ note = response_note(definition.notes)
45
+ if note:
46
+ kwargs["epilog"] = note
31
47
  if parser_kwargs:
32
48
  kwargs.update(parser_kwargs)
33
49
  command_parser = subparsers.add_parser(command, **kwargs)
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/spec.py RENAMED
@@ -14,7 +14,9 @@ from kiwoom.specs import (
14
14
  list_api_summaries,
15
15
  search_api_specs,
16
16
  )
17
+ from kiwoom_cli.commands.mapped import response_note
17
18
  from kiwoom_cli.output import format_payload
19
+ from kiwoom_cli.registry import load_command_definitions
18
20
 
19
21
 
20
22
  def add_spec_parser(subparsers: argparse._SubParsersAction) -> None:
@@ -56,14 +58,40 @@ def handle_spec_search(args: argparse.Namespace) -> None:
56
58
 
57
59
 
58
60
  def handle_spec_show(args: argparse.Namespace) -> None:
59
- api_payload = get_api_spec(args.api_id)
61
+ # 스펙 원문 뒤에 CLI 매핑과 '응답 주의'(실측으로 확정한 단위·서식 정정)를 덧붙인다.
62
+ # 스펙 문구와 어긋나면 응답 주의가 맞다 — -h epilog 와 같은 소스(maps notes)다.
63
+ api_payload = {**get_api_spec(args.api_id), "cli": cli_annotation(args.api_id)}
60
64
  print(
61
65
  _format_spec_payload(
62
- api_payload, output_format=args.format, pretty_formatter=format_api_spec
66
+ api_payload, output_format=args.format, pretty_formatter=_format_spec_with_cli
63
67
  )
64
68
  )
65
69
 
66
70
 
71
+ def cli_annotation(api_id: str) -> dict | None:
72
+ """api_id 에 대응하는 CLI 명령과 응답 주의 문구. 매핑이 없으면 None."""
73
+ matches = [d for d in load_command_definitions() if d.api_id == api_id]
74
+ if not matches:
75
+ return None
76
+ definition = next((d for d in matches if d.status == "implemented"), matches[0])
77
+ return {
78
+ "command_path": definition.command_path,
79
+ "status": definition.status,
80
+ "response_note": response_note(definition.notes),
81
+ }
82
+
83
+
84
+ def _format_spec_with_cli(payload: dict) -> str:
85
+ text = format_api_spec(payload)
86
+ cli = payload.get("cli")
87
+ if not cli:
88
+ return text
89
+ lines = [text, f" CLI: {cli['command_path']} ({cli['status']})"]
90
+ if cli.get("response_note"):
91
+ lines.append(f" {cli['response_note']}")
92
+ return "\n".join(lines)
93
+
94
+
67
95
  def handle_spec_groups(args: argparse.Namespace) -> None:
68
96
  groups = list_api_groups()
69
97
  print(
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/streams.py RENAMED
@@ -8,6 +8,7 @@ from pathlib import Path
8
8
  from typing import Any
9
9
 
10
10
  from kiwoom.realtime import decode_realtime_message_named
11
+ from kiwoom_cli.commands.mapped import response_note
11
12
  from kiwoom_cli.argument_maps import (
12
13
  TYPE_PARSERS,
13
14
  add_mapped_arguments,
@@ -43,6 +44,7 @@ STREAM_REDACT_FIELDS = (
43
44
  "acctNo",
44
45
  "acnt_no",
45
46
  "acntNo",
47
+ "9201", # 실시간 계좌번호 FID (00/04/F4/F5)
46
48
  )
47
49
 
48
50
  OVERSEAS_STREAMS_PREFIX = "kiwoomcli overseas streams "
@@ -127,6 +129,10 @@ def add_streams_parser(
127
129
  "epilog": CONDITION_HTS_NOTE,
128
130
  }
129
131
  )
132
+ note = response_note(definition.notes)
133
+ if note:
134
+ existing = parser_kwargs.get("epilog")
135
+ parser_kwargs["epilog"] = f"{existing} {note}" if existing else note
130
136
  command_parser = streams_subparsers.add_parser(command, **parser_kwargs)
131
137
  code_action_overrides = (
132
138
  {"code": "append"}
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/api_commands.csv RENAMED
@@ -9,10 +9,10 @@ ka01690,일별잔고수익률,get_domestic_daily_balance_return_rate,국내주
9
9
  ka10001,주식기본정보요청,get_domestic_stock_info,국내주식,종목정보,stocks,info,kiwoomcli domestic stocks info,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,First implemented public read command; --code maps to stk_cd.
10
10
  ka10002,주식거래원요청,get_domestic_stock_brokers,국내주식,종목정보,stocks,brokers,kiwoomcli domestic stocks brokers,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
11
11
  ka10003,체결정보요청,get_domestic_stock_execution_info,국내주식,종목정보,stocks,fills,kiwoomcli domestic stocks fills,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
12
- ka10004,주식호가요청,get_domestic_stock_quote,국내주식,시세,orderbooks,list,kiwoomcli domestic orderbooks list,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public read command; --code maps to stk_cd.
12
+ ka10004,주식호가요청,get_domestic_stock_quote,국내주식,시세,orderbooks,list,kiwoomcli domestic orderbooks list,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public read command; --code maps to stk_cd. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
13
13
  ka10005,주식일주월시분요청,get_domestic_stock_ohlcv_by_period,국내주식,시세,quotes,multi-period,kiwoomcli domestic quotes multi-period,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
14
14
  ka10006,주식시분요청,get_domestic_stock_intraday_minute_data,국내주식,시세,quotes,intraday-minute,kiwoomcli domestic quotes intraday-minute,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
15
- ka10007,시세표성정보요청,get_domestic_stock_market_condition_info,국내주식,시세,quotes,price,kiwoomcli domestic quotes price,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public read command; --code maps to stk_cd and response includes cur_prc.
15
+ ka10007,시세표성정보요청,get_domestic_stock_market_condition_info,국내주식,시세,quotes,price,kiwoomcli domestic quotes price,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public read command; --code maps to stk_cd and response includes cur_prc. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
16
16
  ka10008,주식외국인종목별매매동향,get_domestic_stock_foreign_investor_trade_trend,국내주식,기관/외국인,investors,by-stock,kiwoomcli domestic investors by-stock,implemented,public,read,POST,/api/dostk/frgnistt,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
17
17
  ka10010,업종프로그램요청,get_domestic_sector_program,국내주식,업종,sectors,program,kiwoomcli domestic sectors program,implemented,public,read,POST,/api/dostk/sect,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
18
18
  ka10011,신주인수권전체시세요청,get_domestic_subscription_rights_all_quotes,국내주식,시세,quotes,list,kiwoomcli domestic quotes list,implemented,public,read,POST,/api/dostk/mrkcond,newstk_recvrht_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
@@ -26,48 +26,48 @@ ka10019,가격급등락요청,get_domestic_price_surge_drop_stocks,국내주식,
26
26
  ka10020,호가잔량상위요청,get_domestic_order_book_depth_top,국내주식,순위정보,rankings,orderbook-balance,kiwoomcli domestic rankings orderbook-balance,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;sort_tp;trde_qty_tp;stk_cnd;crd_cnd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
27
27
  ka10021,호가잔량급증요청,get_domestic_order_book_depth_surge,국내주식,순위정보,rankings,orderbook-balance-spike,kiwoomcli domestic rankings orderbook-balance-spike,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;trde_tp;sort_tp;tm_tp;trde_qty_tp;stk_cnd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
28
28
  ka10022,잔량율급증요청,get_domestic_order_balance_ratio_surge,국내주식,순위정보,rankings,balance-rate-spike,kiwoomcli domestic rankings balance-rate-spike,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;rt_tp;tm_tp;trde_qty_tp;stk_cnd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
29
- ka10023,거래량급증요청,get_domestic_volume_surge,국내주식,순위정보,rankings,volume-spike,kiwoomcli domestic rankings volume-spike,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;sort_tp;tm_tp;trde_qty_tp;stk_cnd;pric_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
29
+ ka10023,거래량급증요청,get_domestic_volume_surge,국내주식,순위정보,rankings,volume-spike,kiwoomcli domestic rankings volume-spike,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;sort_tp;tm_tp;trde_qty_tp;stk_cnd;pric_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified. 응답 주의: 거래량 필드가 2^32-1(4294967295)로 포화될 수 있다(초대량 종목 실측).
30
30
  ka10024,거래량갱신요청,get_domestic_volume_record_update,국내주식,종목정보,stocks,volume-renewal,kiwoomcli domestic stocks volume-renewal,implemented,public,read,POST,/api/dostk/stkinfo,mrkt_tp;cycle_tp;trde_qty_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
31
31
  ka10025,매물대집중요청,get_domestic_volume_profile_cluster,국내주식,종목정보,stocks,volume-zone,kiwoomcli domestic stocks volume-zone,implemented,public,read,POST,/api/dostk/stkinfo,mrkt_tp;prps_cnctr_rt;cur_prc_entry;prpscnt;cycle_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
32
32
  ka10026,고저PER요청,get_domestic_high_low_per_stocks,국내주식,종목정보,stocks,valuation-rank,kiwoomcli domestic stocks valuation-rank,implemented,public,read,POST,/api/dostk/stkinfo,pertp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
33
33
  ka10027,전일대비등락률상위요청,get_domestic_prev_day_change_rate_top,국내주식,순위정보,rankings,previous-change-rate,kiwoomcli domestic rankings previous-change-rate,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;sort_tp;trde_qty_cnd;stk_cnd;crd_cnd;updown_incls;pric_cnd;trde_prica_cnd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
34
34
  ka10028,시가대비등락률요청,get_domestic_open_price_change_rate,국내주식,종목정보,stocks,open-change,kiwoomcli domestic stocks open-change,implemented,public,read,POST,/api/dostk/stkinfo,sort_tp;trde_qty_cnd;mrkt_tp;updown_incls;stk_cnd;crd_cnd;trde_prica_cnd;flu_cnd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
35
35
  ka10029,예상체결등락률상위요청,get_domestic_expected_execution_change_rate_top,국내주식,순위정보,rankings,list-fills,kiwoomcli domestic rankings list-fills,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;sort_tp;trde_qty_cnd;stk_cnd;crd_cnd;pric_cnd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
36
- ka10030,당일거래량상위요청,get_domestic_today_volume_top,국내주식,순위정보,rankings,today-volume,kiwoomcli domestic rankings today-volume,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;sort_tp;mang_stk_incls;crd_tp;trde_qty_tp;pric_tp;trde_prica_tp;mrkt_open_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
36
+ ka10030,당일거래량상위요청,get_domestic_today_volume_top,국내주식,순위정보,rankings,today-volume,kiwoomcli domestic rankings today-volume,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;sort_tp;mang_stk_incls;crd_tp;trde_qty_tp;pric_tp;trde_prica_tp;mrkt_open_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified. 응답 주의: 거래량 필드가 2^32-1(4294967295)로 포화될 수 있다(초대량 종목 실측).
37
37
  ka10031,전일거래량상위요청,get_domestic_prev_volume_top,국내주식,순위정보,rankings,previous-volume,kiwoomcli domestic rankings previous-volume,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;qry_tp;rank_strt;rank_end;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
38
- ka10032,거래대금상위요청,get_domestic_trading_value_top,국내주식,순위정보,rankings,amount,kiwoomcli domestic rankings amount,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;mang_stk_incls;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
38
+ ka10032,거래대금상위요청,get_domestic_trading_value_top,국내주식,순위정보,rankings,amount,kiwoomcli domestic rankings amount,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;mang_stk_incls;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified. 응답 주의: 거래량 필드가 2^32-1(4294967295)로 포화될 수 있다(초대량 종목 실측).
39
39
  ka10033,신용비율상위요청,get_domestic_credit_ratio_top,국내주식,순위정보,rankings,credit-ratio,kiwoomcli domestic rankings credit-ratio,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;trde_qty_tp;stk_cnd;updown_incls;crd_cnd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
40
- ka10034,외인기간별매매상위요청,get_domestic_foreign_investor_period_trade_top,국내주식,순위정보,rankings,foreign-period-trades,kiwoomcli domestic rankings foreign-period-trades,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;trde_tp;dt;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
40
+ ka10034,외인기간별매매상위요청,get_domestic_foreign_investor_period_trade_top,국내주식,순위정보,rankings,foreign-period-trades,kiwoomcli domestic rankings foreign-period-trades,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;trde_tp;dt;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified. 응답 주의: 거래량 필드가 2^32-1(4294967295)로 포화될 수 있다(초대량 종목 실측).
41
41
  ka10035,외인연속순매매상위요청,get_domestic_foreign_investor_net_buy_streak_top,국내주식,순위정보,rankings,foreign-continuous-net,kiwoomcli domestic rankings foreign-continuous-net,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;trde_tp;base_dt_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
42
- ka10036,외인한도소진율증가상위,get_domestic_foreign_investor_limit_exhaustion_rate_increase_top,국내주식,순위정보,rankings,foreign-limit-usage,kiwoomcli domestic rankings foreign-limit-usage,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;dt;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
42
+ ka10036,외인한도소진율증가상위,get_domestic_foreign_investor_limit_exhaustion_rate_increase_top,국내주식,순위정보,rankings,foreign-limit-usage,kiwoomcli domestic rankings foreign-limit-usage,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;dt;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified. 응답 주의: 거래량 필드가 2^32-1(4294967295)로 포화될 수 있다(초대량 종목 실측).
43
43
  ka10037,외국계창구매매상위요청,get_domestic_foreign_broker_trade_top,국내주식,순위정보,rankings,foreign-broker-trades,kiwoomcli domestic rankings foreign-broker-trades,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;dt;trde_tp;sort_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
44
44
  ka10038,종목별증권사순위요청,get_domestic_stock_broker_rank,국내주식,순위정보,rankings,broker-by-stock,kiwoomcli domestic rankings broker-by-stock,implemented,public,read,POST,/api/dostk/rkinfo,stk_cd;qry_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
45
45
  ka10039,증권사별매매상위요청,get_domestic_broker_trade_top,국내주식,순위정보,rankings,broker-trades,kiwoomcli domestic rankings broker-trades,implemented,public,read,POST,/api/dostk/rkinfo,mmcm_cd;trde_qty_tp;trde_tp;dt;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
46
46
  ka10040,당일주요거래원요청,get_domestic_today_major_brokers,국내주식,순위정보,rankings,stock-main-brokers,kiwoomcli domestic rankings stock-main-brokers,implemented,public,read,POST,/api/dostk/rkinfo,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
47
47
  ka10042,순매수거래원순위요청,get_domestic_net_buy_broker_rank,국내주식,순위정보,rankings,net-buy-brokers,kiwoomcli domestic rankings net-buy-brokers,implemented,public,read,POST,/api/dostk/rkinfo,stk_cd;qry_dt_tp;pot_tp;sort_base,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
48
- ka10043,거래원매물대분석요청,get_domestic_broker_volume_profile_analysis,국내주식,종목정보,stocks,broker-volume-zone,kiwoomcli domestic stocks broker-volume-zone,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd;strt_dt;end_dt;qry_dt_tp;pot_tp;dt;sort_base;mmcm_cd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
49
- ka10044,일별기관매매종목요청,get_domestic_daily_institution_stock_trade,국내주식,시세,quotes,institution-daily,kiwoomcli domestic quotes institution-daily,implemented,public,read,POST,/api/dostk/mrkcond,strt_dt;end_dt;trde_tp;mrkt_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
48
+ ka10043,거래원매물대분석요청,get_domestic_broker_volume_profile_analysis,국내주식,종목정보,stocks,broker-volume-zone,kiwoomcli domestic stocks broker-volume-zone,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd;strt_dt;end_dt;qry_dt_tp;pot_tp;dt;sort_base;mmcm_cd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
49
+ ka10044,일별기관매매종목요청,get_domestic_daily_institution_stock_trade,국내주식,시세,quotes,institution-daily,kiwoomcli domestic quotes institution-daily,implemented,public,read,POST,/api/dostk/mrkcond,strt_dt;end_dt;trde_tp;mrkt_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
50
50
  ka10045,종목별기관매매추이요청,get_domestic_stock_institution_trade_trend,국내주식,시세,quotes,by-stock,kiwoomcli domestic quotes by-stock,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd;strt_dt;end_dt;orgn_prsm_unp_tp;for_prsm_unp_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
51
51
  ka10046,체결강도추이시간별요청,get_domestic_trade_strength_time_trend,국내주식,시세,quotes,strength-time,kiwoomcli domestic quotes strength-time,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
52
52
  ka10047,체결강도추이일별요청,get_domestic_trade_strength_daily_trend,국내주식,시세,quotes,strength-daily,kiwoomcli domestic quotes strength-daily,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
53
- ka10048,ELW일별민감도지표요청,get_domestic_elw_daily_sensitivity_indicator,국내주식,ELW,elws,daily,kiwoomcli domestic elws daily,implemented,public,read,POST,/api/dostk/elw,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
54
- ka10050,ELW민감도지표요청,get_domestic_elw_sensitivity_indicator,국내주식,ELW,elws,sensitivity,kiwoomcli domestic elws sensitivity,implemented,public,read,POST,/api/dostk/elw,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping.
53
+ ka10048,ELW일별민감도지표요청,get_domestic_elw_daily_sensitivity_indicator,국내주식,ELW,elws,daily,kiwoomcli domestic elws daily,implemented,public,read,POST,/api/dostk/elw,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping. 응답 주의: iv/lp는 ×100 정수(스펙 명시).
54
+ ka10050,ELW민감도지표요청,get_domestic_elw_sensitivity_indicator,국내주식,ELW,elws,sensitivity,kiwoomcli domestic elws sensitivity,implemented,public,read,POST,/api/dostk/elw,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping. 응답 주의: elwtheory_pric/iv/lp는 ×100 정수(스펙 명시).
55
55
  ka10051,업종별투자자순매수요청,get_domestic_sector_investor_net_buy,국내주식,업종,sectors,investor-flows,kiwoomcli domestic sectors investor-flows,implemented,public,read,POST,/api/dostk/sect,mrkt_tp;amt_qty_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
56
56
  ka10052,거래원순간거래량요청,get_domestic_broker_instant_volume,국내주식,종목정보,stocks,broker-instant-volume,kiwoomcli domestic stocks broker-instant-volume,implemented,public,read,POST,/api/dostk/stkinfo,mmcm_cd;mrkt_tp;qty_tp;pric_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
57
57
  ka10053,당일상위이탈원요청,get_domestic_today_top_exit_brokers,국내주식,순위정보,rankings,top-exit-brokers,kiwoomcli domestic rankings top-exit-brokers,implemented,public,read,POST,/api/dostk/rkinfo,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
58
58
  ka10054,변동성완화장치발동종목요청,get_domestic_vi_triggered_stocks,국내주식,종목정보,stocks,vi-triggered,kiwoomcli domestic stocks vi-triggered,implemented,public,read,POST,/api/dostk/stkinfo,mrkt_tp;bf_mkrt_tp;motn_tp;skip_stk;trde_qty_tp;min_trde_qty;max_trde_qty;trde_prica_tp;min_trde_prica;max_trde_prica;motn_drc;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
59
59
  ka10055,당일전일체결량요청,get_domestic_today_prev_trade_volume,국내주식,종목정보,stocks,today-previous-fills,kiwoomcli domestic stocks today-previous-fills,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd;tdy_pred,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
60
- ka10058,투자자별일별매매종목요청,get_domestic_investor_daily_trade_stocks,국내주식,종목정보,stocks,investor-daily,kiwoomcli domestic stocks investor-daily,implemented,public,read,POST,/api/dostk/stkinfo,strt_dt;end_dt;trde_tp;mrkt_tp;invsr_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
61
- ka10059,종목별투자자기관별요청,get_domestic_stock_investor_by_institution,국내주식,종목정보,stocks,investor-by-stock,kiwoomcli domestic stocks investor-by-stock,implemented,public,read,POST,/api/dostk/stkinfo,dt;stk_cd;amt_qty_tp;trde_tp;unit_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
62
- ka10060,종목별투자자기관별차트요청,get_domestic_stock_investor_by_institution_chart,국내주식,차트,candles,by-stock,kiwoomcli domestic candles by-stock,implemented,public,read,POST,/api/dostk/chart,dt;stk_cd;amt_qty_tp;trde_tp;unit_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
63
- ka10061,종목별투자자기관별합계요청,get_domestic_stock_investor_by_institution_total,국내주식,종목정보,stocks,investor-by-stock-total,kiwoomcli domestic stocks investor-by-stock-total,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd;strt_dt;end_dt;amt_qty_tp;trde_tp;unit_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
64
- ka10062,동일순매매순위요청,get_domestic_same_direction_net_trade_rank,국내주식,순위정보,rankings,same-net-trades,kiwoomcli domestic rankings same-net-trades,implemented,public,read,POST,/api/dostk/rkinfo,strt_dt;mrkt_tp;trde_tp;sort_cnd;unit_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
60
+ ka10058,투자자별일별매매종목요청,get_domestic_investor_daily_trade_stocks,국내주식,종목정보,stocks,investor-daily,kiwoomcli domestic stocks investor-daily,implemented,public,read,POST,/api/dostk/stkinfo,strt_dt;end_dt;trde_tp;mrkt_tp;invsr_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
61
+ ka10059,종목별투자자기관별요청,get_domestic_stock_investor_by_institution,국내주식,종목정보,stocks,investor-by-stock,kiwoomcli domestic stocks investor-by-stock,implemented,public,read,POST,/api/dostk/stkinfo,dt;stk_cd;amt_qty_tp;trde_tp;unit_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv. 응답 주의: flu_rt는 ×100 정수('+38'=0.38%·실측); 투자자 필드는 금액=백만원 고정·수량은 unit_tp 적용.
62
+ ka10060,종목별투자자기관별차트요청,get_domestic_stock_investor_by_institution_chart,국내주식,차트,candles,by-stock,kiwoomcli domestic candles by-stock,implemented,public,read,POST,/api/dostk/chart,dt;stk_cd;amt_qty_tp;trde_tp;unit_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping. 응답 주의: 투자자 필드는 금액=백만원 고정·수량은 unit_tp 적용(ka10059 계열).
63
+ ka10061,종목별투자자기관별합계요청,get_domestic_stock_investor_by_institution_total,국내주식,종목정보,stocks,investor-by-stock-total,kiwoomcli domestic stocks investor-by-stock-total,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd;strt_dt;end_dt;amt_qty_tp;trde_tp;unit_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv. 응답 주의: 음수가 '--N' 이중부호로 온다(실전·모의 실측); 금액=백만원 고정·수량은 unit_tp 적용.
64
+ ka10062,동일순매매순위요청,get_domestic_same_direction_net_trade_rank,국내주식,순위정보,rankings,same-net-trades,kiwoomcli domestic rankings same-net-trades,implemented,public,read,POST,/api/dostk/rkinfo,strt_dt;mrkt_tp;trde_tp;sort_cnd;unit_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified. 응답 주의: for_nettrde_amt 음수가 '--N' 이중부호로 온다(캡처 실측); nettrde_qty 단위는 unit_tp(1주|1000주).
65
65
  ka10063,장중투자자별매매요청,get_domestic_intraday_investor_trade,국내주식,시세,quotes,investor-intraday,kiwoomcli domestic quotes investor-intraday,implemented,public,read,POST,/api/dostk/mrkcond,mrkt_tp;amt_qty_tp;invsr;frgn_all;smtm_netprps_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
66
66
  ka10064,장중투자자별매매차트요청,get_domestic_intraday_investor_trade_chart,국내주식,차트,candles,lookup,kiwoomcli domestic candles lookup,implemented,public,read,POST,/api/dostk/chart,mrkt_tp;amt_qty_tp;trde_tp;stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
67
- ka10065,장중투자자별매매상위요청,get_domestic_intraday_investor_trade_top,국내주식,순위정보,rankings,investor-intraday,kiwoomcli domestic rankings investor-intraday,implemented,public,read,POST,/api/dostk/rkinfo,trde_tp;mrkt_tp;orgn_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
67
+ ka10065,장중투자자별매매상위요청,get_domestic_intraday_investor_trade_top,국내주식,순위정보,rankings,investor-intraday,kiwoomcli domestic rankings investor-intraday,implemented,public,read,POST,/api/dostk/rkinfo,trde_tp;mrkt_tp;orgn_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified. 응답 주의: buy_qty/sel_qty/netprps_qty 단위가 amt_qty_tp에 따라 1주|백만원으로 전환된다.
68
68
  ka10066,장마감후투자자별매매요청,get_domestic_after_close_investor_trade,국내주식,시세,quotes,investor-after-close,kiwoomcli domestic quotes investor-after-close,implemented,public,read,POST,/api/dostk/mrkcond,mrkt_tp;amt_qty_tp;trde_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
69
69
  ka10068,대차거래추이요청,get_domestic_stock_lending_trade_trend,국내주식,대차거래,securities-lending,trend,kiwoomcli domestic securities-lending trend,implemented,public,read,POST,/api/dostk/slb,all_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
70
- ka10069,대차거래상위10종목요청,get_domestic_stock_lending_top_10_stocks,국내주식,대차거래,securities-lending,list,kiwoomcli domestic securities-lending list,implemented,public,read,POST,/api/dostk/slb,strt_dt;mrkt_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
70
+ ka10069,대차거래상위10종목요청,get_domestic_stock_lending_top_10_stocks,국내주식,대차거래,securities-lending,list,kiwoomcli domestic securities-lending list,implemented,public,read,POST,/api/dostk/slb,strt_dt;mrkt_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping. 응답 주의: 스펙의 비율 4필드(rmnd_rt 등)는 실응답에 없다(실전·모의 실측 유령 필드); 원값 필드만 온다.
71
71
  ka10072,일자별종목별실현손익요청_일자,get_domestic_realized_pnl_by_date_and_stock,국내주식,계좌,accounts,realized-profit-stock-daily,kiwoomcli domestic accounts realized-profit-stock-daily,implemented,guarded,account_read,POST,/api/dostk/acnt,strt_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping with account_read redaction; overseas accounts remain TODO until overseas runtime is verified.
72
72
  ka10073,일자별종목별실현손익요청_기간,get_domestic_realized_pnl_by_period_and_stock,국내주식,계좌,accounts,realized-profit-period-stock,kiwoomcli domestic accounts realized-profit-period-stock,implemented,guarded,account_read,POST,/api/dostk/acnt,strt_dt;end_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping with account_read redaction; overseas accounts remain TODO until overseas runtime is verified.
73
73
  ka10074,일자별실현손익요청,get_domestic_daily_realized_pnl,국내주식,계좌,accounts,realized-profit-daily,kiwoomcli domestic accounts realized-profit-daily,implemented,guarded,account_read,POST,/api/dostk/acnt,strt_dt;end_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping with account_read redaction; overseas accounts remain TODO until overseas runtime is verified.
@@ -77,12 +77,12 @@ ka10077,당일실현손익상세요청,get_domestic_today_realized_pnl_detail,
77
77
  ka10078,증권사별종목매매동향요청,get_domestic_broker_stock_trade_trend,국내주식,시세,quotes,broker-trend,kiwoomcli domestic quotes broker-trend,implemented,public,read,POST,/api/dostk/mrkcond,mmcm_cd;stk_cd;strt_dt;end_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
78
78
  ka10079,주식틱차트조회요청,get_domestic_stock_tick_chart,국내주식,차트,candles,stock-tick,kiwoomcli domestic candles stock-tick,implemented,public,read,POST,/api/dostk/chart,stk_cd;tic_scope;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public candle command via explicit arguments.csv mapping.
79
79
  ka10080,주식분봉차트조회요청,get_domestic_stock_minute_chart,국내주식,차트,candles,stock-minute,kiwoomcli domestic candles stock-minute,implemented,public,read,POST,/api/dostk/chart,stk_cd;tic_scope;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public candle command via explicit arguments.csv mapping.
80
- ka10081,주식일봉차트조회요청,get_domestic_stock_daily_chart,국내주식,차트,candles,daily,kiwoomcli domestic candles daily,implemented,public,read,POST,/api/dostk/chart,stk_cd;base_dt;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public read command; --code maps to stk_cd
80
+ ka10081,주식일봉차트조회요청,get_domestic_stock_daily_chart,국내주식,차트,candles,daily,kiwoomcli domestic candles daily,implemented,public,read,POST,/api/dostk/chart,stk_cd;base_dt;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public read command; --code maps to stk_cd. 응답 주의: 거래량 필드가 2^32-1(4294967295)로 포화될 수 있다(초대량 종목 실측). 곱버스(252670)로 실전·모의 재현; trde_tern_rt는 '-0.00'이 올 수 있다.
81
81
  ka10082,주식주봉차트조회요청,get_domestic_stock_weekly_chart,국내주식,차트,candles,stock-weekly,kiwoomcli domestic candles stock-weekly,implemented,public,read,POST,/api/dostk/chart,stk_cd;base_dt;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public candle command via explicit arguments.csv mapping.
82
82
  ka10083,주식월봉차트조회요청,get_domestic_stock_monthly_chart,국내주식,차트,candles,stock-monthly,kiwoomcli domestic candles stock-monthly,implemented,public,read,POST,/api/dostk/chart,stk_cd;base_dt;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public candle command via explicit arguments.csv mapping.
83
83
  ka10084,당일전일체결요청,get_domestic_today_prev_trades,국내주식,종목정보,stocks,today-previous-trades,kiwoomcli domestic stocks today-previous-trades,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd;tdy_pred;tic_min,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
84
- ka10085,계좌수익률요청,get_domestic_account_return_rate,국내주식,계좌,accounts,return-rate,kiwoomcli domestic accounts return-rate,implemented,guarded,account_read,POST,/api/dostk/acnt,stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping with account_read redaction; overseas accounts remain TODO until overseas runtime is verified.
85
- ka10086,일별주가요청,get_domestic_daily_stock_price,국내주식,시세,quotes,daily-price,kiwoomcli domestic quotes daily-price,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd;qry_dt;indc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
84
+ ka10085,계좌수익률요청,get_domestic_account_return_rate,국내주식,계좌,accounts,return-rate,kiwoomcli domestic accounts return-rate,implemented,guarded,account_read,POST,/api/dostk/acnt,stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping with account_read redaction; overseas accounts remain TODO until overseas runtime is verified. 응답 주의: setl_remn은 스펙 '원'과 달리 주 수량(실측·rmnd_qty와 동일값).
85
+ ka10086,일별주가요청,get_domestic_daily_stock_price,국내주식,시세,quotes,daily-price,kiwoomcli domestic quotes daily-price,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd;qry_dt;indc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv. 응답 주의: 음수 '--N' 이중부호(직접호출 실측); frgn/prm 등은 indc_tp 조건부(1주|백만원)인데 for_netprps만 플래그를 무시하고 수량 고정.
86
86
  ka10087,시간외단일가요청,get_domestic_after_hours_single_price,국내주식,시세,quotes,after-hours,kiwoomcli domestic quotes after-hours,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
87
87
  ka10088,미체결 분할주문 상세,get_domestic_unfilled_split_order_detail,국내주식,계좌,orders,open-detail,kiwoomcli domestic orders open-detail,implemented,guarded,account_read,POST,/api/dostk/acnt,ord_no,api-id;authorization,--account when account scoped; --code when instrument scoped,Implemented guarded order inquiry command via explicit arguments.csv mapping.
88
88
  ka10094,주식년봉차트조회요청,get_domestic_stock_yearly_chart,국내주식,차트,candles,stock-yearly,kiwoomcli domestic candles stock-yearly,implemented,public,read,POST,/api/dostk/chart,stk_cd;base_dt;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public candle command via explicit arguments.csv mapping.
@@ -92,41 +92,41 @@ ka10099,종목정보 리스트,list_domestic_stocks,국내주식,종목정보,st
92
92
  ka10100,종목정보 조회,get_domestic_stock_detail,국내주식,종목정보,stocks,info-detail,kiwoomcli domestic stocks info-detail,implemented,public,read,POST,/api/dostk/stkinfo,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
93
93
  ka10101,업종코드 리스트,list_domestic_sector_codes,국내주식,종목정보,stocks,sector-codes,kiwoomcli domestic stocks sector-codes,implemented,public,read,POST,/api/dostk/stkinfo,mrkt_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
94
94
  ka10102,회원사 리스트,list_domestic_brokers,국내주식,종목정보,stocks,member-firms,kiwoomcli domestic stocks member-firms,implemented,public,read,POST,/api/dostk/stkinfo,,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
95
- ka10131,기관외국인연속매매현황요청,get_domestic_institution_foreign_investor_trade_streak,국내주식,기관/외국인,investors,trend,kiwoomcli domestic investors trend,implemented,public,read,POST,/api/dostk/frgnistt,dt;mrkt_tp;netslmt_tp;stk_inds_tp;amt_qty_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public investor trend command via explicit arguments.csv mapping.
95
+ ka10131,기관외국인연속매매현황요청,get_domestic_institution_foreign_investor_trade_streak,국내주식,기관/외국인,investors,trend,kiwoomcli domestic investors trend,implemented,public,read,POST,/api/dostk/frgnistt,dt;mrkt_tp;netslmt_tp;stk_inds_tp;amt_qty_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public investor trend command via explicit arguments.csv mapping. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
96
96
  ka10170,당일매매일지요청,get_domestic_today_trade_journal,국내주식,계좌,accounts,day-trading-log,kiwoomcli domestic accounts day-trading-log,implemented,guarded,account_read,POST,/api/dostk/acnt,ottks_tp;ch_crd_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping with account_read redaction; overseas accounts remain TODO until overseas runtime is verified.
97
97
  ka10171,조건검색 목록조회,list_domestic_condition_searches,국내주식,조건검색,streams,conditions-list,kiwoomcli domestic streams conditions-list,implemented,public,read,POST,/api/dostk/websocket,trnm,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping and package WebSocket client.
98
- ka10172,조건검색 요청 일반,request_domestic_condition_search,국내주식,조건검색,streams,conditions-search,kiwoomcli domestic streams conditions-search,implemented,public,read,POST,/api/dostk/websocket,trnm;seq;search_type;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping and package WebSocket client.
98
+ ka10172,조건검색 요청 일반,request_domestic_condition_search,국내주식,조건검색,streams,conditions-search,kiwoomcli domestic streams conditions-search,implemented,public,read,POST,/api/dostk/websocket,trnm;seq;search_type;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping and package WebSocket client. 응답 주의: 등락율(element '12')은 0패딩 ×100 정수('000001500'=+1.50%·스펙 명시).
99
99
  ka10173,조건검색 요청 실시간,request_domestic_realtime_condition_search,국내주식,조건검색,streams,conditions-subscribe,kiwoomcli domestic streams conditions-subscribe,implemented,public,read,POST,/api/dostk/websocket,trnm;seq;search_type;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping and package WebSocket client.
100
100
  ka10174,조건검색 실시간 해제,stop_domestic_realtime_condition_search,국내주식,조건검색,streams,conditions-unsubscribe,kiwoomcli domestic streams conditions-unsubscribe,implemented,public,read,POST,/api/dostk/websocket,trnm;seq,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping and package WebSocket client.
101
101
  ka20001,업종현재가요청,get_domestic_sector_price,국내주식,업종,sectors,price,kiwoomcli domestic sectors price,implemented,public,read,POST,/api/dostk/sect,mrkt_tp;inds_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
102
102
  ka20002,업종별주가요청,get_domestic_sector_stock_price,국내주식,업종,sectors,stocks,kiwoomcli domestic sectors stocks,implemented,public,read,POST,/api/dostk/sect,mrkt_tp;inds_cd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
103
103
  ka20003,전업종지수요청,get_domestic_all_sector_indices,국내주식,업종,sectors,indices,kiwoomcli domestic sectors indices,implemented,public,read,POST,/api/dostk/sect,inds_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
104
- ka20004,업종틱차트조회요청,get_domestic_sector_tick_chart,국내주식,차트,candles,sector-tick,kiwoomcli domestic candles sector-tick,implemented,public,read,POST,/api/dostk/chart,inds_cd;tic_scope,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping.
105
- ka20005,업종분봉조회요청,get_domestic_sector_minute_chart,국내주식,차트,candles,sector-minute,kiwoomcli domestic candles sector-minute,implemented,public,read,POST,/api/dostk/chart,inds_cd;tic_scope,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping.
106
- ka20006,업종일봉조회요청,get_domestic_sector_daily_chart,국내주식,차트,candles,sector-daily,kiwoomcli domestic candles sector-daily,implemented,public,read,POST,/api/dostk/chart,inds_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping.
107
- ka20007,업종주봉조회요청,get_domestic_sector_weekly_chart,국내주식,차트,candles,sector-weekly,kiwoomcli domestic candles sector-weekly,implemented,public,read,POST,/api/dostk/chart,inds_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping.
108
- ka20008,업종월봉조회요청,get_domestic_sector_monthly_chart,국내주식,차트,candles,sector-monthly,kiwoomcli domestic candles sector-monthly,implemented,public,read,POST,/api/dostk/chart,inds_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping.
104
+ ka20004,업종틱차트조회요청,get_domestic_sector_tick_chart,국내주식,차트,candles,sector-tick,kiwoomcli domestic candles sector-tick,implemented,public,read,POST,/api/dostk/chart,inds_cd;tic_scope,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping. 응답 주의: 지수 OHLC는 ×100 정수(683580=6835.80·스펙 명시).
105
+ ka20005,업종분봉조회요청,get_domestic_sector_minute_chart,국내주식,차트,candles,sector-minute,kiwoomcli domestic candles sector-minute,implemented,public,read,POST,/api/dostk/chart,inds_cd;tic_scope,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping. 응답 주의: 지수 OHLC는 ×100 정수(스펙 명시); pred_pre 음수 '--N' 이중부호(캡처 실측).
106
+ ka20006,업종일봉조회요청,get_domestic_sector_daily_chart,국내주식,차트,candles,sector-daily,kiwoomcli domestic candles sector-daily,implemented,public,read,POST,/api/dostk/chart,inds_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping. 응답 주의: 지수 OHLC는 ×100 정수(스펙 명시·실측); trde_qty는 스펙 '1주'와 달리 천주(스냅샷 ka20003과 동일값·실측).
107
+ ka20007,업종주봉조회요청,get_domestic_sector_weekly_chart,국내주식,차트,candles,sector-weekly,kiwoomcli domestic candles sector-weekly,implemented,public,read,POST,/api/dostk/chart,inds_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping. 응답 주의: 지수 OHLC는 ×100 정수(스펙 명시); trde_qty는 일봉과 동일 계열이라 천주로 추정(스펙 '1주' 오기 의심).
108
+ ka20008,업종월봉조회요청,get_domestic_sector_monthly_chart,국내주식,차트,candles,sector-monthly,kiwoomcli domestic candles sector-monthly,implemented,public,read,POST,/api/dostk/chart,inds_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping. 응답 주의: 지수 OHLC는 ×100 정수(스펙 명시); trde_qty는 일봉과 동일 계열이라 천주로 추정(스펙 '1주' 오기 의심).
109
109
  ka20009,업종현재가일별요청,get_domestic_sector_daily_price,국내주식,업종,sectors,daily,kiwoomcli domestic sectors daily,implemented,public,read,POST,/api/dostk/sect,mrkt_tp;inds_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
110
- ka20019,업종년봉조회요청,get_domestic_sector_yearly_chart,국내주식,차트,candles,sector-yearly,kiwoomcli domestic candles sector-yearly,implemented,public,read,POST,/api/dostk/chart,inds_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping.
110
+ ka20019,업종년봉조회요청,get_domestic_sector_yearly_chart,국내주식,차트,candles,sector-yearly,kiwoomcli domestic candles sector-yearly,implemented,public,read,POST,/api/dostk/chart,inds_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public sector candle command via explicit arguments.csv mapping. 응답 주의: 지수 OHLC는 ×100 정수(스펙 명시); trde_qty는 일봉과 동일 계열이라 천주로 추정(스펙 '1주' 오기 의심).
111
111
  ka20068,대차거래추이요청(종목별),get_domestic_stock_lending_trade_trend_by_stock,국내주식,대차거래,securities-lending,by-stock,kiwoomcli domestic securities-lending by-stock,implemented,public,read,POST,/api/dostk/slb,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
112
112
  ka30001,ELW가격급등락요청,get_domestic_elw_price_surge_drop,국내주식,ELW,elws,price-move,kiwoomcli domestic elws price-move,implemented,public,read,POST,/api/dostk/elw,flu_tp;tm_tp;tm;trde_qty_tp;isscomp_cd;bsis_aset_cd;rght_tp;lpcd;trde_end_elwskip,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping.
113
113
  ka30002,거래원별ELW순매매상위요청,get_domestic_broker_elw_net_buy_top,국내주식,ELW,elws,broker-net,kiwoomcli domestic elws broker-net,implemented,public,read,POST,/api/dostk/elw,isscomp_cd;trde_qty_tp;trde_tp;dt;trde_end_elwskip,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping.
114
114
  ka30003,ELWLP보유일별추이요청,get_domestic_elw_lp_daily_holding_trend,국내주식,ELW,elws,balance,kiwoomcli domestic elws balance,implemented,public,read,POST,/api/dostk/elw,bsis_aset_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
115
- ka30004,ELW괴리율요청,get_domestic_elw_disparity_rate,국내주식,ELW,elws,divergence,kiwoomcli domestic elws divergence,implemented,public,read,POST,/api/dostk/elw,isscomp_cd;bsis_aset_cd;rght_tp;lpcd;trde_end_elwskip,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping.
115
+ ka30004,ELW괴리율요청,get_domestic_elw_disparity_rate,국내주식,ELW,elws,divergence,kiwoomcli domestic elws divergence,implemented,public,read,POST,/api/dostk/elw,isscomp_cd;bsis_aset_cd;rght_tp;lpcd;trde_end_elwskip,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping. 응답 주의: theory_pric/dispty_rt는 ×100 정수(스펙 명시); 음수 '--N' 이중부호(캡처 실측).
116
116
  ka30005,ELW조건검색요청,search_domestic_elw_by_condition,국내주식,ELW,elws,conditions,kiwoomcli domestic elws conditions,implemented,public,read,POST,/api/dostk/elw,isscomp_cd;bsis_aset_cd;rght_tp;lpcd;sort_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
117
117
  ka30009,ELW등락율순위요청,get_domestic_elw_change_rate_rank,국내주식,ELW,elws,change-rank,kiwoomcli domestic elws change-rank,implemented,public,read,POST,/api/dostk/elw,sort_tp;rght_tp;trde_end_skip,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping.
118
118
  ka30010,ELW잔량순위요청,get_domestic_elw_remaining_order_rank,국내주식,ELW,elws,balance-rank,kiwoomcli domestic elws balance-rank,implemented,public,read,POST,/api/dostk/elw,sort_tp;rght_tp;trde_end_skip,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping.
119
119
  ka30011,ELW근접율요청,get_domestic_elw_proximity_rate,국내주식,ELW,elws,proximity,kiwoomcli domestic elws proximity,implemented,public,read,POST,/api/dostk/elw,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping.
120
- ka30012,ELW종목상세정보요청,get_domestic_elw_detail,국내주식,ELW,elws,details,kiwoomcli domestic elws details,implemented,public,read,POST,/api/dostk/elw,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping.
120
+ ka30012,ELW종목상세정보요청,get_domestic_elw_detail,국내주식,ELW,elws,details,kiwoomcli domestic elws details,implemented,public,read,POST,/api/dostk/elw,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ELW command via explicit arguments.csv mapping. 응답 주의: elwtheory_pric은 ×100 정수(스펙 명시); dispty_rt 음수 '--N' 이중부호(캡처 실측); stkcnt 단위 '천원'은 천주 오기 의심(미실측).
121
121
  ka40001,ETF수익율요청,get_domestic_etf_return_rate,국내주식,ETF,etfs,profit,kiwoomcli domestic etfs profit,implemented,public,read,POST,/api/dostk/etf,stk_cd;etfobjt_idex_cd;dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
122
122
  ka40002,ETF종목정보요청,get_domestic_etf_info,국내주식,ETF,etfs,info,kiwoomcli domestic etfs info,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
123
- ka40003,ETF일별추이요청,get_domestic_etf_daily_trend,국내주식,ETF,etfs,daily,kiwoomcli domestic etfs daily,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
123
+ ka40003,ETF일별추이요청,get_domestic_etf_daily_trend,국내주식,ETF,etfs,daily,kiwoomcli domestic etfs daily,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping. 응답 주의: acc_trde_prica는 스펙 '1주'와 달리 백만원(곱버스 실측); trace_* 필드는 ×100 정수(스펙 명시).
124
124
  ka40004,ETF전체시세요청,get_domestic_etf_all_quotes,국내주식,ETF,etfs,list,kiwoomcli domestic etfs list,implemented,public,read,POST,/api/dostk/etf,txon_type;navpre;mngmcomp;txon_yn;trace_idex;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
125
- ka40006,ETF시간대별추이요청,get_domestic_etf_intraday_trend,국내주식,ETF,etfs,intraday-trend,kiwoomcli domestic etfs intraday-trend,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ETF command via explicit arguments.csv mapping.
125
+ ka40006,ETF시간대별추이요청,get_domestic_etf_intraday_trend,국내주식,ETF,etfs,intraday-trend,kiwoomcli domestic etfs intraday-trend,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ETF command via explicit arguments.csv mapping. 응답 주의: trace_idex 계열은 ×100 정수(스펙 명시).
126
126
  ka40007,ETF시간대별체결요청,get_domestic_etf_intraday_trades,국내주식,ETF,etfs,intraday-fills,kiwoomcli domestic etfs intraday-fills,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ETF command via explicit arguments.csv mapping.
127
- ka40008,ETF일자별체결요청,get_domestic_etf_trades_by_date,국내주식,ETF,etfs,daily-fills,kiwoomcli domestic etfs daily-fills,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ETF command via explicit arguments.csv mapping.
127
+ ka40008,ETF일자별체결요청,get_domestic_etf_trades_by_date,국내주식,ETF,etfs,daily-fills,kiwoomcli domestic etfs daily-fills,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ETF command via explicit arguments.csv mapping. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
128
128
  ka40009,ETF시간대별NAV현황,get_domestic_etf_intraday_nav_status,국내주식,ETF,etfs,nav,kiwoomcli domestic etfs nav,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ETF NAV command via explicit arguments.csv mapping.
129
- ka40010,ETF시간대별수급현황,get_domestic_etf_intraday_supply_demand_status,국내주식,ETF,etfs,foreign-trend,kiwoomcli domestic etfs foreign-trend,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ETF foreign trend command via explicit arguments.csv mapping.
129
+ ka40010,ETF시간대별수급현황,get_domestic_etf_intraday_supply_demand_status,국내주식,ETF,etfs,foreign-trend,kiwoomcli domestic etfs foreign-trend,implemented,public,read,POST,/api/dostk/etf,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public ETF foreign trend command via explicit arguments.csv mapping. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
130
130
  ka50010,금현물체결추이,get_domestic_gold_spot_trade_trend,국내주식,시세,quotes,gold-fills,kiwoomcli domestic quotes gold-fills,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold spot quote command via explicit arguments.csv mapping.
131
131
  ka50012,금현물일별추이,get_domestic_gold_spot_daily_trend,국내주식,시세,quotes,gold-daily,kiwoomcli domestic quotes gold-daily,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd;base_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold spot quote command via explicit arguments.csv mapping.
132
132
  ka50079,금현물틱차트조회요청,get_domestic_gold_spot_tick_chart,국내주식,차트,candles,gold-tick,kiwoomcli domestic candles gold-tick,implemented,public,read,POST,/api/dostk/chart,stk_cd;tic_scope;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold candle command via explicit arguments.csv mapping.
@@ -134,7 +134,7 @@ ka50080,금현물분봉차트조회요청,get_domestic_gold_spot_minute_chart,
134
134
  ka50081,금현물일봉차트조회요청,get_domestic_gold_spot_daily_chart,국내주식,차트,candles,gold-daily,kiwoomcli domestic candles gold-daily,implemented,public,read,POST,/api/dostk/chart,stk_cd;base_dt;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold candle command via explicit arguments.csv mapping.
135
135
  ka50082,금현물주봉차트조회요청,get_domestic_gold_spot_weekly_chart,국내주식,차트,candles,gold-weekly,kiwoomcli domestic candles gold-weekly,implemented,public,read,POST,/api/dostk/chart,stk_cd;base_dt;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold candle command via explicit arguments.csv mapping.
136
136
  ka50083,금현물월봉차트조회요청,get_domestic_gold_spot_monthly_chart,국내주식,차트,candles,gold-monthly,kiwoomcli domestic candles gold-monthly,implemented,public,read,POST,/api/dostk/chart,stk_cd;base_dt;upd_stkpc_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold candle command via explicit arguments.csv mapping.
137
- ka50087,금현물예상체결,get_domestic_gold_spot_expected_execution,국내주식,시세,quotes,gold-expected,kiwoomcli domestic quotes gold-expected,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold spot quote command via explicit arguments.csv mapping.
137
+ ka50087,금현물예상체결,get_domestic_gold_spot_expected_execution,국내주식,시세,quotes,gold-expected,kiwoomcli domestic quotes gold-expected,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold spot quote command via explicit arguments.csv mapping. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
138
138
  ka50091,금현물당일틱차트조회요청,get_domestic_gold_spot_today_tick_chart,국내주식,차트,candles,gold-today-tick,kiwoomcli domestic candles gold-today-tick,implemented,public,read,POST,/api/dostk/chart,stk_cd;tic_scope,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold candle command via explicit arguments.csv mapping.
139
139
  ka50092,금현물당일분봉차트조회요청,get_domestic_gold_spot_today_minute_chart,국내주식,차트,candles,gold-today-minute,kiwoomcli domestic candles gold-today-minute,implemented,public,read,POST,/api/dostk/chart,stk_cd;tic_scope,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold candle command via explicit arguments.csv mapping.
140
140
  ka50100,금현물 시세정보,get_domestic_gold_spot_quote_info,국내주식,시세,quotes,gold-price,kiwoomcli domestic quotes gold-price,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented public gold spot quote command via explicit arguments.csv mapping.
@@ -144,14 +144,14 @@ ka90001,테마그룹별요청,get_domestic_theme_groups,국내주식,테마,them
144
144
  ka90002,테마구성종목요청,get_domestic_theme_stocks,국내주식,테마,themes,by-stock,kiwoomcli domestic themes by-stock,implemented,public,read,POST,/api/dostk/thme,thema_grp_cd;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
145
145
  ka90003,프로그램순매수상위50요청,get_domestic_program_net_buy_top_50,국내주식,종목정보,stocks,program-net-top,kiwoomcli domestic stocks program-net-top,implemented,public,read,POST,/api/dostk/stkinfo,trde_upper_tp;amt_qty_tp;mrkt_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
146
146
  ka90004,종목별프로그램매매현황요청,get_domestic_stock_program_trade_status,국내주식,종목정보,stocks,program-by-stock,kiwoomcli domestic stocks program-by-stock,implemented,public,read,POST,/api/dostk/stkinfo,dt;mrkt_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit stocks read command; request fields are mapped in arguments.csv.
147
- ka90005,프로그램매매추이요청 시간대별,get_domestic_program_trade_intraday_trend,국내주식,시세,quotes,program-time,kiwoomcli domestic quotes program-time,implemented,public,read,POST,/api/dostk/mrkcond,date;amt_qty_tp;mrkt_tp;min_tic_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
147
+ ka90005,프로그램매매추이요청 시간대별,get_domestic_program_trade_intraday_trend,국내주식,시세,quotes,program-time,kiwoomcli domestic quotes program-time,implemented,public,read,POST,/api/dostk/mrkcond,date;amt_qty_tp;mrkt_tp;min_tic_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
148
148
  ka90006,프로그램매매차익잔고추이요청,get_domestic_program_arbitrage_balance_trend,국내주식,시세,quotes,balance,kiwoomcli domestic quotes balance,implemented,public,read,POST,/api/dostk/mrkcond,date;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
149
- ka90007,프로그램매매누적추이요청,get_domestic_program_trade_accumulated_trend,국내주식,시세,quotes,program-cumulative,kiwoomcli domestic quotes program-cumulative,implemented,public,read,POST,/api/dostk/mrkcond,date;amt_qty_tp;mrkt_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
150
- ka90008,종목시간별프로그램매매추이요청,get_domestic_stock_program_intraday_trend,국내주식,시세,quotes,program-by-stock,kiwoomcli domestic quotes program-by-stock,implemented,public,read,POST,/api/dostk/mrkcond,amt_qty_tp;stk_cd;date,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
149
+ ka90007,프로그램매매누적추이요청,get_domestic_program_trade_accumulated_trend,국내주식,시세,quotes,program-cumulative,kiwoomcli domestic quotes program-cumulative,implemented,public,read,POST,/api/dostk/mrkcond,date;amt_qty_tp;mrkt_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
150
+ ka90008,종목시간별프로그램매매추이요청,get_domestic_stock_program_intraday_trend,국내주식,시세,quotes,program-by-stock,kiwoomcli domestic quotes program-by-stock,implemented,public,read,POST,/api/dostk/mrkcond,amt_qty_tp;stk_cd;date,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
151
151
  ka90009,외국인기관매매상위요청,get_domestic_foreign_institution_trade_top,국내주식,순위정보,rankings,foreign-institution-trades,kiwoomcli domestic rankings foreign-institution-trades,implemented,public,read,POST,/api/dostk/rkinfo,mrkt_tp;amt_qty_tp;qry_dt_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping; overseas rankings remain TODO until overseas runtime is verified.
152
152
  ka90010,프로그램매매추이요청 일자별,get_domestic_program_trade_daily_trend,국내주식,시세,quotes,program-daily,kiwoomcli domestic quotes program-daily,implemented,public,read,POST,/api/dostk/mrkcond,date;amt_qty_tp;mrkt_tp;min_tic_tp;stex_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
153
153
  ka90012,대차거래내역요청,get_domestic_stock_lending_trade_history,국내주식,대차거래,securities-lending,lookup,kiwoomcli domestic securities-lending lookup,implemented,public,read,POST,/api/dostk/slb,dt;mrkt_tp,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping.
154
- ka90013,종목일별프로그램매매추이요청,get_domestic_stock_program_daily_trend,국내주식,시세,quotes,stock-program-daily,kiwoomcli domestic quotes stock-program-daily,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv.
154
+ ka90013,종목일별프로그램매매추이요청,get_domestic_stock_program_daily_trend,국내주식,시세,quotes,stock-program-daily,kiwoomcli domestic quotes stock-program-daily,implemented,public,read,POST,/api/dostk/mrkcond,stk_cd,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented as an explicit quotes read command; request fields are mapped in arguments.csv. 응답 주의: 일부 음수 필드가 '--N' 이중부호로 온다(캡처 실측).
155
155
  kt00001,예수금상세현황요청,get_domestic_deposit_detail,국내주식,계좌,accounts,cash,kiwoomcli domestic accounts cash,implemented,guarded,account_read,POST,/api/dostk/acnt,qry_tp,api-id;authorization,--account when account scoped; --code when instrument scoped,Implemented guarded account read command via explicit arguments.csv mapping.
156
156
  kt00002,일별추정예탁자산현황요청,get_domestic_daily_estimated_deposit_asset,국내주식,계좌,accounts,estimated-assets-daily,kiwoomcli domestic accounts estimated-assets-daily,implemented,guarded,account_read,POST,/api/dostk/acnt,start_dt;end_dt,api-id;authorization,--code when a code/symbol/sector/theme is required,Implemented via explicit arguments.csv mapping with account_read redaction; overseas accounts remain TODO until overseas runtime is verified.
157
157
  kt00003,추정자산조회요청,get_domestic_estimated_asset,국내주식,계좌,accounts,assets,kiwoomcli domestic accounts assets,implemented,guarded,account_read,POST,/api/dostk/acnt,qry_tp,api-id;authorization,--account when account scoped; --code when instrument scoped,Implemented guarded account read command via explicit arguments.csv mapping.
@@ -269,8 +269,8 @@ usa24151,미국주식 회전율 상위(ETF),get_overseas_turnover_rate_top_etf,
269
269
  usa24160,미국주식 연속상승/하락 순위(주식/업종),get_overseas_consecutive_rise_fall_rank,미국주식,순위정보,overseas rankings,consecutive-rise-fall,kiwoomcli overseas rankings consecutive-rise-fall,implemented,public,read,POST,/api/us/rkinfo,,api-id;authorization,--code when a code/symbol/sector/theme is required,Curated for 문서8 overseas inclusion; CLI activation pending.
270
270
  usa24161,미국주식 연속상승/하락 순위(ETF),get_overseas_consecutive_rise_fall_rank_etf,미국주식,순위정보,overseas rankings,consecutive-rise-fall-etf,kiwoomcli overseas rankings consecutive-rise-fall-etf,implemented,public,read,POST,/api/us/rkinfo,,api-id;authorization,--code when a code/symbol/sector/theme is required,Curated for 문서8 overseas inclusion; CLI activation pending.
271
271
  usa24162,미국주식 연속상승/하락 순위(관심종목),get_overseas_consecutive_rise_fall_rank_watchlist,미국주식,순위정보,overseas rankings,consecutive-rise-fall-watchlist,kiwoomcli overseas rankings consecutive-rise-fall-watchlist,implemented,public,read,POST,/api/us/rkinfo,,api-id;authorization,,Curated for 문서8 overseas inclusion; CLI activation pending.
272
- usa24200,미국주식 호가잔량상위(주식/업종),get_overseas_order_book_depth_top,미국주식,순위정보,overseas rankings,order-book-depth-top,kiwoomcli overseas rankings order-book-depth-top,implemented,public,read,POST,/api/us/rkinfo,,api-id;authorization,--code when a code/symbol/sector/theme is required,Curated for 문서8 overseas inclusion; CLI activation pending.
273
- usa24201,미국주식 호가잔량상위(ETF),get_overseas_order_book_depth_top_etf,미국주식,순위정보,overseas rankings,order-book-depth-top-etf,kiwoomcli overseas rankings order-book-depth-top-etf,implemented,public,read,POST,/api/us/rkinfo,,api-id;authorization,,Curated for 문서8 overseas inclusion; CLI activation pending.
272
+ usa24200,미국주식 호가잔량상위(주식/업종),get_overseas_order_book_depth_top,미국주식,순위정보,overseas rankings,order-book-depth-top,kiwoomcli overseas rankings order-book-depth-top,implemented,public,read,POST,/api/us/rkinfo,,api-id;authorization,--code when a code/symbol/sector/theme is required,Curated for 문서8 overseas inclusion; CLI activation pending. 응답 주의: buy_rt/sel_rt는 ×100 정수(스펙 명시).
273
+ usa24201,미국주식 호가잔량상위(ETF),get_overseas_order_book_depth_top_etf,미국주식,순위정보,overseas rankings,order-book-depth-top-etf,kiwoomcli overseas rankings order-book-depth-top-etf,implemented,public,read,POST,/api/us/rkinfo,,api-id;authorization,,Curated for 문서8 overseas inclusion; CLI activation pending. 응답 주의: buy_rt/sel_rt는 ×100 정수(스펙 명시).
274
274
  usa24210,미국주식 잔량률급증(주식/업종),get_overseas_remaining_order_ratio_surge,미국주식,종목정보,overseas stocks,remaining-ratio-surge,kiwoomcli overseas stocks remaining-ratio-surge,implemented,public,read,POST,/api/us/stkinfo,,api-id;authorization,--code when a code/symbol/sector/theme is required,Curated for 문서8 overseas inclusion; CLI activation pending.
275
275
  usa24211,미국주식 잔량률급증(ETF),get_overseas_remaining_order_ratio_surge_etf,미국주식,종목정보,overseas stocks,remaining-ratio-surge-etf,kiwoomcli overseas stocks remaining-ratio-surge-etf,implemented,public,read,POST,/api/us/stkinfo,,api-id;authorization,,Curated for 문서8 overseas inclusion; CLI activation pending.
276
276
  usa24220,미국주식 매물대집중(주식/업종),get_overseas_supply_concentration,미국주식,종목정보,overseas stocks,supply-concentration,kiwoomcli overseas stocks supply-concentration,implemented,public,read,POST,/api/us/stkinfo,,api-id;authorization,--code when a code/symbol/sector/theme is required,Curated for 문서8 overseas inclusion; CLI activation pending.
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/arguments.csv RENAMED
@@ -7,9 +7,9 @@ kiwoomcli domestic candles daily,--date,date,base_dt,Y,date_yyyymmdd,,,,기준
7
7
  kiwoomcli domestic candles daily,--adjusted,adjusted,upd_stkpc_tp,N,adjusted_price_flag,0|1|true|false|adjusted|raw,,1,수정주가 구분
8
8
  kiwoomcli domestic candles by-stock,--date,date,dt,Y,date_yyyymmdd,,,,조회일자 YYYYMMDD
9
9
  kiwoomcli domestic candles by-stock,--code,code,stk_cd,Y,stock_code,,,,6자리 국내 종목코드
10
- kiwoomcli domestic candles by-stock,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분
10
+ kiwoomcli domestic candles by-stock,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분 (amount=백만원 고정; 수량 단위는 --unit)
11
11
  kiwoomcli domestic candles by-stock,--side,side,trde_tp,Y,market,net-buy|buy|sell,net-buy=0;buy=1;sell=2,,매매구분
12
- kiwoomcli domestic candles by-stock,--unit,unit,unit_tp,Y,market,thousand|share,thousand=1000;share=1,,단위구분
12
+ kiwoomcli domestic candles by-stock,--unit,unit,unit_tp,Y,market,thousand|share,thousand=1000;share=1,,수량 단위 (thousand=1000주; share=1주; --basis quantity에서만 적용)
13
13
  kiwoomcli domestic candles lookup,--market,market,mrkt_tp,Y,market,all|kospi|kosdaq,all=000;kospi=001;kosdaq=101,,시장구분
14
14
  kiwoomcli domestic candles lookup,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분
15
15
  kiwoomcli domestic candles lookup,--side,side,trde_tp,Y,market,net-buy|buy|sell,net-buy=0;buy=1;sell=2,,매매구분
@@ -98,7 +98,7 @@ kiwoomcli domestic themes lookup,--code,code,stk_cd,N,stock_code,,,,종목코드
98
98
  kiwoomcli domestic themes lookup,--name,name,thema_nm,N,market,,,,테마명
99
99
  kiwoomcli domestic sectors program,--code,code,stk_cd,Y,stock_code,,,,거래소별 종목코드
100
100
  kiwoomcli domestic sectors investor-flows,--market,market,mrkt_tp,Y,market,kospi|kosdaq,kospi=0;kosdaq=1,,시장구분
101
- kiwoomcli domestic sectors investor-flows,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=0;quantity=1,,금액/수량 구분
101
+ kiwoomcli domestic sectors investor-flows,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=0;quantity=1,,금액/수량 구분 (amount=억원; quantity=1000주)
102
102
  kiwoomcli domestic sectors investor-flows,--date,date,base_dt,N,date_yyyymmdd,,,,기준일자 YYYYMMDD
103
103
  kiwoomcli domestic sectors investor-flows,--exchange,exchange,stex_tp,Y,market,KRX|NXT|ALL,KRX=1;NXT=2;ALL=3,,거래소구분
104
104
  kiwoomcli domestic sectors price,--market,market,mrkt_tp,Y,market,kospi|kosdaq|kospi200,kospi=0;kosdaq=1;kospi200=2,,시장구분
@@ -244,7 +244,7 @@ kiwoomcli domestic quotes broker-trend,--from,from_date,strt_dt,Y,date_yyyymmdd,
244
244
  kiwoomcli domestic quotes broker-trend,--to,to_date,end_dt,Y,date_yyyymmdd,,,,종료일자 YYYYMMDD
245
245
  kiwoomcli domestic quotes daily-price,--code,code,stk_cd,Y,exchange_stock_code,,,,거래소별 종목코드
246
246
  kiwoomcli domestic quotes daily-price,--date,date,qry_dt,Y,date_yyyymmdd,,,,조회일자 YYYYMMDD
247
- kiwoomcli domestic quotes daily-price,--basis,basis,indc_tp,Y,market,quantity|amount,quantity=0;amount=1,,표시구분
247
+ kiwoomcli domestic quotes daily-price,--basis,basis,indc_tp,Y,market,quantity|amount,quantity=0;amount=1,,표시구분 (quantity=1주; amount=백만원; for_netprps는 항상 수량)
248
248
  kiwoomcli domestic quotes after-hours,--code,code,stk_cd,Y,exchange_stock_code,,,,거래소별 종목코드
249
249
  kiwoomcli domestic quotes program-time,--date,date,date,Y,date_yyyymmdd,,,,조회일자 YYYYMMDD
250
250
  kiwoomcli domestic quotes program-time,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분
@@ -364,15 +364,15 @@ kiwoomcli domestic stocks investor-daily,--investor,investor,invsr_tp,Y,market,i
364
364
  kiwoomcli domestic stocks investor-daily,--exchange,exchange,stex_tp,Y,market,KRX|NXT|ALL,KRX=1;NXT=2;ALL=3,,거래소구분
365
365
  kiwoomcli domestic stocks investor-by-stock,--date,date,dt,Y,date_yyyymmdd,,,,조회일자 YYYYMMDD
366
366
  kiwoomcli domestic stocks investor-by-stock,--code,code,stk_cd,Y,exchange_stock_code,,,,거래소별 종목코드
367
- kiwoomcli domestic stocks investor-by-stock,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분
367
+ kiwoomcli domestic stocks investor-by-stock,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분 (amount=백만원 고정; 수량 단위는 --unit)
368
368
  kiwoomcli domestic stocks investor-by-stock,--side,side,trde_tp,Y,market,net-buy|buy|sell,net-buy=0;buy=1;sell=2,,매매구분
369
- kiwoomcli domestic stocks investor-by-stock,--unit,unit,unit_tp,Y,market,thousand|share,thousand=1000;share=1,,단위구분
369
+ kiwoomcli domestic stocks investor-by-stock,--unit,unit,unit_tp,Y,market,thousand|share,thousand=1000;share=1,,수량 단위 (thousand=1000주; share=1주; --basis quantity에서만 적용)
370
370
  kiwoomcli domestic stocks investor-by-stock-total,--code,code,stk_cd,Y,exchange_stock_code,,,,거래소별 종목코드
371
371
  kiwoomcli domestic stocks investor-by-stock-total,--from,from_date,strt_dt,Y,date_yyyymmdd,,,,시작일자 YYYYMMDD
372
372
  kiwoomcli domestic stocks investor-by-stock-total,--to,to_date,end_dt,Y,date_yyyymmdd,,,,종료일자 YYYYMMDD
373
- kiwoomcli domestic stocks investor-by-stock-total,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분
373
+ kiwoomcli domestic stocks investor-by-stock-total,--basis,basis,amt_qty_tp,Y,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분 (amount=백만원 고정; 수량 단위는 --unit)
374
374
  kiwoomcli domestic stocks investor-by-stock-total,--side,side,trde_tp,Y,market,net-buy,net-buy=0,,매매구분
375
- kiwoomcli domestic stocks investor-by-stock-total,--unit,unit,unit_tp,Y,market,thousand|share,thousand=1000;share=1,,단위구분
375
+ kiwoomcli domestic stocks investor-by-stock-total,--unit,unit,unit_tp,Y,market,thousand|share,thousand=1000;share=1,,수량 단위 (thousand=1000주; share=1주; --basis quantity에서만 적용)
376
376
  kiwoomcli domestic stocks today-previous-trades,--code,code,stk_cd,Y,exchange_stock_code,,,,거래소별 종목코드
377
377
  kiwoomcli domestic stocks today-previous-trades,--day,day,tdy_pred,Y,market,today|previous,today=1;previous=2,,당일/전일 구분
378
378
  kiwoomcli domestic stocks today-previous-trades,--interval-type,interval_type,tic_min,Y,market,tick|minute,tick=0;minute=1,,틱/분 구분
@@ -491,12 +491,12 @@ kiwoomcli domestic rankings same-net-trades,--to,to_date,end_dt,N,date_yyyymmdd,
491
491
  kiwoomcli domestic rankings same-net-trades,--market,market,mrkt_tp,Y,market,all|kospi|kosdaq,all=000;kospi=001;kosdaq=101,,시장구분
492
492
  kiwoomcli domestic rankings same-net-trades,--side,side,trde_tp,Y,market,net-buy|net-sell,net-buy=1;net-sell=2,,매매구분
493
493
  kiwoomcli domestic rankings same-net-trades,--basis,basis,sort_cnd,Y,market,quantity|amount,quantity=1;amount=2,,정렬조건
494
- kiwoomcli domestic rankings same-net-trades,--unit,unit,unit_tp,Y,market,share|thousand,share=1;thousand=1000,,단위구분
494
+ kiwoomcli domestic rankings same-net-trades,--unit,unit,unit_tp,Y,market,share|thousand,share=1;thousand=1000,,수량 단위 (share=1주; thousand=1000주)
495
495
  kiwoomcli domestic rankings same-net-trades,--exchange,exchange,stex_tp,Y,market,KRX|NXT|ALL,KRX=1;NXT=2;ALL=3,,거래소구분
496
496
  kiwoomcli domestic rankings investor-intraday,--side,side,trde_tp,Y,market,net-buy|net-sell,net-buy=1;net-sell=2,,매매구분
497
497
  kiwoomcli domestic rankings investor-intraday,--market,market,mrkt_tp,Y,market,all|kospi|kosdaq,all=000;kospi=001;kosdaq=101,,시장구분
498
498
  kiwoomcli domestic rankings investor-intraday,--investor,investor,orgn_tp,Y,market,foreign|foreign-broker|financial-investment|investment-trust|other-financial|bank|insurance|pension|state|other-corporate|institution,foreign=9000;foreign-broker=9100;financial-investment=1000;investment-trust=3000;other-financial=5000;bank=4000;insurance=2000;pension=6000;state=7000;other-corporate=7100;institution=9999,,기관구분
499
- kiwoomcli domestic rankings investor-intraday,--basis,basis,amt_qty_tp,N,market,amount|quantity,amount=1;quantity=2,,금액수량구분
499
+ kiwoomcli domestic rankings investor-intraday,--basis,basis,amt_qty_tp,N,market,amount|quantity,amount=1;quantity=2,,금액/수량 구분 (buy_qty/sel_qty/netprps_qty 단위가 amount=백만원/quantity=1주로 전환)
500
500
  kiwoomcli domestic rankings after-hours-change-rate,--market,market,mrkt_tp,Y,market,all|kospi|kosdaq,all=000;kospi=001;kosdaq=101,,시장구분
501
501
  kiwoomcli domestic rankings after-hours-change-rate,--sort,sort,sort_base,Y,market,rise-rate|rise-price|fall-rate|fall-price|flat,rise-rate=1;rise-price=2;fall-rate=3;fall-price=4;flat=5,,정렬기준
502
502
  kiwoomcli domestic rankings after-hours-change-rate,--stock-condition,stock_condition,stk_cnd,Y,market,all|exclude-managed|exclude-liquidation|exclude-preferred|exclude-managed-preferred|exclude-margin-100|only-margin-100|only-margin-50|only-margin-60|only-margin-40|only-margin-30|only-margin-20|exclude-etf|exclude-spac|exclude-etf-etn|exclude-etn,all=0;exclude-managed=1;exclude-liquidation=2;exclude-preferred=3;exclude-managed-preferred=4;exclude-margin-100=5;only-margin-100=6;only-margin-50=12;only-margin-60=13;only-margin-40=7;only-margin-30=8;only-margin-20=9;exclude-etf=14;exclude-spac=15;exclude-etf-etn=16;exclude-etn=17,,종목조건
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/output.py RENAMED
@@ -3,6 +3,7 @@
3
3
  from __future__ import annotations
4
4
 
5
5
  import json
6
+ import re
6
7
  from typing import Any, Iterable
7
8
 
8
9
  from kiwoom.core.types import KiwoomResponse
@@ -22,6 +23,9 @@ ACCOUNT_IDENTIFIER_FIELDS = frozenset(
22
23
  "acntno",
23
24
  "acnt_num",
24
25
  "cano",
26
+ # 계좌번호 출력용(kt50032/ust21100)과 계좌명(kt00004)도 식별자로 취급한다.
27
+ "acnt_print",
28
+ "acnt_nm",
25
29
  }
26
30
  )
27
31
  # Order numbers are operational identifiers the user needs to manage their own
@@ -117,12 +121,14 @@ def _redact_sensitive_value(value: Any) -> Any:
117
121
 
118
122
 
119
123
  def _redact_value(value: Any) -> Any:
124
+ # 숫자만 남겨 마스킹한다. "8984-2268-80 [예금주]"처럼 대괄호 실명이 붙어 오는
125
+ # 값에서 뒤 4글자 규칙을 그대로 쓰면 이름만 남으므로, 비숫자 문자는 전부 버린다.
120
126
  if value is None:
121
127
  return None
122
- text = str(value)
123
- if len(text) <= 4:
128
+ digits = re.sub(r"\D", "", str(value))
129
+ if len(digits) <= 4:
124
130
  return "****"
125
- return f"{'*' * (len(text) - 4)}{text[-4:]}"
131
+ return f"{'*' * (len(digits) - 4)}{digits[-4:]}"
126
132
 
127
133
 
128
134
  def _to_yaml(value: Any, *, indent: int = 0) -> str:
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/registry.py RENAMED
@@ -26,6 +26,7 @@ class CommandDefinition:
26
26
  method: str
27
27
  path: str
28
28
  required_body_fields: tuple[str, ...]
29
+ notes: str = ""
29
30
 
30
31
 
31
32
  def load_command_definitions(map_path: Path | None = None) -> list[CommandDefinition]:
@@ -88,6 +89,7 @@ def _definition_from_row(row: dict[str, str]) -> CommandDefinition:
88
89
  method=row["method"],
89
90
  path=row["path"],
90
91
  required_body_fields=_split_fields(row["required_body_fields"]),
92
+ notes=row.get("notes", ""),
91
93
  )
92
94
 
93
95
 
{kwcli-1.0.2 → kwcli-1.0.3}/pyproject.toml RENAMED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "kwcli"
3
- version = "1.0.2"
3
+ version = "1.0.3"
4
4
  description = "Kiwoom OpenAPI toolkit"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.13"
{kwcli-1.0.2 → kwcli-1.0.3}/LICENSE.md RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/__init__.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/__init__.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/auth.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/client.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/errors.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/profiles.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/runtime.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/secrets.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/settings.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/token_store.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/types.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/core/ws_client.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/__init__.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/decoders.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/events.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/packets.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/schemas.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/realtime/stream.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom/specs.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/README.md RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/__init__.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/__main__.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/argument_maps.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/arguments.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/auth_context.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/banner.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/commands/auth.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/doctor.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/errors.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/executor/rest.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/main.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/maps/README.md RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/safety.py RENAMED
File without changes
{kwcli-1.0.2 → kwcli-1.0.3}/kiwoom_cli/setup.py RENAMED
File without changes