CandleView 소개
CandleView는 AI(인공지능) 기술이 통합된 금융 시계열 데이터(Financial Time-Series Data) 시각화 및 렌더링 엔진입니다. React 기반의 컴포넌트로 제공되며, 주식이나 암호화폐 거래소에서 흔히 볼 수 있는 캔들스틱(Candlestick) 차트를 렌더링하는 것을 넘어, LLM(대규모 언어 모델)을 차트 분석에 직접 활용할 수 있도록 설계된 것이 가장 큰 특징입니다.
기존의 차트 라이브러리들이 단순히 데이터를 그래프로 보여주는 데 집중했다면, CandleView는 차트 데이터와 AI 에이전트를 연결하여 "현재 차트의 추세 분석"이나 "리스크 평가" 같은 인사이트를 자연어로 제공받을 수 있는 인터페이스를 내장하고 있습니다. 개발자는 이 라이브러리를 통해 별도의 복잡한 구현 없이도 'AI 분석 기능이 포함된 트레이딩 차트'를 자신의 웹 애플리케이션에 구축할 수 있습니다.
CandleView 프로젝트는 최신 프론트엔드 툴체인인 Vite와 React를 기반으로 구축되었으며, TypeScript로 작성되어 안정적인 타입 지원을 제공합니다. OpenAI, Alibaba Cloud(Qwen), DeepSeek, Google Gemini 등 다양한 최신 AI 모델 프로바이더를 지원하여 확장성이 뛰어납니다.
CandleView의 주요 기능
CandleView는 단순한 차트 렌더링을 넘어 다음과 같은 강력한 기능들을 제공합니다.
AI 기반 차트 분석 (AI-Driven Analysis)
AI 기반 차트 분석은 CandleView의 핵심 차별화 포인트입니다. 사용자가 보고 있는 차트의 OHLCV(Open, High, Low, Close, Volume) 데이터를 AI 모델에 전달하여 기술적 분석을 수행할 수 있습니다.
OpenAI의 GPT 시리즈를 비롯하여, Aliyun(Qwen), DeepSeek, Claude, Gemini 등의 다양한 LLM 사업자의 API 연동을 지원하며, 다음과 같은 기능들의 사용이 가능합니다:
-
차트 분석(Chart Analysis): 현재 차트의 기술적 지표와 추세를 분석합니다.
-
예측 분석(Predictive Analysis): 과거 데이터를 바탕으로 가격 예측 및 리스크 평가를 수행합니다.
또한, 차트 좌측 패널에서 AI 기능을 활성화하고, 채팅 인터페이스를 통해 AI와 대화하며 시장 상황을 분석할 수 있어, 사용자는 한 번에 차트와 분석 결과를 확인할 수 있습니다.
시각화 및 보조지표
CandleView는 캔들스틱(K-Line) 차트를 기본으로 하며, 1초 단위부터 1개월 단위까지 다양한 타임프레임(Timeframe) 을 지원합니다. 또한, 금융 데이터 분석에 필수적인 다양한 시각화 도구들을 내장하고 있습니다. 다음은 CandleView가 지원하는 보조 지표 종류입니다:
-
메인 차트: 이동평균선(MA), 지수이동평균(EMA), 볼린저 밴드(Bollinger Bands), 일목균형표(Ichimoku), 엔벨로프(Envelope), VWAP 등.
-
서브 차트: RSI, MACD, 거래량(Volume), KDJ, 스토캐스틱(Stochastic), CCI 등 다수의 보조지표를 지원합니다.
또한, 피보나치(Fibonacci), 간(Gann) 팬, 추세선, 박스 등 차트 위에 직접 작도할 수 있는 그리기 도구(Drawing Tools)도 제공합니다. 다음은 피보나치(Fibonacci) 도구 예시입니다:
| Arc | Channel | Circle |
|---|---|---|
 |
 |
 |
| Fan | Price Extension | Retracement |
 |
 |
 |
| Spiral | Time Expansion | Time Zoon |
 |
 |
 |
| Wedge | ||
 |
다음은 간(Gann) 도구 예시입니다:
| Box | Fan | Rectangle |
|---|---|---|
 |
 |
 |
다음은 차트 위에 직접 표시하는 예시입니다:
개발자 친화적 기능 및 커맨드 시스템
CandleView에는 차트 내부에 내장 터미널(CLI, Command Line Interface)이 내장되어 있어, 명령어로 테마를 변경하거나 지표를 켜고 끌 수 있습니다. (예: open ma, theme dark)
그 외에도 현재 보고 있는 차트 상태를 이미지로 저장하는 기능을 API로 제공하거나, 다국어 지원(i18n) 기능을 제공합니다. 기본적으로 영어(en)와 중국어(zh-cn)를 지원하며, 그 외 언어는 사용자가 직접 추가할 수 있습니다.
CandleView 설치 및 사용 방법
CandleView는 npm 패키지로 제공되므로 React 프로젝트에서 쉽게 설치하여 사용할 수 있습니다. 다음과 같이 npm 또는 yarn 명령어로 설치할 수 있습니다:
npm i candleview
# 또는
yarn add candleview
설치 후에는 React 컴포넌트 형태로 CandleView를 사용할 수 있으며, 데이터와 AI 설정을 props로 전달합니다. 다음은 기본적인 차트 구성 예시입니다:
import { CandleView } from "candleview";
const App = () => {
return (
<CandleView
data={candleData} // OHLCV 데이터 배열
title="BTC/USDT" // 차트 제목
theme="dark" // 테마 설정 (dark/light)
height={800} // 높이 설정
ai={true} // AI 기능 활성화
// 사용할 AI 모델 설정 (여러 API를 동시에 설정 가능)
aiconfigs={[
{
proxyUrl: "http://localhost:3000/api", // 프록시 서버 주소
brand: "openai",
model: "gpt-4-turbo",
},
{
brand: "deepseek",
model: "deepseek-chat",
proxyUrl: "..."
}
]}
/>
);
};
주의: AI 기능을 사용하기 위해서는 클라이언트에서 직접 API 키를 노출하는 대신, 프록시 서버(proxyUrl)를 통해 요청을 중계하는 것을 권장합니다.
라이선스
CandleView 프로젝트는 AGPL-3.0 라이선스로 공개 및 배포되고 있습니다. AGPL-3.0은 강력한 카피레프트(Copyleft) 라이선스로, 이 라이브러리를 사용하여 서비스를 네트워크로 제공할 경우, 해당 서비스의 전체 소스 코드를 동일한 라이선스로 공개해야 할 의무가 발생할 수 있습니다. 따라서, 상용 소프트웨어 개발 시 라이선스 정책을 면밀히 검토해야 합니다.
CandleView 홈페이지
CandleView 데모
예시 데이터를 표시하거나, JSON/CSV 데이터 업로드, 원격 데이터 등을 불러와 CandleView에 표시하고 확인해볼 수 있습니다.
CandleView 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 