84 lines
2.3 KiB
TypeScript
84 lines
2.3 KiB
TypeScript
/**
|
|
* @file lib/kis/config.ts
|
|
* @description KIS 거래 환경(real/mock) 설정과 키/도메인 로딩
|
|
*/
|
|
|
|
export type KisTradingEnv = "real" | "mock";
|
|
|
|
export interface KisCredentialInput {
|
|
tradingEnv?: KisTradingEnv;
|
|
appKey?: string;
|
|
appSecret?: string;
|
|
baseUrl?: string;
|
|
}
|
|
|
|
export interface KisConfig {
|
|
tradingEnv: KisTradingEnv;
|
|
appKey: string;
|
|
appSecret: string;
|
|
baseUrl: string;
|
|
}
|
|
|
|
const DEFAULT_KIS_REAL_BASE_URL = "https://openapi.koreainvestment.com:9443";
|
|
const DEFAULT_KIS_MOCK_BASE_URL = "https://openapivts.koreainvestment.com:29443";
|
|
const DEFAULT_KIS_REAL_WS_URL = "ws://ops.koreainvestment.com:21000";
|
|
const DEFAULT_KIS_MOCK_WS_URL = "ws://ops.koreainvestment.com:31000";
|
|
|
|
/**
|
|
* 거래 환경 문자열을 정규화합니다.
|
|
* @param value 환경값
|
|
* @returns real | mock
|
|
*/
|
|
export function normalizeTradingEnv(value?: string): KisTradingEnv {
|
|
return (value ?? "mock").toLowerCase() === "real" ? "real" : "mock";
|
|
}
|
|
|
|
/**
|
|
* KIS 웹소켓 URL을 반환합니다.
|
|
* @param tradingEnvInput 거래 모드(real/mock)
|
|
* @returns websocket base url
|
|
*/
|
|
export function getKisWebSocketUrl(tradingEnvInput?: KisTradingEnv) {
|
|
const tradingEnv = normalizeTradingEnv(tradingEnvInput);
|
|
|
|
if (tradingEnv === "real") {
|
|
return DEFAULT_KIS_REAL_WS_URL;
|
|
}
|
|
|
|
return DEFAULT_KIS_MOCK_WS_URL;
|
|
}
|
|
|
|
/**
|
|
* 설정 준비 여부를 확인합니다.
|
|
* @param input 외부(사용자 입력) 키가 있으면 우선 사용
|
|
* @returns 사용 가능 여부
|
|
*/
|
|
export function hasKisConfig(input?: KisCredentialInput) {
|
|
return Boolean(input?.appKey?.trim() && input?.appSecret?.trim());
|
|
}
|
|
|
|
/**
|
|
* KIS 호출에 필요한 설정을 반환합니다.
|
|
* @param input 사용자 입력 키(선택)
|
|
* @returns tradingEnv/appKey/appSecret/baseUrl
|
|
*/
|
|
export function getKisConfig(input?: KisCredentialInput): KisConfig {
|
|
if (input?.appKey?.trim() && input?.appSecret?.trim()) {
|
|
const tradingEnv = normalizeTradingEnv(input.tradingEnv);
|
|
const baseUrl =
|
|
input.baseUrl ??
|
|
(tradingEnv === "real" ? DEFAULT_KIS_REAL_BASE_URL : DEFAULT_KIS_MOCK_BASE_URL);
|
|
|
|
return {
|
|
tradingEnv,
|
|
appKey: input.appKey.trim(),
|
|
appSecret: input.appSecret.trim(),
|
|
baseUrl,
|
|
};
|
|
}
|
|
|
|
throw new Error(
|
|
"KIS API 키가 없습니다. 설정 화면에서 앱 키와 앱 시크릿을 먼저 입력해 주세요.",
|
|
);
|
|
}
|