Wijmo 블로그 MESCIUS 기술 블로그 ·

자바스크립트 캔들스틱 차트 구현 — Wijmo FinancialChart OHLC 주가 차트

처음 주가 차트를 만들 때 가장 먼저 막히는 부분이 "자바스크립트로 캔들스틱 차트는 어떻게 그리지?"입니다. 일반 막대·선 차트로는 시가·고가·저가·종가를 한 봉에 담고 상승과 하락을 색으로 구분하기 어렵기 때문입니다. Wijmo의 FinancialChart 는 금융 데이터 시각화에 맞춰 설계된 차트라서, high,low,open,close 네 필드만 바인딩하면 캔들스틱과 OHLC 차트를 바로 만들 수 있습니다.

이 글은 번들러 없이 CDN만으로 동작하는 순수 JavaScript 예제로, 캔들스틱 주가 차트를 만들고 OHLC 차트로 전환해 비교하는 과정을 5단계로 따라갑니다. 핀테크·증권 대시보드를 처음 구현하는 프론트엔드 개발자도 그대로 따라 할 수 있도록 구성했습니다.

⭐
Key Points
이 글에서 다루는 핵심 내용
01
wijmo.chart.finance.FinancialChart 는 캔들스틱·OHLC·Heikin-Ashi 등 금융 전용 차트 유형을 기본으로 지원하므로 별도 차트 로직을 직접 만들 필요가 없습니다.
02
시리즈의 binding 을 "high,low,open,close" 순서로 지정하면 캔들스틱 차트가 완성됩니다.
03
FinancialChartType.Candlestick 과 FinancialChartType.HighLowOpenClose 값만 바꾸면 캔들스틱과 OHLC 두 가지 표현 방식을 전환할 수 있습니다.
04
style / altStyle 로 상승·하락 색상을, tooltip.content 로 시가·고가·저가·종가 툴팁을 원하는 형태로 꾸밀 수 있습니다.

FinancialChart와 FlexChart, 금융 차트에는 무엇을 써야 할까

FlexChart 는 막대·선·영역·산점도 같은 범용 차트를 다루는 컨트롤이고, FinancialChart 는 wijmo.chart.finance 모듈에 정의된 금융 전용 컨트롤입니다. 흥미로운 점은 FlexChart 에서도 Candlestick 과 HighLowOpenClose 유형을 쓸 수 있다는 것입니다. 두 컨트롤의 선택 기준은 다음과 같습니다.

구분 FlexChart FinancialChart
모듈 wijmo.chart wijmo.chart.finance
기본 목적 범용 차트 금융·주가 차트
Candlestick / OHLC 지원 지원
Heikin-Ashi, Renko, Kagi, LineBreak 미지원 지원
ColumnVolume, EquiVolume, CandleVolume 미지원 지원
기술적 지표(RSI, MACD 등) 확장 별도 모듈 FinancialChart 시리즈로 연계

단순한 캔들스틱 하나만 필요하다면 FlexChart 로도 충분합니다. 하지만 거래량 기반 차트나 Heikin-Ashi 같은 고급 유형, 기술적 지표까지 확장할 가능성이 있다면 처음부터 FinancialChart 를 선택하는 편이 낫습니다. 이 글은 이후 확장성을 고려해 FinancialChart 를 사용합니다.

💡 SUMMARY
Wijmo FinancialChart는 MESCIUS가 제공하는 금융 전용 차트로, 캔들스틱·OHLC·Heikin-Ashi 등을 지원합니다.

하나의 캔들 봉에서 몸통과 위·아래 꼬리, 시가·종가·고가·저가 위치를 표시한 일러스트

캔들스틱 차트와 OHLC 차트, 모양과 용도 비교

두 차트는 같은 데이터(시가·고가·저가·종가) 를 표현하지만 모양이 다릅니다.

  • 캔들스틱(Candlestick): 시가와 종가 사이를 몸통(bar)으로, 고가와 저가를 꼬리(wick)로 그립니다. 종가가 시가보다 높은지 낮은지에 따라 몸통 색이 달라 상승·하락 흐름이 한눈에 들어옵니다.
  • OHLC(HighLowOpenClose): 캔들스틱과 같은 정보를 보여주되, 시가는 막대 왼쪽 선으로, 종가는 오른쪽 선으로 표시합니다. 몸통이 없어 봉이 촘촘한 장기 데이터에서 더 깔끔합니다.

