@2oolkit/kiwoom-cli 0.1.0 → 0.1.1

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.
@@ -37,22 +37,29 @@ kiwoom-cli market inst-foreign 005930 -s 20260601 -e 20260622 # ka10045
37
37
 
38
38
  ## Charts
39
39
 
40
- | Timeframe | Command | TR | Scope option |
41
- |---|---|---|---|
42
- | Tick | `chart tick <code> -s <n>` | ka10079 | ticks 1/3/5/10/30 |
43
- | Minute | `chart min <code> -i <n>` | ka10080 | minutes 1/3/5/10/15/30/45/60 |
44
- | Daily | `chart day <code> -d <YYYYMMDD>` | ka10081 | base date |
45
- | Weekly | `chart week <code>` | ka10082 | base date |
46
- | Monthly | `chart month <code>` | ka10083 | base date |
47
- | Yearly | `chart year <code>` | ka10094 | base date |
48
-
49
- Common: `-n <count>` caps displayed rows (default 50); `--raw` returns unadjusted prices
50
- (`upd_stkpc_tp=0`). Charts are returned latest-first. Item time fields: `cntr_tm`
51
- (tick/minute, YYYYMMDDHHMMSS) or `dt` (period, YYYYMMDD).
40
+ | Timeframe | Command | TR | Scope option | Per-request max |
41
+ |---|---|---|---|---|
42
+ | Tick | `chart tick <code> -s <n>` | ka10079 | ticks 1/3/5/10/30 | 900 |
43
+ | Minute | `chart min <code> -i <n>` | ka10080 | minutes 1/3/5/10/15/30/45/60 | 900 |
44
+ | Daily | `chart day <code> -d <YYYYMMDD>` | ka10081 | base date | 600 |
45
+ | Weekly | `chart week <code>` | ka10082 | base date | 300 |
46
+ | Monthly | `chart month <code>` | ka10083 | base date | 240 |
47
+ | Yearly | `chart year <code>` | ka10094 | base date | 30 |
48
+
49
+ Common: `-n <count>` sets how many candles to return (default 50); `--raw` returns unadjusted
50
+ prices (`upd_stkpc_tp=0`); `-p, --paginate` forces multi-page fetch. Charts are returned
51
+ latest-first. Item time fields: `cntr_tm` (tick/minute, YYYYMMDDHHMMSS) or `dt` (period, YYYYMMDD).
52
+
53
+ **Max bars & auto-pagination**: a single request returns up to the per-request max above. When
54
+ `-n/--count` exceeds that cap, the CLI auto-paginates over the API's `cont-yn` / `next-key`
55
+ headers (repeating the same body) until the count is reached or data runs out, then slices to
56
+ exactly `--count`. `--count` must be a positive integer and is clamped to 100,000.
52
57
 
53
58
  ```bash
54
59
  kiwoom-cli chart min 005930 -i 5 -n 30 -o json
55
- kiwoom-cli chart day 005930 -n 60
60
+ kiwoom-cli chart day 005930 -n 600 # one full page (max)
61
+ kiwoom-cli chart day 005930 -n 2000 -o json # auto-paginates → ~2000 bars
62
+ kiwoom-cli chart min 005930 -i 1 -n 2000 -o json # 1-min bars, multiple pages
56
63
  ```
57
64
 
58
65
  ## Rankings