@mulsok/traders-client 0.1.0

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

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

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

@@ -0,0 +1,135 @@
+/**
+ * 키움 업종·지수 endpoints
+ *
+ *   - getMarketIndex(market)        · 전업종지수 (ka20003) · KOSPI/KOSDAQ 종합지수
+ *   - getAllSectorIndices(market)   · 전업종지수 전체 목록 (ka20003) · 대형주·중형주·업종별 전체
+ *   - getSectorCodes(market)        · 업종코드 리스트 (ka10101)
+ *
+ * 공식 스펙:
+ *   ka20003 · POST /api/dostk/sect · Body: { inds_cd }
+ *   ka10101 · POST /api/dostk/stkinfo · Body: { mrkt_tp }
+ *
+ * 배경:
+ *   - 이전 구현에서 ka20001 (업종현재가) 을 KOSPI/KOSDAQ 종합지수로 잘못 사용했던 버그 수정
+ *   - ka20003 은 한 번 호출로 "종합지수 + 대형주/중형주/소형주 + 업종별" 을 모두 반환
+ */
+import { kiwoomCall } from "../client.js";
+import { cacheOrFetch, TTL } from "../cache.js";
+/**
+ * 시장 종합지수 (KOSPI / KOSDAQ).
+ *
+ * ka20003 응답의 all_inds_idex[] 첫 항목 = 종합지수.
+ */
+export async function getMarketIndex(market) {
+    const sectors = await getAllSectorIndices(market);
+    if (!sectors.ok)
+        return sectors;
+    const comp = sectors.data[0];
+    if (!comp) {
+        return {
+            ok: false,
+            error: { kind: "schema", message: "전업종지수 응답에 종합지수 없음" },
+        };
+    }
+    return {
+        ok: true,
+        data: {
+            market,
+            currentValue: comp.currentValue,
+            changeValue: comp.changeValue,
+            changePct: comp.changePct,
+            volume: comp.volume,
+            tradingValueKrw: comp.tradingValueKrw,
+            risingCount: comp.risingCount,
+            stableCount: comp.stableCount,
+            fallingCount: comp.fallingCount,
+            listedStockCount: comp.listedStockCount,
+            raw: comp.raw,
+        },
+        meta: sectors.meta,
+    };
+}
+/**
+ * 전업종지수 전체 (종합 + 대형주 + 중형주 + 소형주 + 업종별).
+ *
+ * @param market kospi → inds_cd="001" · kosdaq → "101"
+ */
+export async function getAllSectorIndices(market) {
+    const indsCd = market === "kospi" ? "001" : "101";
+    const cached = await cacheOrFetch(`sector:all:${market}`, TTL.CURRENT_PRICE, // 지수는 실시간성 중요 · 1s
+    () => kiwoomCall({
+        path: "/api/dostk/sect",
+        trId: "ka20003",
+        body: { inds_cd: indsCd },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    const arr = raw.all_inds_idex ?? [];
+    const data = arr.map((row) => ({
+        code: String(row.stk_cd ?? ""),
+        name: String(row.stk_nm ?? ""),
+        // 키움은 cur_prc 에 "-6475.63" 처럼 "등락 방향 부호 + 절대값" 을 담음.
+        // 실제 지수 값은 항상 양수이므로 절대값으로 정규화. 등락 방향은 pre_sig 참조.
+        currentValue: Math.abs(toNum(row.cur_prc)),
+        changeValue: toNum(row.pred_pre),
+        changePct: toNum(row.flu_rt),
+        volume: toNum(row.trde_qty),
+        tradingValueKrw: toNum(row.trde_prica),
+        risingCount: toNum(row.rising),
+        stableCount: toNum(row.stdns),
+        fallingCount: toNum(row.fall),
+        listedStockCount: toNum(row.flo_stk_num),
+        raw: row,
+    }));
+    return {
+        ok: true,
+        data,
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+/**
+ * 업종코드 리스트 (ka10101).
+ *
+ * 주의: 이전 구현에서 이 TR 을 "외국인/기관 순매수" 로 잘못 사용했음. 현재는
+ *       올바르게 "업종코드" 로 수정.
+ */
+export async function getSectorCodes(marketKind = "kospi") {
+    // 0:코스피(거래소) · 1:코스닥 · 2:KOSPI200 · 4:KOSPI100 · 7:KRX100(통합지수)
+    const mrktTp = marketKind === "kospi" ? "0"
+        : marketKind === "kosdaq" ? "1"
+            : marketKind === "kospi200" ? "2"
+                : marketKind === "kospi100" ? "4"
+                    : "7";
+    const cached = await cacheOrFetch(`sector:codes:${marketKind}`, TTL.STOCK_INFO, // 업종코드는 거의 불변 · 1일
+    () => kiwoomCall({
+        path: "/api/dostk/stkinfo",
+        trId: "ka10101",
+        body: { mrkt_tp: mrktTp },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const arr = cached.value.data.list ?? [];
+    const data = arr.map((row) => ({
+        marketCode: String(row.marketCode ?? ""),
+        code: String(row.code ?? ""),
+        name: String(row.name ?? ""),
+        group: String(row.group ?? ""),
+        raw: row,
+    }));
+    return {
+        ok: true,
+        data,
+        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=sector.js.map

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

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

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

@@ -0,0 +1,104 @@
+/**
+ * 키움 테마 endpoints
+ *
+ *   - listThemeGroups(opts)              · 테마그룹별 (ka90001)
+ *   - getThemeMembers(themeGroupCode)    · 테마구성종목 (ka90002)
+ *
+ * 공식 스펙: PDF p.346 · p.348
+ *   모두 POST /api/dostk/thme
+ *
+ * 용도:
+ *   - 페르소나가 특정 테마 (예: "AI", "2차전지") 구성종목만 대상으로 스크리닝
+ *   - 핫 테마 탐지 (등락률 상위 테마그룹 → 구성종목 연쇄 조회)
+ */
+import { kiwoomCall } from "../client.js";
+import { cacheOrFetch, TTL } from "../cache.js";
+export async function listThemeGroups(opts = {}) {
+    const { queryKind = "all", symbolCode = "", daysAgo = 10, themeName = "", sort = "topReturn", } = opts;
+    const qryTp = queryKind === "all" ? "0" : queryKind === "theme" ? "1" : "2";
+    const sortCd = sort === "topReturn" ? "1"
+        : sort === "bottomReturn" ? "2"
+            : sort === "topChange" ? "3"
+                : "4";
+    const cached = await cacheOrFetch(`theme:groups:${queryKind}:${symbolCode}:${daysAgo}:${themeName}:${sort}`, TTL.RANKING, () => kiwoomCall({
+        path: "/api/dostk/thme",
+        trId: "ka90001",
+        body: {
+            qry_tp: qryTp,
+            stk_cd: symbolCode,
+            date_tp: String(daysAgo),
+            thema_nm: themeName,
+            flu_pl_amt_tp: sortCd,
+            stex_tp: "1", // KRX
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const arr = cached.value.data.thema_grp ?? [];
+    const items = arr.map((row) => ({
+        groupCode: String(row.thema_grp_cd ?? ""),
+        name: String(row.thema_nm ?? ""),
+        stockCount: toNum(row.stk_num),
+        changeSign: String(row.flu_sig ?? ""),
+        changeRatePct: toNum(row.flu_rt),
+        risingCount: toNum(row.rising_stk_num),
+        fallingCount: toNum(row.fall_stk_num),
+        periodReturnPct: toNum(row.dt_prft_rt),
+        mainStocks: String(row.main_stk ?? ""),
+        raw: row,
+    }));
+    return {
+        ok: true,
+        data: items,
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+export async function getThemeMembers(themeGroupCode, daysAgo = 10) {
+    const cached = await cacheOrFetch(`theme:members:${themeGroupCode}:${daysAgo}`, TTL.RANKING, () => kiwoomCall({
+        path: "/api/dostk/thme",
+        trId: "ka90002",
+        body: {
+            date_tp: String(daysAgo),
+            thema_grp_cd: themeGroupCode,
+            stex_tp: "1", // KRX
+        },
+    }));
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    const arr = raw.thema_comp_stk ?? [];
+    const members = arr.map((row) => ({
+        symbolCode: String(row.stk_cd ?? ""),
+        symbolName: String(row.stk_nm ?? ""),
+        currentPriceKrw: Math.abs(toNum(row.cur_prc)),
+        changeSign: String(row.flu_sig ?? ""),
+        changeKrw: toNum(row.pred_pre),
+        changePct: toNum(row.flu_rt),
+        accumulatedVolume: toNum(row.acc_trde_qty),
+        bestAskPriceKrw: toNum(row.sel_bid),
+        bestAskQty: toNum(row.sel_req),
+        bestBidPriceKrw: toNum(row.buy_bid),
+        bestBidQty: toNum(row.buy_req),
+        periodReturnPct: toNum(row.dt_prft_rt_n),
+        raw: row,
+    }));
+    return {
+        ok: true,
+        data: {
+            members,
+            groupAverageChangePct: toNum(raw.flu_rt),
+            groupAveragePeriodReturnPct: toNum(raw.dt_prft_rt),
+        },
+        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=theme.js.map

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

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

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

@@ -0,0 +1,119 @@
+/**
+ * 키움 종목 유니버스 endpoints
+ *
+ *   - getStockUniverse(market)   · 종목정보 리스트 (ka10099)
+ *
+ * 공식 스펙: 키움 REST API 문서 PDF p.229
+ *   POST https://api.kiwoom.com/api/dostk/stkinfo
+ *   Body: { mrkt_tp: "0" (KOSPI) | "10" (KOSDAQ) | ... }
+ *
+ * 용도:
+ *   - 전종목 유니버스 시드 (일 1회 배치 · 로컬 SQLite 캐시)
+ *   - listCount (상장주식수) 로 "유통물량 대비 거래량 %" 조건 계산
+ *   - 관리종목·정리매매·투자유의 필터 (state · orderWarning)
+ *
+ * 주의: 응답 list[] 에는 같은 code 가 여러 번 등장할 수 있음 (상장 이벤트 히스토리).
+ *       최신 (auditInfo="정상" 우선 또는 마지막 항목) 1개만 채택.
+ */
+import { kiwoomCall } from "../client.js";
+import { cacheOrFetch, TTL } from "../cache.js";
+const MRKT_TP_MAP = {
+    kospi: "0",
+    kosdaq: "10",
+    kotc: "30",
+    konex: "50",
+    etn: "60",
+    gold: "80",
+    elw: "3",
+    etf: "8",
+};
+/**
+ * 시장별 전종목 유니버스 조회.
+ *
+ * @param market 시장 구분 (기본 kospi)
+ * @returns code / name / listCount / state / ... 배열
+ *
+ * 캐시: 1일 (장 마감 후 배치 권장)
+ *
+ * 중복 code 제거: 최근 항목(마지막) 우선 채택.
+ */
+export async function getStockUniverse(market = "kospi") {
+    const mrktTp = MRKT_TP_MAP[market];
+    const cached = await cacheOrFetch(`universe:${market}`, TTL.STOCK_INFO, // 1일
+    async () => {
+        const res = await kiwoomCall({
+            path: "/api/dostk/stkinfo",
+            trId: "ka10099",
+            body: { mrkt_tp: mrktTp },
+        });
+        return res;
+    });
+    if (!cached.value.ok)
+        return cached.value;
+    const raw = cached.value.data;
+    const arr = raw.list ?? [];
+    // 중복 code 제거 (나중 항목 우선 · 가장 최근 상장 이벤트)
+    const byCode = new Map();
+    for (const row of arr) {
+        const code = String(row.code ?? "");
+        if (!code)
+            continue;
+        byCode.set(code, {
+            code,
+            name: String(row.name ?? ""),
+            listCount: toNum(row.listCount),
+            auditInfo: String(row.auditInfo ?? ""),
+            regDay: String(row.regDay ?? ""),
+            lastPriceKrw: toNum(row.lastPrice),
+            state: String(row.state ?? ""),
+            marketCode: String(row.marketCode ?? ""),
+            marketName: String(row.marketName ?? ""),
+            upName: String(row.upName ?? ""),
+            upSizeName: String(row.upSizeName ?? ""),
+            orderWarningCode: String(row.orderWarning ?? "0"),
+            companyClassName: String(row.companyClassName ?? ""),
+            nxtEnable: String(row.nxtEnable ?? "") === "Y",
+            raw: row,
+        });
+    }
+    return {
+        ok: true,
+        data: Array.from(byCode.values()),
+        meta: { ...cached.value.meta, cached: cached.cached },
+    };
+}
+/**
+ * 코스피 + 코스닥 합집합 유니버스. 본 프로젝트 스크리너 표준 유니버스.
+ *
+ * 호출: 일 1회 배치 (장 마감 후) · 응답 ~3000건 예상.
+ */
+export async function getStandardUniverse() {
+    const [ks, kq] = await Promise.all([
+        getStockUniverse("kospi"),
+        getStockUniverse("kosdaq"),
+    ]);
+    if (!ks.ok)
+        return ks;
+    if (!kq.ok)
+        return kq;
+    return {
+        ok: true,
+        data: {
+            kospi: ks.data,
+            kosdaq: kq.data,
+            total: ks.data.length + kq.data.length,
+        },
+        meta: { cached: (ks.meta?.cached ?? false) && (kq.meta?.cached ?? false) },
+    };
+}
+/** 문자열 → 숫자 (키움은 응답이 모두 string) */
+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=universe.js.map

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

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

package/dist/server/broker/kiwoom/index.js

@@ -0,0 +1,59 @@
+/**
+ * Kiwoom REST + WebSocket API · public surface
+ *
+ * 사용 예:
+ *   import { getDeposit, getCurrentPrice, placeOrder, listConditions } from "../broker/kiwoom";
+ *
+ * 모든 함수는 KiwoomResult<T> = { ok: true, data, meta? } | { ok: false, error } 반환.
+ *
+ * 흐름:
+ *   1. config (apps/client) 의 broker.appKey/secretKey/isDemo 자동 사용
+ *   2. token 자동 캐시 + 만료 5분 전 사전 갱신
+ *   3. rate limiter (실전 5/s · 모의 1.5/s · 200~500ms stagger)
+ *   4. cache (현재가 1s · 호가 1s · 분봉 10s · 일봉 60s · 랭킹 30s · 잔고 5s)
+ *   5. 401 토큰 만료 자동 1회 재시도
+ *
+ * 구현 현황 (2026-04-24):
+ *   - 인증: au10001 au10002
+ *   - 시세: ka10001 ka10004 ka10080 ka10081 ka10086 ka10100
+ *   - 종목정보 리스트: ka10015 ka10099
+ *   - 순위: ka10023 ka10027 ka10030 ka10031
+ *   - 업종/지수: ka10101 ka20003
+ *   - 투자자: ka10008 ka10009 ka10131
+ *   - 테마: ka90001 ka90002
+ *   - 계좌: kt00001 kt00004 kt00005 kt00007 kt00009 kt00010 kt00017 kt00018 ka10085 ka10170
+ *   - 주문: kt10000 kt10001 kt10002 kt10003
+ *   - 조건검색 WS: ka10171 ka10172 ka10173 ka10174
+ */
+// 클라이언트 + 토큰
+export { getAccessToken, kiwoomCall, kiwoomHostLabel } from "./client.js";
+/* ─────────── Account ─────────── */
+export { getDeposit, getHoldings, getPendingOrders, getExecutions, getOrderableQty, getAccountAssessment, getExecutionBalance, getAccountDailyStatus, getAccountProfitRate, getTradeDiary, } from "./endpoints/account.js";
+/* ─────────── OrderTracker ─────────── */
+export { getOrderTracker, placeOrderWithTracking, isMarketOpen } from "./order-tracker.js";
+/* ─────────── Quote ─────────── */
+export { getCurrentPrice, getOrderbook, getDailyChart, getMinuteChart, getStockMeta, } from "./endpoints/quote.js";
+/* ─────────── Ranking ─────────── */
+export { getVolumeRanking, getChangeRanking, getVolumeSurgeRanking, getYesterdayVolumeRanking, } from "./endpoints/ranking.js";
+/* ─────────── Order ─────────── */
+export { placeOrder, modifyOrder, cancelOrder } from "./endpoints/order.js";
+/* ─────────── Universe (신규) ─────────── */
+export { getStockUniverse, getStandardUniverse } from "./endpoints/universe.js";
+/* ─────────── Sector · 업종/지수 (신규) ─────────── */
+export { getMarketIndex, getAllSectorIndices, getSectorCodes, } from "./endpoints/sector.js";
+/* ─────────── Investor · 외국인/기관 (신규) ─────────── */
+export { getForeignActivity, getInstitutionActivity, getContinuousInvestorActivity, } from "./endpoints/investor.js";
+/* ─────────── Detail · 일별 시계열 (신규) ─────────── */
+export { getDailyTradeDetail, getDailyStockPrice } from "./endpoints/detail.js";
+/* ─────────── Theme (신규) ─────────── */
+export { listThemeGroups, getThemeMembers } from "./endpoints/theme.js";
+/* ─────────── WebSocket (신규) ─────────── */
+export { getKiwoomWs, KiwoomWebSocketClient } from "./ws/client.js";
+export { listConditions, requestCondition, startConditionRealtime, stopConditionRealtime, } from "./ws/endpoints/condition.js";
+export { subscribeConditionStream } from "./ws/realtime-bus.js";
+/* ─────────── PriceFeed (Phase 3) ─────────── */
+export { getPriceFeed } from "./price-feed.js";
+/* ─────────── Cache · Rate limiter ─────────── */
+export { cacheStats, cacheDeletePrefix, TTL } from "./cache.js";
+export { getRateLimiter } from "./rate-limiter.js";
+//# sourceMappingURL=index.js.map

package/dist/server/broker/kiwoom/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src-server/broker/kiwoom/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1E,qCAAqC;AAErC,OAAO,EACL,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAmBhC,0CAA0C;AAE1C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG3F,mCAAmC;AAEnC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,sBAAsB,CAAC;AAS9B,qCAAqC;AAErC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAahC,mCAAmC;AAEnC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAU5E,2CAA2C;AAE3C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGhF,iDAAiD;AAEjD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAQ/B,oDAAoD;AAEpD,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AAWjC,kDAAkD;AAElD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhF,wCAAwC;AAExC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAUxE,4CAA4C;AAE5C,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AASrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,iDAAiD;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,kDAAkD;AAElD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}