OHLC 막대 차트와 캔들스틱 차트를 나란히 비교한 다이어그램

💡 SUMMARY
OHLC는 시가·종가를 좌우 선으로, 캔들스틱은 몸통으로 표현하며 두 차트가 담는 데이터는 동일합니다.

STEP-BY-STEP: 자바스크립트로 캔들스틱 주가 차트 만들기

STEP 1: CDN으로 Wijmo 라이브러리 불러오기

번들러 없이 실행하려면 Wijmo 코어, 차트, 금융 차트 모듈을 CDN으로 참조합니다. 참조 순서가 중요하며 코어( wijmo.min.js )가 항상 먼저 와야 합니다.

wijmo.culture.ko.min.js 는 날짜·숫자 서식을 한국어 문화권으로 맞춰 줍니다. 경로가 5.latest/controls/cultures/ 임에 유의하세요.

💡 SUMMARY
Wijmo FinancialChart는 CDN 스크립트만으로 번들러 없이 바로 실행할 수 있습니다.

STEP 2: 차트가 그려질 HTML 컨테이너 만들기

차트가 그려질 요소를 하나 만듭니다.

STEP 3: 주가 데이터를 준비하고 캔들스틱 차트 생성하기

날짜( date )와 open , high , low , close 필드를 가진 객체 배열을 준비합니다. 아래 함수는 실제 시세 API를 대신해 평일 40일치 샘플 데이터를 만듭니다. 난수 시드를 고정했으므로 실행할 때마다 같은 차트가 나옵니다.

차트는 bindingX 에 날짜 필드를, 시리즈의 binding 에 "high,low,open,close" 를 지정합니다. 순서가 정확히 high → low → open → close여야 합니다.

이 정도만으로 캔들스틱 차트가 그려집니다. 시리즈 하나에 네 필드를 콤마로 묶어 바인딩하는 것이 핵심입니다.

💡 SUMMARY
Wijmo에서 캔들스틱 차트는 high·low·open·close 4개 필드를 바인딩하면 몇 줄의 코드로 구현됩니다.

STEP 4: 축 서식과 상승·하락 색상, 툴팁 꾸미기

기본 색상만으로도 상승과 하락은 구분되지만, 국내 증시 관행(상승 빨강, 하락 파랑)에 맞추려면 색을 직접 지정해야 합니다. style 은 기본 스타일, altStyle 은 대체 스타일이며, 공식 문서의 캔들스틱 예제에서는 시가가 종가보다 큰 하락 봉에 altStyle 이 적용됩니다. 따라서 style 에 상승 색, altStyle 에 하락 색을 지정합니다.

툴팁은 tooltip.content 에 HTML 템플릿을 넣어 바인딩한 필드를 {필드명:서식} 형태로 출력합니다. 아래 코드는 STEP 3의 코드에 스타일링을 더한 누적 코드입니다.

STEP 5: 완성 — 버튼 하나로 OHLC 차트로 전환하기

마지막으로 같은 데이터로 두 차트 유형을 비교할 수 있도록, 버튼으로 chartType 을 바꾸게 합니다. 전환은 chart.chartType 에 FinancialChartType.Candlestick 또는 FinancialChartType.HighLowOpenClose 를 대입하기만 하면 됩니다. OHLC는 몸통이 없는 선형 표현이라 stroke 색이 중요하므로, 앞서 지정한 style / altStyle 의 stroke 가 그대로 활용됩니다. 버튼은 JavaScript로 생성해 차트 컨테이너 위에 삽입하므로 별도의 전역 함수 노출이 필요 없습니다.

실행 결과

위 라이브 데모에서 버튼을 눌러 보면 같은 데이터가 몸통 있는 봉과 좌우 눈금선이 있는 막대로 바뀌는 것을 확인할 수 있습니다. 봉 위에 마우스를 올리면 시가·고가·저가·종가가 툴팁으로 표시됩니다.

💡 SUMMARY
chartType 값 하나만 바꾸면 같은 데이터로 캔들스틱과 OHLC를 전환해 비교할 수 있습니다.

