환율 데이터 수집 설계: 원천 비교와 일별 누적 기준

환율 데이터는 숫자 하나처럼 보이지만 기준 통화, 고시 시각, 휴일 처리에 따라 의미가 달라진다. 같은 날짜의 USD/KRW라도 어느 기관의 어떤 시각 값을 쓰는지에 따라 일별 수익률과 원화 환산 결과가 바뀐다.

환율 데이터 수집 설계: 원천 비교와 일별 누적 기준 핵심 구조도

환율 테이블에 필요한 축

축	예시	왜 필요한가
base_currency	USD	기준 통화 확인
quote_currency	KRW	표시 통화 확인
rate_time	16:00 KST	고시 시각 차이 구분
source	central_bank, vendor	원천별 차이 추적

교차 환율 계산은 방향을 적어둔다

KRW_per_EUR = KRW_per_USD * USD_per_EUR

return {
  rate: KRW_per_EUR,
  method: 'cross_rate',
  legs: ['KRW/USD', 'USD/EUR']
}

휴일 보정의 기준

금융시장 휴일과 은행 고시 휴일이 다를 수 있다. 가격 데이터와 맞출 때는 어떤 캘린더를 기준으로 forward fill했는지 남긴다.

원천 비교 방법

• 주요 통화쌍은 두 원천 이상을 받아 일별 차이를 기록한다.
• 차이가 일정 임계값을 넘으면 자동 보정하지 말고 원천 상태를 먼저 본다.
• 원화 환산 재무 지표에는 사용한 환율 원천과 날짜를 함께 저장한다.

실전 적용 포인트

환율 데이터는 숫자 하나처럼 보이지만 기준 통화와 표시 통화의 방향이 바뀌면 전혀 다른 값이 된다. USD/KRW와 KRW/USD를 혼동하면 가격 환산, 매출 환산, 수익률 계산이 모두 틀어진다.

교차 환율을 계산할 때는 어떤 원천의 어떤 시각 값을 썼는지 남겨야 한다. 같은 날짜라도 고시 시각이 다르면 해외 주식의 원화 수익률이 달라질 수 있기 때문이다.

• base_currency와 quote_currency를 명확히 저장한다.
• 고시 시각과 원천을 함께 보관한다.
• 교차 환율은 계산식과 사용한 양쪽 환율을 남긴다.

함께 보면 좋은 글

• 거시경제 데이터 API 설계
• 외부 금융 데이터 소스 전환 검토 기준