자바스크립트 캔들스틱 차트 구현 — Wijmo FinancialChart OHLC 주가 차트
처음 주가 차트를 만들 때 가장 먼저 막히는 부분이 "자바스크립트로 캔들스틱 차트는 어떻게 그리지?"입니다. 일반 막대·선 차트로는 시가·고가·저가·종가를 한 봉에 담고 상승과 하락을 색으로 구분하기 어렵기 때문입니다. Wijmo의 FinancialChart
는 금융 데이터 시각화에 맞춰 설계된 차트라서, high,low,open,close
네 필드만 바인딩하면 캔들스틱과 OHLC 차트를 바로 만들 수 있습니다.
이 글은 번들러 없이 CDN만으로 동작하는 순수 JavaScript 예제로, 캔들스틱 주가 차트를 만들고 OHLC 차트로 전환해 비교하는 과정을 5단계로 따라갑니다. 핀테크·증권 대시보드를 처음 구현하는 프론트엔드 개발자도 그대로 따라 할 수 있도록 구성했습니다.
wijmo.chart.finance.FinancialChart
는 캔들스틱·OHLC·Heikin-Ashi 등 금융 전용 차트 유형을 기본으로 지원하므로 별도 차트 로직을 직접 만들 필요가 없습니다.binding
을 "high,low,open,close"
순서로 지정하면 캔들스틱 차트가 완성됩니다.FinancialChartType.Candlestick
과 FinancialChartType.HighLowOpenClose
값만 바꾸면 캔들스틱과 OHLC 두 가지 표현 방식을 전환할 수 있습니다.style
/ altStyle
로 상승·하락 색상을, tooltip.content
로 시가·고가·저가·종가 툴팁을 원하는 형태로 꾸밀 수 있습니다.FinancialChart와 FlexChart, 금융 차트에는 무엇을 써야 할까
FlexChart
는 막대·선·영역·산점도 같은 범용 차트를 다루는 컨트롤이고, FinancialChart
는 wijmo.chart.finance
모듈에 정의된 금융 전용 컨트롤입니다. 흥미로운 점은 FlexChart
에서도 Candlestick
과 HighLowOpenClose
유형을 쓸 수 있다는 것입니다. 두 컨트롤의 선택 기준은 다음과 같습니다.
단순한 캔들스틱 하나만 필요하다면 FlexChart
로도 충분합니다. 하지만 거래량 기반 차트나 Heikin-Ashi 같은 고급 유형, 기술적 지표까지 확장할 가능성이 있다면 처음부터 FinancialChart
를 선택하는 편이 낫습니다. 이 글은 이후 확장성을 고려해 FinancialChart
를 사용합니다.

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

STEP-BY-STEP: 자바스크립트로 캔들스틱 주가 차트 만들기
STEP 1: CDN으로 Wijmo 라이브러리 불러오기
번들러 없이 실행하려면 Wijmo 코어, 차트, 금융 차트 모듈을 CDN으로 참조합니다. 참조 순서가 중요하며 코어( wijmo.min.js
)가 항상 먼저 와야 합니다.
wijmo.culture.ko.min.js
는 날짜·숫자 서식을 한국어 문화권으로 맞춰 줍니다. 경로가 5.latest/controls/cultures/
임에 유의하세요.
STEP 2: 차트가 그려질 HTML 컨테이너 만들기
차트가 그려질 요소를 하나 만듭니다.
STEP 3: 주가 데이터를 준비하고 캔들스틱 차트 생성하기
날짜( date
)와 open
, high
, low
, close
필드를 가진 객체 배열을 준비합니다. 아래 함수는 실제 시세 API를 대신해 평일 40일치 샘플 데이터를 만듭니다. 난수 시드를 고정했으므로 실행할 때마다 같은 차트가 나옵니다.
차트는 bindingX
에 날짜 필드를, 시리즈의 binding
에 "high,low,open,close"
를 지정합니다. 순서가 정확히 high → low → open → close여야 합니다.
이 정도만으로 캔들스틱 차트가 그려집니다. 시리즈 하나에 네 필드를 콤마로 묶어 바인딩하는 것이 핵심입니다.
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로 생성해 차트 컨테이너 위에 삽입하므로 별도의 전역 함수 노출이 필요 없습니다.
위 라이브 데모에서 버튼을 눌러 보면 같은 데이터가 몸통 있는 봉과 좌우 눈금선이 있는 막대로 바뀌는 것을 확인할 수 있습니다. 봉 위에 마우스를 올리면 시가·고가·저가·종가가 툴팁으로 표시됩니다.
실무 팁: 캔들스틱 다음에 도입할 수 있는 금융 차트 유형
기본 구현을 마쳤다면 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
모듈로 추가할 수 있습니다.
자주 묻는 질문 (FAQ)
Wijmo FinancialChart는 어떤 컨트롤인가요?
wijmo.chart.finance
모듈에 정의되어 있습니다. 캔들스틱, OHLC, Heikin-Ashi, Renko, Kagi 등 다양한 금융 차트 유형과 거래량 차트를 chartType
속성 하나로 전환할 수 있습니다.자바스크립트로 캔들스틱(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
를 참조하면 번들러 없이도 동작합니다.OHLC 차트와 캔들스틱 차트는 무엇이 다른가요?
HighLowOpenClose
)는 시가를 왼쪽 선, 종가를 오른쪽 선으로 그려 몸통 없이 표현합니다.주가·금융 데이터를 시각화할 때 쓸 만한 JavaScript 차트 라이브러리는 무엇인가요?
FlexChart와 FinancialChart 중 무엇을 선택해야 하나요?
FlexChart
로도 구현할 수 있습니다. Heikin-Ashi, Renko, Kagi, 거래량 기반 차트처럼 금융 전용 유형이나 지표 확장이 필요하다면 처음부터 FinancialChart
로 시작하는 편이 좋습니다.
