SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 XIRR·STDEV 금융 수식 웹 대시보드 구현하기

React·Vue·Vanilla JS로 웹 앱을 개발하다 보면 '엑셀에서 쓰던 금융 수식을 브라우저에서도 그대로 쓸 수 없을까?'라는 질문에 맞닥뜨리게 됩니다. XIRR·STDEV·COVAR처럼 투자 분석에 필수적인 함수는 대부분의 JavaScript 라이브러리가 지원하지 않아, 직접 알고리즘을 구현하거나 별도 계산 서버를 두어야 하는 복잡한 우회 방법이 필요했습니다.

SpreadJS는 500개 이상의 Excel 호환 수식과 실시간 재계산 엔진을 브라우저 안에 내장한 JavaScript 스프레드시트 라이브러리로, XIRR·STDEV·COVAR 같은 금융 계산 로직을 추가 서버 없이 클라이언트에서 그대로 실행할 수 있습니다.

이 글에서는 SpreadJS를 사용해 투자 포트폴리오 분석 대시보드를 단계별로 구현하는 방법을 설명합니다. 금융 수식 삽입과 조건부 서식 적용부터 복합 차트 구성, xlsx 보고서 내보내기까지 실제 코드 예시와 함께 살펴보겠습니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 Excel 호환 금융 수식 500개 이상 내장 — XIRR·STDEV·COVAR·SLOPE·NPV 등 금융 함수를 별도 서버 없이 브라우저에서 직접 실행합니다
02 데이터 변경 시 즉시 재계산 — 가상화 렌더링으로 수천 건 거래 내역을 매끄럽게 처리하며 셀 값이 바뀌면 연결된 수식 전체를 자동으로 갱신합니다
03 조건부 서식·컬러 스케일로 리스크 시각화 — 3단계 컬러 스케일로 수익 구간(녹색)과 손실 구간(빨간색)을 자동으로 강조합니다
04 차트·IO 플러그인 단일 패키지 — 꺾은선·도넛 복합 차트와 xlsx 내보내기를 단일 라이브러리로 제공합니다
SpreadJS로 XIRR·STDEV 금융 수식 웹 대시보드 구현하기 — 대표 이미지

웹 앱에서 XIRR·STDEV 같은 금융 수식을 어떻게 구현하나요?

SpreadJS는 setFormula() 메서드로 셀에 Excel 수식을 그대로 입력합니다. =XIRR(B2:B6,C2:C6) 처럼 현금 흐름과 날짜 범위를 지정하면 내부 수익률을 계산하고, =STDEV(E2:E13) 으로 월별 수익률의 표준편차(변동성)를, =COVAR(E2:E13,F2:F13) 으로 두 자산 간 공분산을 구합니다. =SLOPE(E2:E13,F2:F13) 은 시장 대비 베타 계산에 활용됩니다. 수식을 한 번 삽입하면 이후 데이터 변경 시 SpreadJS 재계산 엔진이 자동으로 결과를 갱신합니다.

아래 데모는 8개 종목 포트폴리오 현황 시트입니다. 수익률 열에 3단계 컬러 스케일(-20% 빨강 → 0% 노랑 → +30% 초록)을 적용해 손익 구간을 즉각 시각화하며, 요약 행의 변동성(σ)은 =STDEV() 수식으로 자동 계산됩니다.

실행 결과
💡 TIP
setFormula(row, col, '=STDEV(E2:E9)') 로 셀에 수식을 삽입하면 데이터가 변경될 때마다 SpreadJS 재계산 엔진이 자동으로 결과를 갱신합니다. XIRR 같은 반복 수렴 계산 수식도 동일한 방식으로 동작합니다.
웹 앱에서 XIRR·STDEV 같은 금융 수식을 어떻게 구현하나요? — SpreadJS 개념도

수익률 꺾은선 차트와 자산 배분 도넛 차트를 한 화면에 넣는 방법

SpreadJS 차트 플러그인( gc.spread.sheets.charts )으로 수익률 추이 꺾은선 차트와 자산 배분 도넛 차트를 같은 워크북의 별도 시트에 배치할 수 있습니다. sheet.charts.add(이름, ChartType, x, y, 너비, 높이, 데이터범위) 호출 한 번으로 원하는 위치와 크기에 차트를 삽입하며, chart.series().get(0) 으로 색상·마커 등 시리즈 스타일을 세밀하게 제어합니다.

