marketQuote.ts 2.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566
  1. // 주요 종목·상품 시세 도메인 타입 — Backend Application/Features/Api/Stocks/GetMarketQuotes/Response.cs 대응
  2. // 직렬화 주의: 필드명 camelCase. category 는 숫자값(enum), flucRateBp = %×100.
  3. // ── GET /api/market/quotes ──
  4. export interface MarketQuoteRow {
  5. symbol: string;
  6. name: string;
  7. category: number; // 0 Stock,1 Commodity,2 Futures,3 Fx,4 BondYield
  8. groupCode: string; // us-major | asia-major | commodity ...
  9. countryCode: string;
  10. close: number;
  11. changeVal: number;
  12. flucRateBp: number; // %×100
  13. volume: number;
  14. tradeDate: string; // yyyy-MM-dd
  15. }
  16. export interface MarketQuotesResponse {
  17. list: MarketQuoteRow[];
  18. }
  19. // 그룹 코드 → 표시 라벨 (탭)
  20. export const GROUP_LABELS: Record<string, string> = {
  21. 'us-major': '미국 주요',
  22. 'asia-major': '아시아 주요',
  23. 'europe-major': '유럽 주요',
  24. 'commodity': '상품·선물',
  25. 'macro': '환율·금리'
  26. };
  27. export function groupLabel(code: string): string {
  28. return GROUP_LABELS[code] ?? code;
  29. }
  30. // 심볼 → TradingView 심볼(드릴다운). 미국주만 확정 매핑 — 그 외는 null(차트 버튼 미표시).
  31. // Yahoo 미국주는 접미사 없는 순수 티커(AAPL)라 TradingView 동일 심볼. (구) Stooq 표기(aapl.us)도 하위호환.
  32. export function tvSymbolForQuote(symbol: string): string|null {
  33. const s = symbol.trim();
  34. if (/\.us$/i.test(s)) {
  35. return s.slice(0, -3).toUpperCase();
  36. }
  37. if (/^[A-Za-z]{1,6}$/.test(s)) {
  38. return s.toUpperCase();
  39. }
  40. return null;
  41. }
  42. // 거래량 축약 — 0 이하는 "-", 백만/천 단위 축약
  43. export function formatVolume(volume: number): string {
  44. if (volume <= 0) {
  45. return '-';
  46. }
  47. if (volume >= 1_000_000) {
  48. return `${(volume / 1_000_000).toFixed(1)}M`;
  49. }
  50. if (volume >= 1_000) {
  51. return `${Math.round(volume / 1_000)}K`;
  52. }
  53. return volume.toLocaleString('ko-KR');
  54. }
  55. // 전일비 — "+1.23" / "-0.45" (부호 + 천단위 콤마 + 소수 2자리)
  56. export function formatChangeVal(changeVal: number): string {
  57. const sign = changeVal > 0 ? '+' : '';
  58. return `${sign}${changeVal.toLocaleString('ko-KR', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
  59. }