公式
国内看盘软件写法的指标公式,直接变成专业图表里的指标:逐根 K 线实时计算,指标窗口里列出来,用户可以像自带指标一样添加、改参数和线条,也能在它上面加提醒。把公式写进 customIndicators(或晚一点用 registerIndicator() 注册),formula 代替算法的 definition:
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') 是中文的说明:
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,全部加完还不够时为已有的 K 线数。X 的无效值当 0。SAR(N,S,M):抛物线转向,S 是步长、M 是极限值,都按百分比,如SAR(10,2,20)。前 N 根 K 线没有值,用来定起点:之后那根的收盘高于第一根的收盘就从上涨开始,SAR 从这 N 根的最低价起步,否则从下跌开始,从最高价起步。之后每根向趋势的极值靠近,加速度从 S% 起,每创一次新极值加 S%,最多 M%;不进入前两根 K 线的范围;价格穿过时转向,从上一段趋势的极值重新开始。
周期
周期参数(如 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的周期写成负数是引用之后的 K 线(未来数据),报future-reference。 - 序列当周期时,每根 K 线用当根的周期值,小数部分截掉(2.7 当 2);周期是无效值或负数时,结果为无效值。
- 0 的意思和写成数字时一样:
SUM、HHV、LLV、HHVBARS、LLVBARS、COUNT和LAST的 A 写 0 表示从第一根 K 线算起,REF的 0 是当根。其他函数的周期至少是 1(STD、VAR、SLOPE、FORCAST至少是 2),更小就是无效值。 - 已有的 K 线比周期少时也和写成数字时一样:
COUNT、EXIST数已有的几根,EVERY、NDAY、UPNDAY、DOWNNDAY和LAST为 0,其他为无效值。 EMA、SMA这类递推的均线每根按当根的周期算,周期无效的那根结果为无效值,也不参与递推。
绘图函数
在 K 线上画出信号,写法和国内看盘软件的公式一样,单独成一句,后面可以跟颜色:
金叉:=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,宽度,空心) |
条件成立的 K 线上,从价格 1 到价格 2 画柱子。宽度 0 是一条细线,0.8 和 K 线实体一样宽,1.1 以上占满间距;空心不为 0 时只画边框 |
DRAWTEXT(条件,价格,'文字') |
在价格处写文字(以价格为中心) |
DRAWNUMBER(条件,价格,数字) |
在价格处写数字(以价格为中心),数字可以是序列。整数不带小数,其他数按公式的小数位数写,和图例一样 |
DRAWICON(条件,价格,图标) |
图标 1 是向上箭头,尖端从下方指向价格;2 是向下箭头,从上方指向价格;其他编号画圆点 |
POLYLINE(条件,价格) |
条件成立的点依次连成折线,中间的 K 线跳过;也可以写成 PLOYLINE |
VERTLINE(条件) |
条件成立的 K 线上画一条竖线,从窗格顶部到底部 |
DRAWLINE(条件1,价格1,条件2,价格2,延长) |
条件 1 成立时记下起点(再成立就换成新的起点),之后条件 2 成立时从起点画直线到这里,起点就用掉了,下一条线等条件 1 再成立。两个条件在同一根 K 线成立时,先在这里结束上一条线,再从这里开始新的一条。延长:0 不延长,1 向右延长到窗格边缘,2 或 10 向左,3 或 11 两头都延长 |
DRAWBAND(值1,颜色1,值2,颜色2) |
值 1 高于值 2 的地方用颜色 1 填满两个值之间,反之用颜色 2。颜色写 COLORRED 这样的颜色名或 COLOR 加六位 BBGGRR;填充是半透明的,不挡住 K 线 |
DRAWKLINE(最高,开盘,最低,收盘) |
用这四个值画 K 线,收盘不低于开盘的是涨,涨跌颜色跟随图表主题 |
PARTLINE(价格,条件1,颜色1,条件2,颜色2,…) |
画价格的线,每根 K 线用第一个成立的条件的颜色,都不成立的地方不画;一种颜色换成另一种的地方两段连在一起,所以是一条变色的线。条件和颜色可以给一对或几对 |
FILLRGN(价格1,价格2,条件1,颜色1,…) |
在两个价格之间填色,每根 K 线用第一个成立的条件的颜色,都不成立的地方不填;填充是半透明的,和 DRAWBAND 一样深 |
DRAWGBK(条件,颜色) |
条件成立的 K 线后面,整个窗格的背景染上淡淡的这种颜色,连着的几根连成一块;在 K 线下面,不挡 K 线 |
- 绘图函数的参数每根 K 线都会计算,条件不成立时也一样,所以
MA、REF这类函数放在参数里结果不变。 - 宽度、空心、图标编号、延长必须是数字或参数;文字要用引号括起来。
- 不写颜色时,箭头用图表主题的买入、卖出颜色,
DRAWKLINE用主题的涨跌颜色,其他图形依次用主题的线条颜色。国内看盘软件里 1、2 号图标固定是红、绿色,这里跟随主题,避免在绿涨红跌的图上把买入画成红色。 LINETHICK1–9设置线宽:普通的线和POLYLINE、DRAWLINE、VERTLINE都一样,1 是默认粗细,2–9 是 2–9 像素;DOTLINE、DASHLINE把它们画成点线、虚线。用户在指标设置里改的线宽优先。DRAWLINE不会预先画线:一条线在条件 2 成立的那根 K 线出现时才画上,画上之后不再改动。- 绘图不显示在图例里。坐标会为柱子两端、标记、数字、折线的各点、直线的两端和带状区域留出空间,竖线不占坐标;副图里只有绘图也能正常显示。
- 绘图函数要单独成一句,不能放进表达式或赋给名称。
引用其他公式
"公式名.线名" 读另一个公式的一条线,用的是那个公式的默认参数:
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、和无效值比较,结果都是无效值,图上不画。均线类函数会跳过无效值。 - K 线不足周期时的
HHV、LLV、SUM:已有的 K 线还不到周期时,这里是无效值(HHV(H,20)的前 19 根不画),和图表库内置指标一样;国内看盘软件一般用已有的几根算出值,所以开头这一段两边不一样,之后完全相同。要从第一根就有值,可以写IF(BARSCOUNT(C)>=20,HHV(H,20),HHV(H,0))(周期 0 是从第一根算起)。 - 暂不支持:其余绘图函数(
DRAWBMP、DRAWSL、DRAWTEXT_FIX等)、交易函数(BUY、SELL)、AMOUNT(K 线里没有成交额,结果为无效值)、跨周期引用(如"MACD.DIF#WEEK")。 - 时间:
DATE和国内看盘软件一样从 1900 年算起(2026-10-21 是1261021),TIME是HHMMSS(9:30 是93000),WEEKDAY中 0 是星期日。时间取 K 线的开始时间,而国内看盘软件的分钟线用的是结束时间:同一根 9:30–9:35 的 K 线,这里TIME是93000,那边是93500。 - 未来函数:
ZIG、PEAK、PEAKBARS、TROUGH、TROUGHBARS、BACKSET、REFX、REFXV、CONST、XMA、CURRBARSCOUNT、TOTALBARSCOUNT、ISLASTBAR、BARSTATUS、BARSNEXT、FILTERX会用到之后的 K 线:画出来的线和信号会随新 K 线改写(重绘),回看时好看,实时却等不到,所以不支持。写了会报future-function错误,指出位置,有别的写法时一并提示,比如ZIG找的高低点可以用HHV、LLV加BARSLAST求已经确认的,XMA可以换成MA。 - SAR 的起点:各家软件
SAR起步的写法不尽相同,这里的起点见上文;所以开头一段的数值和转向点可能和别的软件不一样,几次转向之后就相同了。起步那段过去之后(通常是开头几十根里的几次转向),和图表库内置的 SAR 每根都一致(参数换成小数:SAR(10,2,20)对应 0.02、0.02、0.2);N为 1 时从头到尾都一致。