실무 팁: 캔들스틱 다음에 도입할 수 있는 금융 차트 유형

기본 구현을 마쳤다면 chartType 만 바꿔 다양한 금융 차트를 시도해 볼 수 있습니다. 공식 문서 기준으로 FinancialChart 는 다음 고급 유형을 지원합니다.

  • HeikinAshi: 평균 기반 봉으로 노이즈를 줄여 추세를 부각
  • LineBreak / Renko / Kagi: 시간 대신 가격 변동을 기준으로 그리는 차트
  • ColumnVolume / EquiVolume / CandleVolume / ArmsCandleVolume: 거래량을 봉 너비에 반영 ( binding 에 volume 필드를 추가해 "high,low,open,close,volume" 형식 사용)
  • PointAndFigure: X·O 기호로 가격 방향을 표시

거래량 계열 차트는 FinancialChart 수준에서만 사용할 수 있고, 한 차트에 하나의 volume 데이터만 지원한다는 점에 주의하세요. 이동평균, RSI, MACD 같은 기술적 지표는 wijmo.chart.finance.analytics 모듈로 추가할 수 있습니다.

💡 SUMMARY
FinancialChart는 chartType 교체만으로 Heikin-Ashi, Renko, 거래량 기반 차트 등 고급 금융 시각화로 확장됩니다.

자주 묻는 질문 (FAQ)

Q01

Wijmo FinancialChart는 어떤 컨트롤인가요?

MESCIUS가 제공하는 금융 전용 JavaScript 차트 컨트롤로, wijmo.chart.finance 모듈에 정의되어 있습니다. 캔들스틱, OHLC, Heikin-Ashi, Renko, Kagi 등 다양한 금융 차트 유형과 거래량 차트를 chartType 속성 하나로 전환할 수 있습니다.
Q02

자바스크립트로 캔들스틱(Candlestick) 차트를 만들려면 어떻게 하나요?

wijmo.chart.finance.FinancialChart 를 만들고 bindingX 에 날짜 필드를, 시리즈의 binding 에 "high,low,open,close" 를 지정한 뒤 chartType 을 FinancialChartType.Candlestick 으로 설정합니다. CDN으로 wijmo.min.js , wijmo.chart.min.js , wijmo.chart.finance.min.js 를 참조하면 번들러 없이도 동작합니다.
Q03

OHLC 차트와 캔들스틱 차트는 무엇이 다른가요?

두 차트 모두 시가·고가·저가·종가를 표현하지만 모양이 다릅니다. 캔들스틱은 시가와 종가 사이를 몸통으로 채워 상승·하락을 색으로 구분하고, OHLC( HighLowOpenClose )는 시가를 왼쪽 선, 종가를 오른쪽 선으로 그려 몸통 없이 표현합니다.
Q04

주가·금융 데이터를 시각화할 때 쓸 만한 JavaScript 차트 라이브러리는 무엇인가요?

금융 데이터에는 캔들스틱·OHLC뿐 아니라 거래량 차트와 기술적 지표가 필요한 경우가 많습니다. Wijmo FinancialChart는 이런 유형을 기본 제공하고 CollectionView 기반 데이터 바인딩, 툴팁·축 서식 커스터마이징, Angular·React·Vue 연동을 지원하므로 증권·핀테크 대시보드 후보로 검토할 만합니다.
Q05

FlexChart와 FinancialChart 중 무엇을 선택해야 하나요?

캔들스틱이나 OHLC 한 가지만 필요하다면 FlexChart 로도 구현할 수 있습니다. Heikin-Ashi, Renko, Kagi, 거래량 기반 차트처럼 금융 전용 유형이나 지표 확장이 필요하다면 처음부터 FinancialChart 로 시작하는 편이 좋습니다.
Q06

기술지원을 받을 수 있는 상용 금융 차트 라이브러리가 있나요?

Wijmo는 MESCIUS가 제공하는 상용 JavaScript UI 컴포넌트 라이브러리로, 라이선스 구매 고객은 제품 기술지원을 받을 수 있습니다. 구체적인 지원 범위와 라이선스 조건은 [MESCIUS Wijmo 제품 페이지](https://www.mescius.co.kr/wijmo)에서 확인하세요.

MESCIUS Wijmo

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

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

Wijmo 무료 체험판 다운로드