@2oolkit/kiwoom-cli 0.1.1 → 0.1.2

package/README.md

@@ -147,6 +147,7 @@ kiwoom-cli ranking volume                 당일 거래량 상위 (ka10030)
 kiwoom-cli ranking amount                 거래대금 상위 (ka10032)
 kiwoom-cli ranking surge                  거래량 급증 (ka10023)
 kiwoom-cli ranking prev-volume            전일 거래량 상위 (ka10031)
+kiwoom-cli ranking net-buy [옵션]         수급: 외국인·기관 순매수 상위 (ka90009)
 
 kiwoom-cli sector price [-m -c]   업종 현재가 (ka20001)
 kiwoom-cli sector stocks          업종 구성종목 (ka20002)
@@ -156,6 +157,9 @@ kiwoom-cli sector codes           업종 코드 목록 (ka10101)
 ```
 순위: `-m 000=전체/001=코스피/101=코스닥`, `-x 1=KRX/2=NXT/3=통합`.
 
+수급(`net-buy`, alias `supply`)은 한 번의 ka90009 호출로 외국인·기관 매매상위를 함께 반환합니다:
+`-b foreign|institution|both`(기본 both), `--side buy|sell`(기본 buy=순매수), `-n <1-50>`(기본 10), `-q 1=금액/2=수량`(기본 1), `-d YYYYMMDD`(기본 최신). 예: `kiwoom-cli ranking net-buy -b both -n 10`.
+
 ### `order` — ⚠ `real`에서는 실제 자금
 ```
 kiwoom-cli order buy  <코드> <수량> [-p 가격] [-t 유형] [-x KRX|NXT|SOR] [--credit] [-y]
