수식
중국 시세 소프트웨어 방식으로 쓴 지표 수식이 그대로 프로 차트의 지표가 됩니다. 봉마다 실시간으로 계산하고, 지표 창에 나열되며, 사용자는 기본 제공 지표처럼 추가하고 파라미터와 선을 바꿀 수 있고, 알림도 걸 수 있습니다. 수식을 customIndicators에 쓰고(또는 나중에 registerIndicator()로 등록하고), 알고리즘의 definition 대신 formula를 씁니다:
import { createProChart, type CustomIndicator } from '@kumo-charts/pro-chart';
const MYMACD: CustomIndicator = {
name: { en: 'My MACD', zh: '我的 MACD' }, // 지표 창에서 코드 뒤에 나오는 이름
group: 'oscillators',
formula: {
type: 'MYMACD', // 코드. 지표 창과 범례에 표시되며, 기본 제공 지표와 같은 이름일 수 없음
name: 'MYMACD', // 범례의 이름
formula: `
DIF:EMA(CLOSE,SHORT)-EMA(CLOSE,LONG);
DEA:EMA(DIF,MID);
MACD:(DIF-DEA)*2,COLORSTICK;
`,
params: { SHORT: 12, LONG: 26, MID: 9 }
}
};
const chart = createProChart(container, {
datafeed,
symbol: '600519.SH',
customIndicators: [MYMACD]
});
chart.addIndicator('MYMACD', { params: { SHORT: 6 } });수식 지표의 라이선스는 상업 라이선스에 포함됩니다. name, group, origin은 다른 사용자 지표와 같습니다.
옵션
| 옵션 | 설명 |
|---|---|
type |
코드. 예: MYMACD. 지표 창, 범례, 상태에서 모두 이것을 쓰며, 기본 제공 지표나 다른 사용자 지표와 같은 이름일 수 없습니다 |
name |
범례에 표시하는 이름 |
formula |
수식 텍스트 |
params |
파라미터. 예: { N: 9 }. 범위를 붙일 수도 있습니다: { N: { default: 9, min: 1, max: 100, integer: true } }. 지표 설정 창은 이것에 따라 입력을 제한합니다 |
overlay |
true면 메인 창에 그리고, 아니면 따로 보조 창 하나에 그립니다 |
precision |
소수 자릿수. price는 가격을 따르고(메인 창에 그릴 때의 기본값), volume은 거래량용 |
levels |
수평 기준선. 예: [20, 80] |
range |
보조 창의 고정 스케일 범위. 예: { min: 0, max: 100 } |
timeZone |
시간 함수가 쓰는 시간대. 예: Asia/Shanghai. 기본값은 차트가 시간을 표시하는 시간대이며, 사용자가 시간대를 바꾸면 새 시간대로 다시 계산합니다 |
library |
참조할 수 있는 다른 수식. 아래 "다른 수식 참조" 참고 |
잘못 썼을 때
수식은 createProChart()나 registerIndicator() 때 컴파일되며, 잘못 쓰면 바로 FormulaError(@kumo-charts/pro-chart에서 가져옴)를 던집니다. code는 어떤 오류인지, span은 오류가 난 곳, describe('zh')는 중국어 설명입니다(describe()는 영어 설명):
import { FormulaError } from '@kumo-charts/pro-chart';
try {
await chart.registerIndicator({ formula: { type: 'X', name: 'X', formula: 'A:MA(C,N);' } });
} catch (error) {
if (error instanceof FormulaError) {
error.span; // { line: 1, column: 8, length: 1 }
error.describe('zh'); // "N"既不是前面定义过的变量、参数,也不是 CLOSE 这样的行情数据。
}
}문법
이름:식;은 선 하나를 그립니다.이름:=식;은 중간 변수만 정의합니다. 이름이 없는 식도 선을 그립니다.- 연산자:
+ - * /, 비교> < >= <= = <>, 논리AND OR NOT(&& || !로도 씀). 우선순위는 높은 것부터* /,+ -, 비교,NOT,AND,OR입니다. 그래서 괄호 없는NOT C>O는 중국 수식에서 흔히 쓰는NOT(C>O)와 같이 "양봉이 아님"입니다.NOT을 비교의 한쪽에 둘 때는 괄호가 필요하며,C>NOT(O)처럼 씁니다. - 이름은 대소문자를 구분하지 않고 중국어도 쓸 수 있습니다. 중국어 전각 문장 부호(
;:,())는 자동으로 인식하며, 따옴표 안의 글자는 그대로 둡니다('买入,加仓'의 전각 쉼표는 바뀌지 않음). 글자와 참조는 중국어 따옴표‘’,“”로 감쌀 수도 있으며, 영문 따옴표로 감싸면 안에 중국어 따옴표를 넣을 수 있습니다. - 주석:
{ … }와// …. - 시세 데이터:
OPEN/O,HIGH/H,LOW/L,CLOSE/C,VOL/V/VOLUME. - 선 속성:
COLORRED등의 색,COLOR에 여섯 자리 BBGGRR을 붙인 것,NODRAW,STICK,COLORSTICK,VOLSTICK,DOTLINE,DASHLINE,LINETHICK1–9(선 두께, "그리기 함수" 참고).
함수
| 분류 | 함수 |
|---|---|
| 이동평균 | MA EMA EXPMA SMA MEMA DMA WMA |
| 참조 | REF BARSLAST BARSSINCE BARSCOUNT BARSLASTCOUNT |
| 통계 | SUM HHV LLV HHVBARS LLVBARS COUNT EVERY EXIST SUMBARS STD STDP VAR VARP AVEDEV DEVSQ SLOPE FORCAST |
| 신호 | CROSS LONGCROSS FILTER VALUEWHEN LAST NDAY UPNDAY DOWNNDAY |
| 지표 | SAR |
| 시간 | DATE TIME YEAR MONTH DAY HOUR MINUTE WEEKDAY BARPOS |
| 논리 | IF IFF IFN NOT BETWEEN RANGE ISUP ISDOWN ISEQUAL |
| 수학 | ABS MAX MIN SQRT POW LN LOG EXP INTPART FRACPART CEILING FLOOR ROUND ROUND2 SIGN MOD REVERSE SIN COS TAN ASIN ACOS ATAN |
| 기타 | DRAWNULL |
몇몇 함수의 세부 사항:
LAST(X,A,B): A개 전부터 B개 전까지(양 끝 포함) 모든 봉에서 X가 성립하면 1. A가 0이면 첫 봉부터, B가 0이면 현재 봉까지입니다. 구간의 시작이 첫 봉보다 앞이거나 A가 B보다 작으면 0.NDAY(X,Y,N): 최근 N개 봉 모두에서 X>Y.UPNDAY(X,M),DOWNNDAY(X,M): 최근 M개 봉 모두가 직전 봉보다 큼(작음). 같으면 세지 않습니다.RANGE(A,B,C): A가 B보다 크고 C보다 작으면 1이며, 양 끝은 포함하지 않습니다. 양 끝도 포함하려면BETWEEN을 씁니다.ROUND(X)는 정수로,ROUND2(X,N)은 소수 N자리로 반올림합니다. 둘 다 반올림이며, 음수의 0.5도 0에서 멀어지는 쪽으로 반올림합니다(ROUND(-2.5)는 -3). 쓰인 그대로의 십진수로 반올림하므로ROUND2(1.005,2)는 1.01입니다. N의 소수 부분은 버리며, 음수면 무효값입니다.FRACPART(X)는 소수 부분이며 부호가 있습니다:FRACPART(-3.5)는 -0.5.VALUEWHEN(COND,X): COND가 마지막으로 성립한 봉의 X. 처음 성립하기 전에는 무효값.SUMBARS(X,A): 현재 봉부터 거슬러 X를 A 이상이 될 때까지 더하려면 몇 개가 필요한지. 현재 봉만으로 충분하면 1이고, 모두 더해도 모자라면 그때까지의 봉 수입니다. X의 무효값은 0으로 봅니다.SAR(N,S,M): 파라볼릭 SAR. S는 스텝, M은 한계값이며 둘 다 퍼센트로SAR(10,2,20)처럼 씁니다. 처음 N개 봉에는 값이 없으며 시작점을 정하는 데 씁니다. 그다음 봉의 종가가 첫 봉의 종가보다 높으면 상승으로 시작하고 SAR은 이 N개 봉의 최저가에서 출발하며, 아니면 하락으로 시작하고 최고가에서 출발합니다. 그 뒤로 봉마다 추세의 극값에 가까워지며, 가속도는 S%에서 시작해 새 극값을 낼 때마다 S%씩 늘어 최대 M%입니다. 직전 두 봉의 범위 안으로는 들어가지 않고, 가격이 교차하면 방향을 바꾸어 이전 추세의 극값에서 다시 시작합니다.
기간
기간 인수(MA(C,N)의 N 등)는 숫자, 파라미터, 또는 그 사칙연산일 수 있고, 계열일 수도 있습니다. HHV(H,BARSLAST(CROSS(C,MA(C,5)))+1)은 마지막으로 5일 이동평균을 상향 교차한 이후의 최고가, SUM(V,BARSLAST(CROSS(C,MA(C,5)))+1)은 그 기간의 거래량입니다. LONGCROSS, FILTER, SAR을 빼면 기간은 모두 계열일 수 있습니다.
- 숫자나 파라미터로 쓸 때 기간은 정수여야 하고 그 함수의 하한(다음 항목 참고) 이상이어야 하며, 그렇지 않으면 컴파일할 때
invalid-period를 알리며 하한이 얼마인지 밝힙니다.REF의 기간을 음수로 쓰면 그 뒤의 봉(미래 데이터)을 참조하게 되어future-reference를 알립니다. - 계열을 기간으로 쓰면 봉마다 그 봉의 기간 값을 쓰고, 소수 부분은 버립니다(2.7은 2). 기간이 무효값이거나 음수면 결과는 무효값입니다.
- 0의 의미는 숫자로 쓸 때와 같습니다.
SUM,HHV,LLV,HHVBARS,LLVBARS,COUNT와LAST의 A에 0을 쓰면 첫 봉부터 세고,REF의 0은 현재 봉입니다. 다른 함수의 기간은 최소 1(STD,VAR,SLOPE,FORCAST는 최소 2)이며, 더 작으면 무효값입니다. - 봉 수가 기간보다 적을 때도 숫자로 쓸 때와 같습니다.
COUNT,EXIST는 있는 만큼 세고,EVERY,NDAY,UPNDAY,DOWNNDAY와LAST는 0, 나머지는 무효값입니다. EMA,SMA같은 재귀형 이동평균은 봉마다 그 봉의 기간으로 계산하며, 기간이 무효한 봉은 결과가 무효값이고 재귀에도 참여하지 않습니다.
그리기 함수
봉 위에 신호를 그립니다. 쓰는 방식은 중국 시세 소프트웨어의 수식과 같으며, 따로 한 문장으로 쓰고 뒤에 색을 붙일 수 있습니다:
金叉:=CROSS(MA(C,5),MA(C,10));
DRAWICON(金叉,LOW,1);
DRAWTEXT(金叉,HIGH+MA(HIGH-LOW,20),'金叉'),COLORRED;
STICKLINE(VOL>MA(VOL,20)*2,OPEN,CLOSE,0.8,0),COLORYELLOW;
DRAWBAND(MA(C,5),COLORRED,MA(C,20),COLORGREEN);
DRAWLINE(H>=HHV(H,20),H,L<=LLV(L,20),L,1),COLORMAGENTA,LINETHICK2;| 함수 | 그리는 방식 |
|---|---|
STICKLINE(조건,가격1,가격2,너비,속빈) |
조건이 성립하는 봉에 가격 1부터 가격 2까지 기둥을 그립니다. 너비 0은 가는 선, 0.8은 캔들 몸통과 같은 너비, 1.1 이상은 간격을 꽉 채웁니다. 속빈이 0이 아니면 테두리만 그립니다 |
DRAWTEXT(조건,가격,'글자') |
가격 위치에 글자를 씁니다(가격을 중심으로) |
DRAWNUMBER(조건,가격,숫자) |
가격 위치에 숫자를 씁니다(가격을 중심으로). 숫자는 계열이어도 됩니다. 정수는 소수 없이, 나머지 수는 수식의 소수 자릿수로 범례와 같이 씁니다 |
DRAWICON(조건,가격,아이콘) |
아이콘 1은 위쪽 화살표로 끝이 아래에서 가격을 가리키고, 2는 아래쪽 화살표로 위에서 가격을 가리킵니다. 다른 번호는 점을 그립니다 |
POLYLINE(조건,가격) |
조건이 성립하는 점을 차례로 꺾은선으로 잇고, 사이의 봉은 건너뜁니다. PLOYLINE으로도 쓸 수 있습니다 |
VERTLINE(조건) |
조건이 성립하는 봉에 창의 위쪽 끝부터 아래쪽 끝까지 세로선을 긋습니다 |
DRAWLINE(조건1,가격1,조건2,가격2,연장) |
조건 1이 성립하면 시작점을 기록하고(다시 성립하면 새 시작점으로 바뀜), 그 뒤 조건 2가 성립하면 시작점부터 거기까지 직선을 긋습니다. 시작점은 거기서 다 쓰고, 다음 선은 조건 1이 다시 성립하기를 기다립니다. 두 조건이 같은 봉에서 성립하면 먼저 거기서 이전 선을 끝내고, 그다음 거기서 새 선을 시작합니다. 연장: 0은 연장 안 함, 1은 창 오른쪽 끝까지 연장, 2나 10은 왼쪽으로, 3이나 11은 양쪽으로 연장 |
DRAWBAND(값1,색1,값2,색2) |
값 1이 값 2보다 높은 곳은 색 1로, 반대는 색 2로 두 값 사이를 채웁니다. 색은 COLORRED 같은 색 이름이나 COLOR에 여섯 자리 BBGGRR을 붙여 씁니다. 채우기는 반투명이라 봉을 가리지 않습니다 |
DRAWKLINE(고가,시가,저가,종가) |
이 네 값으로 캔들을 그립니다. 종가가 시가보다 낮지 않으면 상승이며, 상승·하락 색은 차트 테마를 따릅니다 |
PARTLINE(가격,조건1,색1,조건2,색2,…) |
가격의 선을 그리며, 봉마다 처음 성립하는 조건의 색을 쓰고, 아무것도 성립하지 않는 곳은 그리지 않습니다. 색이 바뀌는 곳에서 두 구간이 이어지므로 색이 바뀌는 선 하나가 됩니다. 조건과 색은 한 쌍이나 여러 쌍을 줄 수 있습니다 |
FILLRGN(가격1,가격2,조건1,색1,…) |
두 가격 사이를 채우며, 봉마다 처음 성립하는 조건의 색을 쓰고, 아무것도 성립하지 않는 곳은 채우지 않습니다. 채우기는 반투명이며 DRAWBAND와 같은 농도입니다 |
DRAWGBK(조건,색) |
조건이 성립하는 봉 뒤로 창 전체의 배경을 그 색으로 옅게 물들이며, 이어진 봉들은 한 덩어리로 이어집니다. 봉 아래에 있어 봉을 가리지 않습니다 |
- 그리기 함수의 인수는 조건이 성립하지 않을 때도 봉마다 계산하므로,
MA,REF같은 함수를 인수에 넣어도 결과가 바뀌지 않습니다. - 너비, 속빈, 아이콘 번호, 연장은 숫자나 파라미터여야 하고, 글자는 따옴표로 감싸야 합니다.
- 색을 쓰지 않으면 화살표는 차트 테마의 매수·매도 색을,
DRAWKLINE은 테마의 상승·하락 색을, 다른 도형은 테마의 선 색을 차례로 씁니다. 중국 시세 소프트웨어에서는 1번, 2번 아이콘이 빨강, 초록으로 고정이지만, 여기서는 테마를 따라 초록이 상승인 차트에서 매수를 빨강으로 그리지 않게 합니다. LINETHICK1–9는 선 두께를 정합니다. 일반 선과POLYLINE,DRAWLINE,VERTLINE모두 같으며, 1이 기본 두께, 2–9는 2–9픽셀입니다.DOTLINE,DASHLINE은 그것을 점선, 파선으로 그립니다. 사용자가 지표 설정에서 바꾼 선 두께가 우선합니다.DRAWLINE은 미리 선을 긋지 않습니다. 선은 조건 2가 성립하는 봉이 나타날 때 그어지며, 그은 뒤에는 바뀌지 않습니다.- 그리기는 범례에 표시되지 않습니다. 스케일은 기둥의 양 끝, 표시, 숫자, 꺾은선의 각 점, 직선의 양 끝과 띠 영역을 위한 공간을 남기며, 세로선은 공간을 차지하지 않습니다. 그리기만 있는 보조 창도 제대로 표시됩니다.
- 그리기 함수는 따로 한 문장이어야 하며, 식에 넣거나 이름에 대입할 수 없습니다.
다른 수식 참조
"수식이름.선이름"으로 다른 수식의 선 하나를 읽으며, 그 수식의 기본 파라미터를 씁니다:
XG:CROSS("MACD.DIF","MACD.DEA") AND "KDJ.J"<20;뒤에 괄호를 붙이면 자체 파라미터를 줄 수 있습니다. 그 수식 파라미터의 순서대로 각각 숫자나 이 수식의 파라미터이며, 주지 않은 것은 기본값을 씁니다:
快:"MACD.DIF"(5,20); 慢:"MACD.DIF"; 金叉:CROSS("MACD.DIF"(N,20,9),"MACD.DEA"(N,20,9));- 기성 수식은 모두 이름으로 참조할 수 있습니다:
MA,BOLL,MACD,KDJ,RSI,CCI,WR,BIAS,TRIX,OBV. - 자신의 수식도
library옵션에 넣으면 참조할 수 있으며, 같은 이름이면 기성 수식보다 우선합니다:{ library: { 我的均线: { formula: 'FAST:MA(C,N);', params: { N: 5 } } } }. - 이름은 대소문자를 구분하지 않으며, 중국어 따옴표
“”도 됩니다. - 같은 수식을 같은 파라미터로 여러 번 참조해도 한 번만 계산합니다. 서로 참조해 순환하거나, 없는 수식이나 선을 참조하면 오류를 내고 위치를 가리킵니다. 수식은 자기 코드(
type)로 자신을 알아봅니다. 같은 이름의 수식을 참조하면 자기 자신을 참조하는 것이 되며, 범례에 표시하는name은 치지 않으므로name: 'MACD'인 수식도 기성"MACD.DIF"를 그대로 참조할 수 있습니다. - 참조된 수식 자체가 잘못되었으면
broken-reference를 알리며, 위치는 참조한 곳을 가리키고, 설명에 그 수식이 몇 행 몇 열에서 무엇이 틀렸는지가 들어갑니다.error.referenced는 그 수식 원래의FormulaError입니다.
중국 시세 소프트웨어와의 차이
- 무효값: 데이터가 모자랄 때(예:
MA(C,5)의 처음 4개 봉), 0으로 나눌 때, 무효값과 비교할 때는 모두 결과가 무효값이며 차트에 그리지 않습니다. 이동평균 계열 함수는 무효값을 건너뜁니다. - 봉이 기간보다 적을 때의
HHV,LLV,SUM: 봉 수가 아직 기간에 미치지 못하면 여기서는 무효값이며(HHV(H,20)의 처음 19개 봉은 그리지 않음), 차트 라이브러리의 기본 제공 지표와 같습니다. 중국 시세 소프트웨어는 보통 있는 봉만으로 값을 계산하므로 처음 구간은 서로 다르고, 그 뒤로는 완전히 같습니다. 첫 봉부터 값이 있게 하려면IF(BARSCOUNT(C)>=20,HHV(H,20),HHV(H,0))처럼 씁니다(기간 0은 첫 봉부터 셈). - 아직 지원하지 않음: 나머지 그리기 함수(
DRAWBMP,DRAWSL,DRAWTEXT_FIX등), 매매 함수(BUY,SELL),AMOUNT(봉에 거래대금이 없어 결과는 무효값), 주기를 넘나드는 참조(예:"MACD.DIF#WEEK"). - 시간:
DATE는 중국 시세 소프트웨어와 같이 1900년부터 세고(2026-10-21은1261021),TIME은HHMMSS(9:30은93000),WEEKDAY의 0은 일요일입니다. 시간은 봉의 시작 시간을 쓰지만, 중국 시세 소프트웨어의 분봉은 끝 시간을 씁니다. 같은 9:30–9:35 봉에서 여기서는TIME이93000, 그쪽은93500입니다. - 미래 함수:
ZIG,PEAK,PEAKBARS,TROUGH,TROUGHBARS,BACKSET,REFX,REFXV,CONST,XMA,CURRBARSCOUNT,TOTALBARSCOUNT,ISLASTBAR,BARSTATUS,BARSNEXT,FILTERX는 그 뒤의 봉을 씁니다. 그린 선과 신호가 새 봉이 오면서 다시 쓰이므로(리페인트) 돌이켜 볼 때는 보기 좋아도 실시간으로는 얻을 수 없어 지원하지 않습니다. 쓰면future-function오류를 내고 위치를 가리키며, 다른 방식이 있으면 함께 알려 줍니다. 예를 들어ZIG가 찾는 고점·저점은HHV,LLV에BARSLAST를 더해 이미 확정된 것을 구할 수 있고,XMA는MA로 바꿀 수 있습니다. - SAR의 시작점: 소프트웨어마다
SAR을 시작하는 방식이 조금씩 다르며, 여기서의 시작점은 위에서 설명한 대로입니다. 그래서 처음 구간의 값과 전환점은 다른 소프트웨어와 다를 수 있고, 몇 번 전환한 뒤에는 같아집니다. 시작 구간이 지나면(보통 처음 수십 개 봉 안에서 몇 번 전환한 뒤) 차트 라이브러리의 기본 제공 SAR과 봉마다 일치합니다(파라미터를 소수로:SAR(10,2,20)은 0.02, 0.02, 0.2에 대응).N이 1이면 처음부터 끝까지 일치합니다.