提醒
提醒模块盯着价格、指标或画线,满足条件时发出 alertTrigger。固定价位的提醒在图上显示成一条线,用户可以拖动。
显示代码收起代码
import { createChart } from '@kumo-charts/core';
import { alerts } from '@kumo-charts/core/alerts';
import { loadBars } from '@docs/data';
const chart = createChart(document.getElementById('chart')!, { modules: [alerts()] });
chart.data.set(await loadBars(), { interval: '1m' });
chart.data.setTimeframe('15m');
const last = chart.data.last()!;
chart.alerts.add({ id: 'above', trigger: 'cross-up', value: last.close * 1.01, label: '突破' });
chart.alerts.add({ id: 'below', trigger: 'cross-down', value: last.close * 0.99, label: '跌破' });添加
chart.alerts.add({
id: 'btc-100k', // 你的提醒 id,不给的话图表编一个
trigger: 'cross-up', // 条件
value: 100000, // 价位
frequency: 'once', // 触发几次
label: '10 万' // 线上的文字
});id 通常就是你的应用或服务器里这条提醒的 id;不给的话图表从 alert-1 起编号。add() 返回这条提醒的 id。
chart.alerts.update('btc-100k', { value: 105000 });
chart.alerts.remove('btc-100k');
chart.alerts.set(alertsFromServer); // 整批替换
chart.alerts.clear(); // 全部去掉
chart.alerts.list();
chart.alerts.get('btc-100k'); // 带上 status:'active'、'triggered'、'disabled'条件
trigger |
什么时候触发 |
|---|---|
cross-up |
从下往上穿过 |
cross-down |
从上往下穿过 |
cross |
任意方向穿过 |
above |
在上方 |
below |
在下方 |
enter-channel |
进入通道 |
exit-channel |
离开通道 |
inside-channel |
在通道里 |
outside-channel |
在通道外 |
穿过、进出是和上一次比较:上一次在下面、这一次在上面才算穿过;上一次在通道外(或正好在边上)、这一次在通道里才算进入,离开反过来。一次从通道一边跳到另一边,比如通道 100 到 110,上一次 95、这一次 115,既不算进入也不算离开。在上方、在下方、在通道里外只看这一次。
盯什么
source 是被盯着的值,默认是主图的收盘价。可以是:
const sources: ValueSource[] = [
{ kind: 'price', field: 'high' }, // 主图的某个价格
{ kind: 'indicator', id: maId, key: 'ma20' }, // 某个指标的某条线,key 不给就是第一条
{ kind: 'drawing', id: lineId }, // 一条画线(在每根 K 线上的位置),level 不给就是第一条线
{ kind: 'series', id: ethId } // 叠加的图形
];value 是和它比较的东西:一个固定价位,或者另一个值,或者通道的两条边:
// 价格向上穿过一条趋势线
chart.alerts.add({ id: 'a', trigger: 'cross-up', value: { kind: 'drawing', id: trendLineId } });
// MACD 金叉:MACD 线向上穿过信号线
chart.alerts.add({
id: 'b',
source: { kind: 'indicator', id: macdId, key: 'macd' },
trigger: 'cross-up',
value: { kind: 'indicator', id: macdId, key: 'signalLine' }
});
// 价格离开一个矩形
chart.alerts.add({
id: 'c',
trigger: 'exit-channel',
value: [
{ kind: 'drawing', id: rectId, level: 'top' },
{ kind: 'drawing', id: rectId, level: 'bottom' }
]
});盯指标要载入指标模块,盯画线要载入画线模块。一条画线有哪些线可以盯,用 chart.drawings.levels(id) 查。被提醒盯着的指标或画线不能删,要先删提醒,否则会报错并告诉你是哪几条提醒在用。
触发几次
frequency |
意思 |
|---|---|
once(默认) |
触发一次就停,状态变成 triggered,rearm() 重新打开 |
once-per-bar |
每根 K 线最多一次,满足条件的那一笔就触发 |
once-per-bar-close |
只看收盘,下一根开始时判断上一根 |
every-time |
每次更新满足条件都触发 |
chart.alerts.rearm('btc-100k');
chart.alerts.update('btc-100k', { enabled: false }); // 暂停触发了
chart.on('alertTrigger', ({ id, time, value, threshold, replay }) => {
if (replay) return; // 回放历史时触发的,通常不用通知
notify(`${id}:${value} 穿过了 ${threshold}`);
});time 是满足条件的那根 K 线,value 是被盯的值,threshold 是当时的价位(盯通道时是穿过的那条边)。
在图上拖动
固定价位的提醒显示成一条线,用户可以拖。拖动时发出 alertDrag,提醒跟着变,松手时留在新的价位:
chart.on('alertDrag', ({ id, phase, price }) => {
if (phase === 'end') saveAlert(id, { value: price });
});线的样子:
chart.alerts.add({
id: 'x',
trigger: 'cross',
value: 98000,
color: '#e3a33b', // 默认用主题的 alert 颜色
lineStyle: 'dashed',
draggable: true, // 能不能拖
visible: true, // 显不显示线
buttons: [{ id: 'remove', text: '✕' }] // 标签上的按钮,点击发出 buttonClick
});
chart.on('buttonClick', ({ kind, id, buttonId }) => {
if (kind === 'alert' && buttonId === 'remove') chart.alerts.remove(id);
});页面关了也要提醒
图表里的提醒只在页面开着时工作。要在服务器上一直盯着,用 @kumo-charts/core/alert-engine 的 createAlertEngine():它不画图,但和图表一样把 K 线合成周期、算指标、算画线在每根 K 线上的价位、判断提醒,同样的 K 线、指标和画线,触发的和图表上的一模一样。它能在 Node.js 里运行。
import { createAlertEngine } from '@kumo-charts/core/alert-engine';
import { trendLine } from '@kumo-charts/core/drawings';
import { RSI } from '@kumo-charts/core/indicators';
const engine = createAlertEngine({ indicators: [RSI], drawings: [trendLine] });
engine.data.set(bars, { interval: '1m' }); // 来源周期的 K 线
engine.data.setTimeframe('15m'); // 按 15 分钟的 K 线判断
engine.indicators.add({ id: 'rsi', type: 'RSI' });
engine.drawings.add({
id: 'support',
type: 'trend-line',
points: [
{ time: '2026-05-01T08:00:00Z', price: 94200 },
{ time: '2026-05-03T16:00:00Z', price: 96800 }
]
});
engine.alerts.set([
{ id: 'rsi-70', source: { kind: 'indicator', id: 'rsi' }, trigger: 'cross-up', value: 70 },
{
id: 'support',
trigger: 'cross-down',
value: { kind: 'drawing', id: 'support' },
frequency: 'once-per-bar-close'
}
]);
engine.on('alertTrigger', (event) => {
notify(`${event.id}: ${String(event.value)}`);
});
onTrade((trade) => engine.data.addTrades(trade)); // 实时成交接着喂进来data、indicators、drawings、alerts 的用法和图表上的一样,只是没有只和画面有关的部分(窗格、颜色、拖动)。指标和画线的类型在 createAlertEngine() 里给,就像给图表的模块;交易日历用 calendar 选项,和图表的 calendar 选项一样,setCalendar() 换成另一个。指标要算出第一个值需要足够多的 K 线,不够时用 data.prepend() 往前补;indicators.valuesAt() 看某根 K 线上的值。