Kumo Charts

アラート

アラートモジュールは価格、インジケーター、描画を監視し、条件を満たすと alertTrigger を発生させます。固定の価格に置いたアラートはチャート上に 1 本のラインとして表示され、ユーザーがドラッグできます。

コードを表示コードを隠す
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 }, // 描画(各足での位置)。level を省くと最初のライン
  { kind: 'series', id: ethId } // 追加したシリーズ
];

value は比較の相手です。固定の価格、別の値、チャネルの 2 本の境界のいずれかを指定します。

// 価格がトレンドラインを上抜ける
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(デフォルト) 1 回発動したら止まり、状態が triggered になる。rearm() で再び有効にする
once-per-bar 1 本の足につき最大 1 回。条件を満たしたその更新で発動する
once-per-bar-close 終値だけを見る。次の足が始まったときに 1 本前の足を判定する
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 は条件を満たした足、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() を使います。描画はしませんが、チャートと同じようにバーから時間足を作り、インジケーターと各バーでの描画のラインの価格を計算してアラートを判定するため、同じバー・インジケーター・描画ならチャートとまったく同じアラートが発火します。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' }); // ソース間隔のバー
engine.data.setTimeframe('15m'); // 15 分足で判定する
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() で変更します。インジケーターが最初の値を出すには十分なバーが必要です。足りなければ data.prepend() で過去のバーを追加し、indicators.valuesAt() で各バーの値を確認できます。

↑↓ で選択 · Enter で開く · Esc で閉じる