marketQuote.ts 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  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. };
  26. export function groupLabel(code: string): string {
  27. return GROUP_LABELS[code] ?? code;
  28. }
  29. // 심볼 → TradingView 심볼(드릴다운). 미국주만 확정 매핑 — 그 외는 null(차트 버튼 미표시).
  30. // Yahoo 미국주는 접미사 없는 순수 티커(AAPL)라 TradingView 동일 심볼. (구) Stooq 표기(aapl.us)도 하위호환.
  31. export function tvSymbolForQuote(symbol: string): string|null {
  32. const s = symbol.trim();
  33. if (/\.us$/i.test(s)) {
  34. return s.slice(0, -3).toUpperCase();
  35. }
  36. if (/^[A-Za-z]{1,6}$/.test(s)) {
  37. return s.toUpperCase();
  38. }
  39. return null;
  40. }
  41. // 거래량 축약 — 0 이하는 "-", 백만/천 단위 축약
  42. export function formatVolume(volume: number): string {
  43. if (volume <= 0) {
  44. return '-';
  45. }
  46. if (volume >= 1_000_000) {
  47. return `${(volume / 1_000_000).toFixed(1)}M`;
  48. }
  49. if (volume >= 1_000) {
  50. return `${Math.round(volume / 1_000)}K`;
  51. }
  52. return volume.toLocaleString('ko-KR');
  53. }
  54. // 전일비 — "+1.23" / "-0.45" (부호 + 천단위 콤마 + 소수 2자리)
  55. export function formatChangeVal(changeVal: number): string {
  56. const sign = changeVal > 0 ? '+' : '';
  57. return `${sign}${changeVal.toLocaleString('ko-KR', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
  58. }