@@ -194,7 +198,7 @@ kiwoom-cli order cancel 0000139 005930      # 잔량 전부 취소
 }
 ```
 
-도구: `get_stock_info`, `get_price`, `get_orderbook`, `get_daily_price`, `get_recent_trades`, `search_stocks`, `get_chart`, `get_balance`, `get_deposit`, `get_open_orders`, `get_executions`, `get_realized_pnl`, `get_ranking`, `get_sector`, `place_order`, `modify_order`, `cancel_order`.
+도구: `get_stock_info`, `get_price`, `get_orderbook`, `get_daily_price`, `get_recent_trades`, `search_stocks`, `get_chart`, `get_balance`, `get_deposit`, `get_open_orders`, `get_executions`, `get_realized_pnl`, `get_ranking`, `get_net_buy_ranking`, `get_sector`, `place_order`, `modify_order`, `cancel_order`.
 
 주문 도구는 **`confirm: true`를 넘기지 않으면 미리보기만 반환하고 아무것도 실행하지 않습니다** — 에이전트가 실수로 실주문을 낼 수 없습니다.
 

package/dist/index.js

@@ -851,6 +851,7 @@ var ENDPOINTS = {
   rankTradeAmount: { apiId: "ka10032", path: PATHS.rkinfo, korean: "\uAC70\uB798\uB300\uAE08\uC0C1\uC704\uC694\uCCAD", listKey: "trde_prica_upper" },
   rankVolumeSurge: { apiId: "ka10023", path: PATHS.rkinfo, korean: "\uAC70\uB798\uB7C9\uAE09\uC99D\uC694\uCCAD", listKey: "trde_qty_sdnin" },
   rankPrevVolume: { apiId: "ka10031", path: PATHS.rkinfo, korean: "\uC804\uC77C\uAC70\uB798\uB7C9\uC0C1\uC704\uC694\uCCAD", listKey: "pred_trde_qty_upper" },
+  rankForeignInst: { apiId: "ka90009", path: PATHS.rkinfo, korean: "\uC678\uAD6D\uC778\uAE30\uAD00\uB9E4\uB9E4\uC0C1\uC704\uC694\uCCAD", listKey: "frgnr_orgn_trde_upper" },
   // ── Sector / industry (업종) ───────────────────────────────────────────────
   sectorPrice: { apiId: "ka20001", path: PATHS.sect, korean: "\uC5C5\uC885\uD604\uC7AC\uAC00\uC694\uCCAD", listKey: "inds_cur_prc_tm" },
   sectorStocks: { apiId: "ka20002", path: PATHS.sect, korean: "\uC5C5\uC885\uBCC4\uC8FC\uAC00\uC694\uCCAD", listKey: "inds_stkpc" },
@@ -1788,6 +1789,21 @@ ${side.toUpperCase()} ${credit ? "(credit) " : ""}${stk}  qty ${qty}  ${priceLab
   await submit(def, body, options);
 }
 
+// src/utils/ranking.ts
+var NETTRADE_FIELDS = {
+  foreign: { buy: "for_netprps", sell: "for_netslmt" },
+  institution: { buy: "orgn_netprps", sell: "orgn_netslmt" }
+};
+function extractNetTrade(rows, prefix, n) {
+  return rows.slice(0, n).map((r, i) => ({
+    rank: i + 1,
+    code: r[`${prefix}_stk_cd`],
+    name: r[`${prefix}_stk_nm`],
+    \uAE08\uC561: won(unpad(r[`${prefix}_amt`] ?? "")),
+    \uC218\uB7C9: won(unpad(r[`${prefix}_qty`] ?? ""))
+  })).filter((x) => x.code);
+}
+
 // src/commands/ranking.ts
 function formatRankRow(row) {
   return formatFields(row, {
@@ -1889,6 +1905,45 @@ function registerRankingCommands(program2) {
       handleError(err);
     }
   });
+  ranking.command("net-buy").alias("supply").description("Foreign/institution net-buy \uC218\uAE09 ranking (ka90009)").option("-b, --by <foreign|institution|both>", "Investor: foreign=\uC678\uAD6D\uC778, institution=\uAE30\uAD00, both", "both").option("--side <buy|sell>", "buy=\uC21C\uB9E4\uC218, sell=\uC21C\uB9E4\uB3C4", "buy").option("-m, --market <000|001|101>", "Market: 000=all, 001=KOSPI, 101=KOSDAQ", "000").option("-x, --exchange <1|2|3>", "Exchange: 1=KRX, 2=NXT, 3=unified", "1").option("-n, --count <n>", "Top N (1-50)", "10").option("-q, --rank-by <1|2>", "Rank by 1=amount(\uAE08\uC561), 2=quantity(\uC218\uB7C9)", "1").option("-d, --date <YYYYMMDD>", "Query date (default: latest)").option("-o, --output <format>", "Output format (table/json)", "table").action(async (options) => {
+    try {
+      const side = options.side === "sell" ? "sell" : "buy";
+      const by = ["foreign", "institution", "both"].includes(options.by) ? options.by : "both";
+      const investors = by === "both" ? ["foreign", "institution"] : [by];
+      const n = Math.min(Math.max(parseInt(String(options.count), 10) || 10, 1), 50);
+      const client = createClient();
+      const { data } = await client.callEndpoint(ENDPOINTS.rankForeignInst, {
+        mrkt_tp: options.market,
+        amt_qty_tp: options.rankBy === "2" ? "2" : "1",
+        qry_dt_tp: options.date ? "1" : "0",
+        date: options.date || "",
+        stex_tp: options.exchange
+      });
+      const rows = Array.isArray(data?.[ENDPOINTS.rankForeignInst.listKey]) ? data[ENDPOINTS.rankForeignInst.listKey] : [];
+      const fmt = getOutputFormat(options);
+      const sideKo = side === "buy" ? "\uC21C\uB9E4\uC218" : "\uC21C\uB9E4\uB3C4";
+      const labelKo = { foreign: "\uC678\uAD6D\uC778", institution: "\uAE30\uAD00" };
+      if (fmt === "json") {
+        const result = {
+          side,
+          rankBy: options.rankBy === "2" ? "quantity" : "amount"
+        };
+        for (const inv of investors) {
+          result[inv] = extractNetTrade(rows, NETTRADE_FIELDS[inv][side], n);
+        }
+        output(result, "json");
+        return;
+      }
+      for (const inv of investors) {
+        const list = extractNetTrade(rows, NETTRADE_FIELDS[inv][side], n);
+        console.log(`
+${labelKo[inv]} ${sideKo} TOP${n} (${options.rankBy === "2" ? "\uC218\uB7C9" : "\uAE08\uC561"} \uAE30\uC900)`);
+        output(list, "table");
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
 }
 
 // src/commands/sector.ts