@mulsok/traders-client 0.1.0

package/dist/server/broker/kiwoom/endpoints/investor.js

@@ -0,0 +1,139 @@
+/**
+ * 키움 기관/외국인 endpoints
+ *
+ *   - getForeignActivity(symbolCode)      · 주식외국인 종목별 매매동향 (ka10008)
+ *   - getInstitutionActivity(symbolCode)  · 주식기관 요청 (ka10009)
+ *   - getContinuousInvestorActivity(...)  · 기관외국인 연속매매 현황 (ka10131)
+ *
+ * 공식 스펙: PDF p.39 · p.42 · p.238
+ *   모두 POST /api/dostk/frgnistt
+ *
+ * 배경:
+ *   - 이전 구현에서 quote.ts 의 getInvestorActivity() 가 ka10101 (업종코드 리스트)
+ *     을 잘못 호출하던 버그 수정.
+ */
+import { kiwoomCall } from "../client.js";
+import { cacheOrFetch, TTL } from "../cache.js";
+export async function getForeignActivity(symbolCode, limit = 20) {
+    const cached = await cacheOrFetch(`investor:foreign:${symbolCode}:${limit}`, TTL.DAILY_CHART, // 60초
+    () => kiwoomCall({
+        path: "/api/dostk/frgnistt",
+        trId: "ka10008",
+        body: { stk_cd: symbolCode },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const arr = cached.value.data.stk_frgnr ?? [];
+    const items = arr.slice(0, limit).map((row) => ({
+        date: String(row.dt ?? ""),
+        closeKrw: Math.abs(toNum(row.close_pric)),
+        changeKrw: toNum(row.pred_pre),
+        volume: toNum(row.trde_qty),
+        changeQty: toNum(row.chg_qty),
+        possessedQty: toNum(row.poss_stkcnt),
+        weightPct: toNum(row.wght),
+        gainablePossQty: toNum(row.gain_pos_stkcnt),
+        foreignLimit: toNum(row.frgnr_limit),
+        foreignLimitChange: toNum(row.frgnr_limit_irds),
+        limitExhaustionPct: toNum(row.limit_exh_rt),
+        raw: row,
+    }));
+    return {
+        ok: true,
+        data: items,
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+export async function getInstitutionActivity(symbolCode) {
+    const cached = await cacheOrFetch(`investor:institution:${symbolCode}`, TTL.DAILY_CHART, () => kiwoomCall({
+        path: "/api/dostk/frgnistt",
+        trId: "ka10009",
+        body: { stk_cd: symbolCode },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    return {
+        ok: true,
+        data: {
+            symbolCode,
+            date: String(raw.date ?? ""),
+            closeKrw: Math.abs(toNum(raw.close_pric)),
+            changeKrw: toNum(raw.pre),
+            institutionCumulative: toNum(raw.orgn_dt_acc),
+            institutionDailyNet: toNum(raw.orgn_daly_nettrde),
+            foreignDailyNet: toNum(raw.frgnr_daly_nettrde),
+            foreignShareholdingPct: toNum(raw.frgnr_qota_rt),
+            raw,
+        },
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+const PERIOD_MAP = {
+    latest: "1",
+    d3: "3",
+    d5: "5",
+    d10: "10",
+    d20: "20",
+    d120: "120",
+    custom: "0",
+};
+export async function getContinuousInvestorActivity(opts = {}) {
+    const period = opts.period ?? "latest";
+    const market = opts.market ?? "kospi";
+    const amountOrQty = opts.amountOrQty ?? "amount";
+    const cacheKey = `investor:continuous:${period}:${market}:${amountOrQty}:${opts.startDate ?? ""}:${opts.endDate ?? ""}`;
+    const cached = await cacheOrFetch(cacheKey, TTL.RANKING, // 30s
+    () => kiwoomCall({
+        path: "/api/dostk/frgnistt",
+        trId: "ka10131",
+        body: {
+            dt: PERIOD_MAP[period],
+            strt_dt: opts.startDate ?? "",
+            end_dt: opts.endDate ?? "",
+            mrkt_tp: market === "kospi" ? "001" : "101",
+            netslmt_tp: "2", // 순매수(고정)
+            stk_inds_tp: "0", // 0:종목(주식)
+            amt_qty_tp: amountOrQty === "amount" ? "0" : "1",
+            stex_tp: "1", // KRX
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    const arr = raw.orgn_frgnr_cont_trde_prst ?? [];
+    const items = arr.map((row) => ({
+        rank: toNum(row.rank),
+        symbolCode: String(row.stk_cd ?? ""),
+        symbolName: String(row.stk_nm ?? ""),
+        periodChangePct: toNum(row.prid_stkpc_flu_rt),
+        institutionNetAmount: toNum(row.orgn_nettrde_amt),
+        institutionNetQty: toNum(row.orgn_nettrde_qty),
+        institutionContinuousDays: toNum(row.orgn_cont_netprps_dys),
+        institutionContinuousQty: toNum(row.orgn_cont_netprps_qty),
+        institutionContinuousAmount: toNum(row.orgn_cont_netprps_amt),
+        foreignNetQty: toNum(row.frgnr_nettrde_qty),
+        foreignNetAmount: toNum(row.frgnr_nettrde_amt),
+        foreignContinuousDays: toNum(row.frgnr_cont_netprps_dys),
+        foreignContinuousQty: toNum(row.frgnr_cont_netprps_qty),
+        foreignContinuousAmount: toNum(row.frgnr_cont_netprps_amt),
+        totalNetQty: toNum(row.nettrde_qty),
+        totalNetAmount: toNum(row.nettrde_amt),
+        raw: row,
+    }));
+    return {
+        ok: true,
+        data: items,
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+function toNum(v) {
+    if (typeof v === "number")
+        return v;
+    if (typeof v === "string") {
+        const n = Number(v.replace(/,/g, "").replace(/^\+/, ""));
+        return Number.isFinite(n) ? n : 0;
+    }
+    return 0;
+}
+//# sourceMappingURL=investor.js.map

package/dist/server/broker/kiwoom/endpoints/investor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"investor.js","sourceRoot":"","sources":["../../../../../src-server/broker/kiwoom/endpoints/investor.ts"],"names":[],"mappings":"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"}

package/dist/server/broker/kiwoom/endpoints/order.js

@@ -0,0 +1,134 @@
+/**
+ * 키움 주문 endpoints
+ *
+ *   - placeOrder()   · 매수 (kt10000) · 매도 (kt10001)
+ *   - modifyOrder()  · 정정 (kt10002) · Phase 2 stub
+ *   - cancelOrder()  · 취소 (kt10003) · Phase 2 stub
+ *
+ * 안전장치
+ *   - 주문 결과는 캐시하지 않음 (매번 호출)
+ *   - 주문 후 cache.cacheDeletePrefix("account:") 로 잔고/예수금 캐시 무효화
+ *   - 모의/실전 분기는 client.ts host 자동 처리
+ *   - 비즈니스 에러 (잔고 부족 · 호가 단위 위반 등) 는 KiwoomResult.error 로 전달
+ */
+import { kiwoomCall } from "../client.js";
+import { cacheDeletePrefix } from "../cache.js";
+import { pickNum, pickStr } from "./_helpers.js";
+export async function placeOrder(input) {
+    // 입력 검증
+    if (!input.symbolCode || input.quantity <= 0) {
+        return {
+            ok: false,
+            error: { kind: "schema", message: "symbolCode 또는 quantity 잘못됨" },
+        };
+    }
+    const type = input.type ?? "limit";
+    if (type === "limit" && (!input.priceKrw || input.priceKrw <= 0)) {
+        return {
+            ok: false,
+            error: { kind: "schema", message: "limit 주문은 priceKrw 필수" },
+        };
+    }
+    const trId = input.side === "buy" ? "kt10000" : "kt10001";
+    const path = input.side === "buy" ? "/api/dostk/ordr" : "/api/dostk/ordr";
+    const body = {
+        dmst_stex_tp: input.exchange ?? "KRX",
+        stk_cd: input.symbolCode,
+        ord_qty: String(input.quantity),
+        ord_uv: type === "market" ? "" : String(input.priceKrw ?? ""),
+        trde_tp: orderTypeCode(type),
+        cond_uv: "", // 조건 단가 (미사용)
+    };
+    const res = await kiwoomCall({
+        path,
+        trId,
+        body,
+    });
+    if (!res.ok)
+        return res;
+    // 잔고/예수금 캐시 무효화 (다음 조회 시 신선)
+    cacheDeletePrefix("account:");
+    const raw = res.data;
+    const result = {
+        orderNo: pickStr(raw, ["ord_no", "odno", "order_no"]),
+        status: "accepted", // kiwoomCall 에서 return_code === 0 통과한 상태
+        acceptedQty: pickNum(raw, ["ord_qty", "accepted_qty"]) || input.quantity,
+        message: pickStr(raw, ["return_msg", "msg"]) || "주문 접수",
+        raw,
+    };
+    return { ok: true, data: result, meta: res.meta };
+}
+export async function modifyOrder(input) {
+    if (!input.orderNo || input.newQuantity <= 0 || input.newPriceKrw <= 0) {
+        return { ok: false, error: { kind: "schema", message: "정정 주문 입력 누락" } };
+    }
+    const body = {
+        dmst_stex_tp: input.exchange ?? "KRX",
+        orig_ord_no: input.orderNo,
+        stk_cd: input.symbolCode,
+        mdfy_qty: String(input.newQuantity),
+        mdfy_uv: String(input.newPriceKrw),
+        mdfy_cond_uv: "",
+    };
+    const res = await kiwoomCall({
+        path: "/api/dostk/ordr",
+        trId: "kt10002",
+        body,
+    });
+    if (!res.ok)
+        return res;
+    cacheDeletePrefix("account:");
+    const raw = res.data;
+    return {
+        ok: true,
+        data: {
+            orderNo: pickStr(raw, ["ord_no", "odno"]) || input.orderNo,
+            status: "accepted",
+            acceptedQty: input.newQuantity,
+            message: pickStr(raw, ["return_msg", "msg"]) || "정정 접수",
+            raw,
+        },
+        meta: res.meta,
+    };
+}
+export async function cancelOrder(input) {
+    if (!input.orderNo) {
+        return { ok: false, error: { kind: "schema", message: "orderNo 필수" } };
+    }
+    const body = {
+        dmst_stex_tp: input.exchange ?? "KRX",
+        orig_ord_no: input.orderNo,
+        stk_cd: input.symbolCode,
+        cncl_qty: String(input.quantity ?? 0), // 0 = 전량
+    };
+    const res = await kiwoomCall({
+        path: "/api/dostk/ordr",
+        trId: "kt10003",
+        body,
+    });
+    if (!res.ok)
+        return res;
+    cacheDeletePrefix("account:");
+    const raw = res.data;
+    return {
+        ok: true,
+        data: {
+            orderNo: pickStr(raw, ["ord_no", "odno"]) || input.orderNo,
+            status: "accepted",
+            acceptedQty: input.quantity ?? 0,
+            message: pickStr(raw, ["return_msg", "msg"]) || "취소 접수",
+            raw,
+        },
+        meta: res.meta,
+    };
+}
+/* ─────────── helpers ─────────── */
+function orderTypeCode(type) {
+    switch (type) {
+        case "limit": return "0"; // 보통가
+        case "market": return "3"; // 시장가
+        case "best_limit": return "5"; // 최유리
+        default: return "0";
+    }
+}
+//# sourceMappingURL=order.js.map

package/dist/server/broker/kiwoom/endpoints/order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../../../../src-server/broker/kiwoom/endpoints/order.ts"],"names":[],"mappings":"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"}

package/dist/server/broker/kiwoom/endpoints/quote.js

@@ -0,0 +1,165 @@
+/**
+ * 키움 시세 endpoints
+ *
+ * 구현:
+ *   - getCurrentPrice(symbolCode)           · 주식 기본정보 (ka10001)
+ *   - getOrderbook(symbolCode)              · 호가 (ka10004)
+ *   - getDailyChart(symbolCode, days?)      · 일봉 (ka10005)
+ *   - getMinuteChart(symbolCode, intervalMin, count?) · 분봉 (ka10006)
+ *
+ * 캐시 정책 (cache.ts TTL):
+ *   - 현재가 1s · 호가 1s · 분봉 10s · 일봉 60s
+ */
+import { kiwoomCall } from "../client.js";
+import { cacheOrFetch, TTL } from "../cache.js";
+import { findFirstArray, pickNum, pickStr, ymd } from "./_helpers.js";
+export async function getCurrentPrice(symbolCode) {
+    const cached = await cacheOrFetch(`quote:current:${symbolCode}`, TTL.CURRENT_PRICE, () => kiwoomCall({
+        path: "/api/dostk/stkinfo",
+        trId: "ka10001",
+        body: { stk_cd: symbolCode },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    const data = {
+        symbolCode,
+        symbolName: pickStr(raw, ["stk_nm", "hts_kor_isnm"]),
+        currentPriceKrw: pickNum(raw, ["cur_prc", "stck_prpr"]),
+        changeKrw: pickNum(raw, ["pred_pre", "prdy_vrss"]),
+        changePct: pickNum(raw, ["flu_rt", "prdy_ctrt"]),
+        openKrw: pickNum(raw, ["open_pric", "stck_oprc"]),
+        highKrw: pickNum(raw, ["high_pric", "stck_hgpr"]),
+        lowKrw: pickNum(raw, ["low_pric", "stck_lwpr"]),
+        prevCloseKrw: pickNum(raw, ["pred_close_pric", "stck_sdpr"]),
+        volume: pickNum(raw, ["trde_qty", "acml_vol"]),
+        tradingValueKrw: pickNum(raw, ["trde_amt", "acml_tr_pbmn"]),
+        raw,
+    };
+    return { ok: true, data, meta: { ...cached.value.meta, cached: cached.cached } };
+}
+export async function getStockMeta(symbolCode) {
+    const cached = await cacheOrFetch(`quote:meta:${symbolCode}`, TTL.STOCK_INFO, // 1일
+    () => kiwoomCall({
+        path: "/api/dostk/stkinfo",
+        trId: "ka10100",
+        body: { stk_cd: symbolCode },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    // 관리종목 등 flag 매핑 · 키움 응답 키 추정 (실 응답으로 정정)
+    const adminFlag = pickStr(raw, ["mng_stk_yn", "mngs_yn"]);
+    const warningFlag = pickStr(raw, ["caut_stk_yn", "ivst_warn_yn"]);
+    const haltedFlag = pickStr(raw, ["trading_stop_yn", "halt_yn"]);
+    const marketRaw = pickStr(raw, ["mrkt_cd", "market_kor"]);
+    const productType = pickStr(raw, ["prdt_tp", "stk_kind"]);
+    const data = {
+        symbolCode,
+        symbolName: pickStr(raw, ["stk_nm", "hts_kor_isnm"]),
+        market: marketRaw.includes("KOSPI") || marketRaw === "001"
+            ? "KOSPI"
+            : marketRaw.includes("KOSDAQ") || marketRaw === "101"
+                ? "KOSDAQ"
+                : marketRaw.includes("KONEX")
+                    ? "KONEX"
+                    : productType === "ETF"
+                        ? "ETF"
+                        : "UNKNOWN",
+        isAdministrative: adminFlag === "Y" || adminFlag === "1",
+        isWarning: warningFlag === "Y" || warningFlag === "1",
+        isHalted: haltedFlag === "Y" || haltedFlag === "1",
+        isEtf: productType === "ETF",
+        raw,
+    };
+    return { ok: true, data, meta: { ...cached.value.meta, cached: cached.cached } };
+}
+export async function getOrderbook(symbolCode) {
+    const cached = await cacheOrFetch(`quote:orderbook:${symbolCode}`, TTL.ORDERBOOK, () => kiwoomCall({
+        path: "/api/dostk/mrkcond",
+        trId: "ka10004",
+        body: { stk_cd: symbolCode },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    const asks = [];
+    const bids = [];
+    for (let i = 1; i <= 10; i++) {
+        const aPrice = pickNum(raw, [`sel_${i}p`, `askp${i}`]);
+        const aQty = pickNum(raw, [`sel_${i}q`, `askp_rsqn${i}`]);
+        if (aPrice > 0)
+            asks.push({ priceKrw: aPrice, quantity: aQty });
+        const bPrice = pickNum(raw, [`buy_${i}p`, `bidp${i}`]);
+        const bQty = pickNum(raw, [`buy_${i}q`, `bidp_rsqn${i}`]);
+        if (bPrice > 0)
+            bids.push({ priceKrw: bPrice, quantity: bQty });
+    }
+    const data = {
+        symbolCode,
+        asks,
+        bids,
+        totalAskQty: asks.reduce((s, l) => s + l.quantity, 0),
+        totalBidQty: bids.reduce((s, l) => s + l.quantity, 0),
+        raw,
+    };
+    return { ok: true, data, meta: { ...cached.value.meta, cached: cached.cached } };
+}
+export async function getDailyChart(symbolCode, days = 60) {
+    const cached = await cacheOrFetch(`quote:daily:${symbolCode}:${days}`, TTL.DAILY_CHART, () => kiwoomCall({
+        path: "/api/dostk/chart",
+        trId: "ka10081", // 정정: 주식 일봉 차트 (구 ka10005 추정 오류)
+        body: {
+            stk_cd: symbolCode,
+            base_dt: ymd(new Date()),
+            upd_stkpc_tp: "1", // 1: 수정주가 사용
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    const arr = findFirstArray(raw) ?? [];
+    const candles = arr.slice(0, days).map((row) => ({
+        date: pickStr(row, ["dt", "stck_bsop_date"]),
+        openKrw: pickNum(row, ["open_pric", "stck_oprc"]),
+        highKrw: pickNum(row, ["high_pric", "stck_hgpr"]),
+        lowKrw: pickNum(row, ["low_pric", "stck_lwpr"]),
+        closeKrw: pickNum(row, ["cur_prc", "close_pric", "stck_clpr"]),
+        volume: pickNum(row, ["trde_qty", "acml_vol"]),
+    }));
+    return {
+        ok: true,
+        data: { symbolCode, candles },
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+export async function getMinuteChart(symbolCode, intervalMin = 5, count = 100) {
+    const cached = await cacheOrFetch(`quote:minute:${symbolCode}:${intervalMin}:${count}`, TTL.MINUTE_CHART, () => kiwoomCall({
+        path: "/api/dostk/chart",
+        trId: "ka10080", // 정정: 주식 분봉 차트 (구 ka10006 추정 오류)
+        body: {
+            stk_cd: symbolCode,
+            tic_scope: String(intervalMin),
+            upd_stkpc_tp: "1",
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    const arr = findFirstArray(raw) ?? [];
+    const candles = arr.slice(0, count).map((row) => ({
+        date: pickStr(row, ["cntr_tm", "stck_bsop_date"]),
+        openKrw: pickNum(row, ["open_pric", "stck_oprc"]),
+        highKrw: pickNum(row, ["high_pric", "stck_hgpr"]),
+        lowKrw: pickNum(row, ["low_pric", "stck_lwpr"]),
+        closeKrw: pickNum(row, ["cur_prc", "close_pric", "stck_clpr"]),
+        volume: pickNum(row, ["trde_qty", "cntr_qty"]),
+    }));
+    return {
+        ok: true,
+        data: { symbolCode, intervalMin, candles },
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+// helpers: ./_helpers.ts (findFirstArray · pickNum · pickStr · ymd)
+//# sourceMappingURL=quote.js.map

package/dist/server/broker/kiwoom/endpoints/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../../../../src-server/broker/kiwoom/endpoints/quote.ts"],"names":[],"mappings":"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"}

package/dist/server/broker/kiwoom/endpoints/ranking.js

@@ -0,0 +1,180 @@
+/**
+ * 키움 랭킹 endpoints (Phase 2 · 종목 발굴)
+ *
+ *   - getVolumeRanking()  · 당일 거래량 상위 (ka10030)
+ *   - getChangeRanking()  · 전일대비 등락률 상위 (ka10027)
+ *
+ * Reference: KiwoomRestApi.Net (github.com/dongbin300/KiwoomRestApi.Net)
+ *   - path: /api/dostk/rkinfo
+ *   - 모든 enum 값 검증된 spec
+ */
+import { kiwoomCall } from "../client.js";
+import { cacheOrFetch, TTL } from "../cache.js";
+import { findFirstArray, pickNum, pickStr } from "./_helpers.js";
+/* enum codes (검증된 키움 spec)
+ *   mrkt_tp:  0=전체 · 1=코스피 · 101=코스닥
+ *   stex_tp:  1=KRX · 2=NXT · 3=통합
+ *   stk_cnd:  0=전체 · 1=관리종목제외 · 14=ETF제외 · 16=ETF+ETN제외 · 20=ETF+ETN+스팩제외
+ *   crd_cnd:  0=전체 · 9=신용융자전체
+ *   pric_cnd: 0=전체 · 5=1만원이상 · 8=1천원이상 · 10=1만원미만
+ *   trde_qty_cnd: 천주 단위 (50 = 5만주 이상)
+ *   trde_prica_cnd: 천만원 단위 (10 = 1억원 이상)
+ */
+function marketCode(m) {
+    return m === "kospi" ? "1" : m === "kosdaq" ? "101" : "0";
+}
+/**
+ * 당일 거래량 상위 (ka10030)
+ *
+ * @param market all/kospi/kosdaq · 기본 all
+ * @param limit  상위 N · 기본 50 (응답 max ~100)
+ */
+export async function getVolumeRanking(market = "all", limit = 50) {
+    const cached = await cacheOrFetch(`ranking:volume:${market}:${limit}`, TTL.RANKING, () => kiwoomCall({
+        path: "/api/dostk/rkinfo",
+        trId: "ka10030",
+        body: {
+            mrkt_tp: marketCode(market),
+            sort_tp: "1", // 1=거래량 · 2=거래회전율 · 3=거래대금
+            mang_stk_incls: "1", // 1=관리종목 제외
+            crd_tp: "0", // 0=전체
+            trde_qty_tp: "5", // 5=5만주 이상
+            pric_tp: "0", // 0=전체 (가격 무관)
+            trde_prica_tp: "0", // 0=전체 (거래대금 무관)
+            mrkt_open_tp: "0", // 0=전체
+            stex_tp: "1", // 1=KRX
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const items = parseRanking(cached.value.data, limit);
+    return { ok: true, data: items, meta: { ...cached.value.meta, cached: cached.cached } };
+}
+/**
+ * 전일대비 등락률 상위 (ka10027)
+ *
+ * @param direction "up" 상승률 · "down" 하락률
+ */
+export async function getChangeRanking(direction = "up", market = "all", limit = 50) {
+    const cached = await cacheOrFetch(`ranking:change:${direction}:${market}:${limit}`, TTL.RANKING, () => kiwoomCall({
+        path: "/api/dostk/rkinfo",
+        trId: "ka10027",
+        body: {
+            mrkt_tp: marketCode(market),
+            sort_tp: direction === "up" ? "1" : "3", // 1=상승률 · 3=하락률
+            trde_qty_cnd: "10", // 10=1만주 이상
+            stk_cnd: "1", // 1=관리종목 제외
+            crd_cnd: "0", // 0=전체
+            updown_incls: "1", // 1=상한/하한 포함
+            pric_cnd: "8", // 8=1천원이상
+            trde_prica_cnd: "0", // 0=전체
+            stex_tp: "1", // 1=KRX
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const items = parseRanking(cached.value.data, limit);
+    return { ok: true, data: items, meta: { ...cached.value.meta, cached: cached.cached } };
+}
+function parseRanking(raw, limit) {
+    const arr = findFirstArray(raw) ?? [];
+    return arr.slice(0, limit).map((row, i) => ({
+        rank: pickNum(row, ["rank", "rnk"]) || i + 1,
+        symbolCode: pickStr(row, ["stk_cd", "pdno"]),
+        symbolName: pickStr(row, ["stk_nm", "hts_kor_isnm"]),
+        currentPriceKrw: pickNum(row, ["cur_prc", "now_trde_qty"]),
+        changePct: pickNum(row, ["flu_rt", "prdy_ctrt"]),
+        volume: pickNum(row, ["trde_qty", "now_trde_qty", "acml_vol"]),
+        tradingValueKrw: pickNum(row, ["trde_amt", "trde_prica", "acml_tr_pbmn"]),
+        raw: row,
+    }));
+}
+/**
+ * 거래량이 이전 대비 급증한 종목.
+ *
+ * 용도:
+ *   - 이슈 발생 · 대량 자금 유입 후보 포착
+ *   - 페르소나 (예: 모멘텀 추종) 스크리너의 1차 후보 풀
+ */
+export async function getVolumeSurgeRanking(opts = {}) {
+    const { market = "all", sort = "surgeQty", timeBasis = "yesterday", minuteWindow = "", minVolume = "5", stockCondition = "1", priceCondition = "0", limit = 50, } = opts;
+    const sortTp = sort === "surgeQty" ? "1" : sort === "surgeRate" ? "2" : sort === "dropQty" ? "3" : "4";
+    const tmTp = timeBasis === "minute" ? "1" : "2";
+    const mrktTp = market === "kospi" ? "001" : market === "kosdaq" ? "101" : "000";
+    const cached = await cacheOrFetch(`ranking:volume-surge:${market}:${sort}:${timeBasis}:${minuteWindow}:${minVolume}:${stockCondition}:${priceCondition}`, TTL.RANKING, () => kiwoomCall({
+        path: "/api/dostk/rkinfo",
+        trId: "ka10023",
+        body: {
+            mrkt_tp: mrktTp,
+            sort_tp: sortTp,
+            tm_tp: tmTp,
+            trde_qty_tp: minVolume,
+            tm: minuteWindow,
+            stk_cnd: stockCondition,
+            pric_tp: priceCondition,
+            stex_tp: "1", // KRX
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const arr = cached.value.data.trde_qty_sdnin ?? [];
+    const items = arr.slice(0, limit).map((row) => ({
+        symbolCode: String(row.stk_cd ?? ""),
+        symbolName: String(row.stk_nm ?? ""),
+        currentPriceKrw: Math.abs(toNumLocal(row.cur_prc)),
+        changePct: toNumLocal(row.flu_rt),
+        previousVolume: toNumLocal(row.prev_trde_qty),
+        currentVolume: toNumLocal(row.now_trde_qty),
+        surgeQty: toNumLocal(row.sdnin_qty),
+        surgeRate: toNumLocal(row.sdnin_rt),
+        raw: row,
+    }));
+    return {
+        ok: true,
+        data: items,
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+export async function getYesterdayVolumeRanking(opts = {}) {
+    const { market = "all", kind = "volume", rankStart = 0, rankEnd = 100, } = opts;
+    const mrktTp = market === "kospi" ? "001" : market === "kosdaq" ? "101" : "000";
+    const qryTp = kind === "volume" ? "1" : "2";
+    const cached = await cacheOrFetch(`ranking:yesterday:${market}:${kind}:${rankStart}:${rankEnd}`, TTL.RANKING, () => kiwoomCall({
+        path: "/api/dostk/rkinfo",
+        trId: "ka10031",
+        body: {
+            mrkt_tp: mrktTp,
+            qry_tp: qryTp,
+            rank_strt: String(rankStart),
+            rank_end: String(rankEnd),
+            stex_tp: "1", // KRX
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const arr = cached.value.data.pred_trde_qty_upper ?? [];
+    const items = arr.map((row) => ({
+        symbolCode: String(row.stk_cd ?? ""),
+        symbolName: String(row.stk_nm ?? ""),
+        currentPriceKrw: Math.abs(toNumLocal(row.cur_prc)),
+        changeKrw: toNumLocal(row.pred_pre),
+        volume: toNumLocal(row.trde_qty),
+        raw: row,
+    }));
+    return {
+        ok: true,
+        data: items,
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+function toNumLocal(v) {
+    if (typeof v === "number")
+        return v;
+    if (typeof v === "string") {
+        const n = Number(v.replace(/,/g, "").replace(/^\+/, ""));
+        return Number.isFinite(n) ? n : 0;
+    }
+    return 0;
+}
+// helpers: ./_helpers.ts (findFirstArray · pickNum · pickStr)
+//# sourceMappingURL=ranking.js.map