구현

한 줄 요약

• 데이터 수집(Upbit REST) → 24시간만 추려서 정렬 → 시세 요약 헤더 갱신(Upbit REST) → 차트 렌더링(SwiftUI Chart) → 1분마다 맨 끝 봉만 추가 → 백그라운드/재진입 최적화

• Upbit에서 REST 방식으로 가져오는 데이터

  • 헤더(현재가/등락률/거래대금): Upbit REST 티커 API(/ticker 계열)로 조회

    

  • 분봉(캔들): Upbit REST 분봉 API(/candles/minutes/1)로 수집

    

흐름도

1. ChartViewModel.init → startUpdating() 시작

   • 최초 1회로 전체 캔들 데이터를 불러오고, 이후 60초마다 일부만 갱신하는 루프를 켜는 코드
   • 스피너 여부: prices.isEmpty면 스피너 ON(최초/빈 상태), 아니면 OFF(조용한 갱신)
     • shouldShowSpinner: 데이터가 비어있는지 확인해서 비어있으면 최초 실행으로 판단 → 스피너를 표시하고 전체 로드하는 플래그 ↔ 재진입/빠른 화면 전환/일시적인 네트워크 끊김 후 복귀 시 스피너 표시 안하고 전체 로드

2. 최초 1회 전체 로드: loadPrices()

   • 분봉: UpbitPriceService.fetchPrices() → 내부에서 REST /candles/minutes/1 반복 호출(최대 200개 제한 때문에)
   • 헤더: UpBitAPIService.fetchTicker(by:)
   • 24시간 윈도우로 필터링 → prices 바인딩

3. 이후 매 60초 일부 갱신: refreshLatestCandles()

   • 맨 끝 봉 시각 기준 부족한 분 수만큼만 불러와 교체/추가/무시 규칙으로 병합
   • 헤더 값(Ticker) 동시에 갱신

     • 두 Task를 시작하고 await로 기다렸다가 같은 타이밍에 화면에 반영

       async let pricesTask = priceService.fetchPrices(...)
       async let tickerTask  = tickerAPI.fetchTicker(by: ...)
       let (prices, tickers) = try await (pricesTask, tickerTask)  // 동시에 시작해 기다렸다가 함께 반영
       

4. Swift Charts로 렌더링: CandleChartView

   • 꼬리선 = RuleMark, 몸통 = RectangleMark
   • 막대 폭 자동 계산: 1분 간격의 60% chartOverlay
   • y축 동적 범위: 최소~최대값 간격의 120%
   • X축 라벨: 15분 간격 고정 틱(00/15/30/45)라벨 + 오른쪽 경계 3분 버퍼는 숨김
   • 초기 스크롤: 마지막 데이터 + 5분 완충

5. 앱 상태

   • .active → retry()(60초 주기 루프 재가동)
   • .background → stopUpdating()(루프 중지) (scenePhase 환경값으로 감지)

캔들 차트의 의미

• 몸통 (Body)
  • 시가 Open: 1분 동안의 첫번째 거래가격
  • 종가 Close: 1분 동안의 마지막 거래가격
• 꼬리 (Wick)
  • 고가 High: 1분 동안 제일 비싸게 거래된 가격
  • 저가 Low: 1분 동안 제일 싸게 거래된 가격

트러블슈팅