운영 방법론
국내 ETF 데이터를 매일 정적으로 발행하는 이유
실시간 시세 서비스가 아니라 종가 기준 스냅샷을 매일 발행해, 운영비와 장애 지점을 줄이는 구조를 선택했습니다.
ETF Radar는 실시간 시세 서비스가 아닙니다
ETF Radar는 장중 가격을 초 단위로 전송하는 서비스가 아니라 거래일별 종가와 공개된 구성종목 스냅샷을 정리하는 정보 서비스입니다. 수익률 비교의 기준은 화면에 표시된 데이터 기준일의 종가이며, 현재 시장 가격이나 실제 주문 가능 가격과 다를 수 있습니다.
실시간성이 아니라 매일 같은 기준으로 데이터를 쌓고 전일 대비 변화를 비교하는 데 초점을 맞췄습니다. 사용자는 화면 상단의 기준일과 수집 상태를 확인한 뒤 수익률, 구성종목 변화, 액티브 ETF의 공통 변화를 살펴볼 수 있습니다.
수집부터 배포까지의 흐름
예약된 GitHub Actions 작업이 KRX Open API에서 국내 주식형 현물 ETF의 종가, NAV, 시가총액, 순자산, 거래량과 벤치마크 정보를 가져옵니다. ETF 메타데이터와 전일 기준 TOP 10 구성자산은 네이버 금융 상세 페이지에서 수집합니다.
수집기는 데이터를 검증한 뒤 JSON 파일로 만들고 변경된 파일을 저장소에 반영합니다. Cloudflare Pages는 새 커밋을 감지해 React 앱과 데이터 파일을 함께 배포합니다. 사용자가 페이지를 열면 별도 애플리케이션 서버가 아니라 배포된 정적 파일을 직접 받습니다.
정적 발행 구조의 장점과 한계
별도 데이터베이스, 런타임 API 서버, 캐시 서버가 없어 운영비와 장애 지점이 적다는 것이 가장 큰 장점입니다. 같은 기준일의 데이터가 하나의 배포본으로 제공되므로 화면마다 결과가 달라질 가능성도 줄어듭니다. 트래픽이 늘어도 정적 파일 전송 중심이라 초기 서비스가 감당하기 쉽습니다.
반면 장중 시세와 실시간 체결 정보는 제공할 수 없고, 원천 데이터 공개가 지연되면 ETF Radar의 갱신도 늦어집니다. 사용자 계정, 기기 간 관심종목 동기화, 개인별 알림처럼 서버 상태가 필요한 기능은 현재 구조만으로 지원하기 어렵습니다.
데이터 신뢰도를 확인하는 방법
수집 결과에는 기준일, 생성 시각, ETF 수, 실패 건수와 출처가 기록됩니다. 배포 후에는 별도 헬스체크가 공개된 상태 파일을 확인하고, 데이터가 최신 거래일과 맞지 않거나 실패 항목이 있으면 운영자가 원인을 조사할 수 있도록 구성했습니다.
구조가 자동화되어 있어도 원천 자료의 오류나 HTML 형식 변경 가능성은 남아 있습니다. ETF Radar의 숫자가 운용사 자료와 다르다면 화면의 문의 경로로 알려 주고, 실제 투자 판단에는 KRX와 운용사 상품 페이지, 투자설명서를 우선해야 합니다.
확인 체크리스트
- 화면 상단에서 데이터 기준일과 수집 상태를 확인합니다.
- 표시 가격을 실시간 시세나 실제 주문 가격으로 사용하지 않습니다.
- TOP 10 구성자산과 전체 포트폴리오를 구분합니다.
- 중요한 판단에는 KRX와 운용사 공식 자료를 함께 확인합니다.
투자 유의사항
이 글은 공개된 ETF 데이터를 해석하는 일반적인 방법을 설명하며 특정 상품이나 종목의 매수·매도를 권유하지 않습니다. 중요한 판단에는 운용사 공식 자료를 함께 사용하세요.
서비스 소개수집 방법론 자세히 보기