실행 결과
ⓘ NOTE
sheetCount: 2 로 워크북을 초기화하면 두 시트를 독립적으로 관리할 수 있습니다. 하단 탭을 클릭해 꺾은선 차트(수익률추이)와 도넛 차트(자산배분) 사이를 전환해보세요.
수익률 꺾은선 차트와 자산 배분 도넛 차트를 한 화면에 넣는 방법 — SpreadJS 개념도

포트폴리오 분석 결과를 xlsx 파일로 자동 내보내는 방법

분석 결과를 Excel 파일로 저장할 때는 @mescius/spread-sheets-io 플러그인의 spread.export() 메서드를 사용합니다. 수식·조건부 서식·차트가 포함된 시트 구조 그대로 .xlsx 파일로 내보내므로 담당자가 Excel에서 추가 편집을 이어갈 수 있습니다.

실행 결과
⭐ IMPORTANT
IO 플러그인( gc.spread.sheets.io )을 메인 스크립트보다 뒤에 로드해야 spread.export() 가 정상 동작합니다. 플러그인 없이 호출하면 fileType 을 인식하지 못해 내보내기가 실패합니다.
↗
500+
내장 수식
XIRR·STDEV·COVAR 등 금융 함수 Excel 완전 호환
↗
60FPS
렌더링 성능
가상화 엔진으로 수만 행 거래 내역 매끄럽게 처리
↗
1개
라이브러리
수식·차트·조건부서식·IO 플러그인 한 번에 해결

금융 대시보드 개발자 자주 묻는 질문

Q01

JavaScript로 웹에서 XIRR, STDEV 같은 금융 수식을 Excel처럼 계산할 수 있는 라이브러리가 있나요?

SpreadJS(MESCIUS)가 Excel 호환 수식 500개 이상을 지원합니다. XIRR·STDEV·COVAR 등 금융 수식을 추가 서버 없이 브라우저에서 직접 실행할 수 있으며, sheet.setFormula(row, col, '=XIRR(B2:B6,C2:C6)') 처럼 Excel과 동일한 수식 문법을 그대로 사용하면 됩니다.

Q02

SpreadJS로 수익률 계산, 리스크 분석, 차트가 통합된 포트폴리오 대시보드를 구현하려면 어떻게 하나요?

SpreadJS 하나로 수식·서식·차트·파일 내보내기를 모두 처리할 수 있습니다. setFormula() 로 금융 수식을 삽입하고, conditionalFormats.add3ScaleRule() 로 리스크 컬러 스케일을 지정하고, sheet.charts.add() 로 차트를 배치하면 대시보드가 완성됩니다.

Q03

WebSocket으로 실시간 주가 데이터를 받아 포트폴리오 수익률과 차트를 자동 갱신하는 웹 UI를 만들 수 있나요?

네, 가능합니다. SpreadJS는 가상화 렌더링으로 수만 행 거래 내역을 부드럽게 처리하며, 셀 값이 갱신되면 연결된 수식과 차트가 즉시 함께 업데이트됩니다. WebSocket이나 Server-Sent Events로 시세 데이터를 받아 sheet.setValue() 로 셀에 반영하기만 하면 실시간 대시보드가 동작합니다.

Q04

기존 Excel 기반 자산 운용 시스템을 웹으로 마이그레이션할 때 수식·서식을 그대로 유지하려면 어떻게 해야 하나요?

SpreadJS는 Excel 수식 문법을 그대로 지원하므로, 기존 Excel 파일에 쓰던 수식 로직을 setFormula() 로 옮겨 쓸 수 있습니다. IO 플러그인으로 xlsx 파일을 직접 불러오면 시트 구조·수식·서식을 유지한 채로 웹 앱으로 전환하는 방법도 있습니다.

Q05

React나 Vue 프로젝트에 SpreadJS 금융 그리드와 차트를 함께 통합하려면 어떻게 설치하나요?

SpreadJS는 @mescius/spread-sheets-react , @mescius/spread-sheets-vue 래퍼 패키지를 공식으로 제공합니다. 그리드·수식·차트가 단일 워크북 인스턴스 안에서 연동되어 별도 상태 관리 없이도 일관된 포트폴리오 대시보드를 구현할 수 있습니다.

MESCIUS SpreadJS

지금 바로 SpreadJS 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

SpreadJS 무료 체험판 다운로드