インジケーター
インジケーターモジュールには 87 種類のインジケーターがあり、移動平均、MACD、RSI から一目均衡表、VWAP までそろっています。世界的に広く使われているインジケーターは、計算方法もデフォルトのパラメーターも国際的に一般的なものと同じです。KDJ や BIAS のように中国でよく使われるインジケーターは、中国で広く使われているソフトの計算式に従います。
コードを表示コードを隠す
import { createChart } from '@kumo-charts/core';
import { indicators, allIndicators } from '@kumo-charts/core/indicators';
import { loadBars } from '@docs/data';
const chart = createChart(document.getElementById('chart')!, {
modules: [indicators(allIndicators)]
});
chart.data.set(await loadBars(), { interval: '1m' });
chart.data.setTimeframe('1h');
chart.indicators.add({ type: 'EMA', params: { periods: [20, 50] } });
chart.indicators.add({ type: 'BOLL' });
chart.indicators.add({ type: 'MACD' });
chart.indicators.add({ type: 'RSI' });読み込み
import { indicators, allIndicators, MA, MACD, RSI } from '@kumo-charts/core/indicators';
createChart(container, { modules: [indicators(allIndicators)] }); // すべて
createChart(container, { modules: [indicators([MA, MACD, RSI])] }); // この数種類だけ追加
const id = chart.indicators.add({ type: 'RSI' });add() はインジケーターの id を返します。指定した id、またはチャートが種類ごとに振った番号(rsi-1 など)です。書かなかった設定にはそのインジケーターのデフォルト値が使われるので、変えたいものだけを書きます。
chart.indicators.add({
type: 'MA',
params: { periods: [20, 60, 120] }, // パラメーター
source: 'hlc3', // 計算に使う価格。デフォルトは終値
pane: 'main', // 描くペイン:'main'、'new'(新しいペインを開く)、または既存のペインの id
scale: 'right', // ペインのどの価格軸を使うか
colors: { ma20: '#e8b04a' }, // 出力ごとに色を変える
styles: { ma120: { lineWidth: 2, lineStyle: 'dashed' } }, // 出力ごとに線の太さや種類を変える、または非表示にする
levels: [], // 基準線。RSI の 70、30 など。[] なら描かない
visible: true
});移動平均のようにメインペインに重ねるインジケーターはデフォルトで pane: 'main' になり、MACD や RSI のようなものはデフォルトで専用のペインを開きます。ペインを参照してください。
変更と削除
chart.indicators.update(id, { params: { period: 21 } });
chart.indicators.update(id, { colors: { rsi: null } }); // null でデフォルトの色に戻す
chart.indicators.update(id, { levels: null }); // デフォルトの基準線に戻す
chart.indicators.update(id, { visible: false }); // 非表示
chart.indicators.update(id, { lastValueLabel: true }); // 各ラインの最新値を価格軸に表示。デフォルトはオフ
chart.indicators.update(id, { pane: 'new' }); // 専用のペインに移す。'main' でメインペインに戻す
chart.indicators.remove(id);
chart.indicators.list(); // すべてのインジケーター
chart.indicators.get(id);
chart.indicators.set([{ type: 'MA' }, { type: 'RSI' }]); // まとめて置き換える
chart.indicators.clear(); // すべて削除アラートが監視しているインジケーターは、そのままでは削除できません。先にアラートを削除してください。set() で置き換えるときや clear() で消すときも同じです。
値を読む
chart.indicators.valuesAt(id); // 最新の足の値
chart.indicators.valuesAt(id, 120); // 120 本目の足の値
// [{ key: 'rsi', label: 'RSI', value: 63.2, text: '63.20', color: '#…' }, …]凡例に表示されるものと同じです。text はインジケーターの小数点以下の桁数で整形済みの文字列、color はそのラインの色です。ある足でそのラインに値がないとき(たとえば RSI の計算に必要な本数の足がまだそろっていないとき)、value は null になります。
インジケーターからインジケーターを計算する
source には別のインジケーターのラインも指定できます。たとえば RSI の EMA は次のように書きます。
const rsiId = chart.indicators.add({ type: 'RSI' });
chart.indicators.add({
type: 'EMA',
source: { kind: 'indicator', id: rsiId, key: 'rsi' },
pane: rsiId // RSI と同じペインに描く
});key を書かなければ、そのインジケーターの最初のラインを使います。ほかのインジケーターに使われているインジケーターは、先に削除することはできません。
別の時間足で計算する
timeframe を指定すると、インジケーターをチャートより長い時間足で計算します。たとえば 5 分足のチャートに 1 時間足の移動平均線を表示できます。
コードを表示コードを隠す
import { createChart } from '@kumo-charts/core';
import { indicators, allIndicators } from '@kumo-charts/core/indicators';
import { loadBars } from '@docs/data';
const chart = createChart(document.getElementById('chart')!, {
modules: [indicators(allIndicators)]
});
chart.data.set(await loadBars(), { interval: '1m' });
chart.data.setTimeframe('5m');
chart.indicators.add({ type: 'MA', params: { periods: [20] }, timeframe: '1h' }); // 1 時間足の 20 本移動平均
chart.indicators.add({ type: 'MA', params: { periods: [20] } }); // 5 分足の 20 本移動平均インジケーターが使う 1 時間足は、チャートの元の足から取引カレンダーに従って合成され、時間足を切り替えるときに合成される足と同じです。リアルタイムデータ、過去に読み込んだ履歴、カレンダーの変更、リプレイにも追従します。同じ時間足のインジケーターは 1 組の足を共有します。
大きい時間足の確定を待つ:チャートの各足に表示されるのは、その足が終わるまでに確定した最後の 1 時間足の値です。1 時間足は次の 1 時間足が始まった時点で確定するので、値は各 1 時間の最後の 5 分足で変わり、階段状に描かれます。こうして過去のどの足も、その時点でまだなかったデータを使いません。例外は最新の足で、まだ確定していない 1 時間足の値をリアルタイムに表示します。足は次の足が始まる時点で終わるものとして扱うので、時間足が割り切れない場合(3 分足チャート上の 5 分足インジケーター)や、週末・休場をまたぐ場合も同じ規則です。
計算できないときはチャートの足で計算する:チャートの時間足がインジケーターの時間足より短くないとき(日足チャート上の 1 時間足インジケーターなど)、元の足からその時間足を合成できないとき(合成できる時間足を参照)、または時間に沿わない足を表示しているとき(練行足など。チャートタイプを参照)は、timeframe を指定しなかった場合と同じくチャートの足で計算します。エラーにはならず、消えることもありません。計算できるようになれば自分の時間足に戻ります。平均足のように 1 本ずつ変換するものは影響しません。長さを比べるとき、秒・分・時間は実際の長さで、1 日は 24 時間、1 週は 7 日、1 か月は 30 日として数えます。
offset はインジケーター自身の時間足の本数でずらします。たとえば 1 時間足の一目均衡表の先行スパンは 1 時間足 26 本分右に描かれます。同じ大きい時間足の足に付くマーカーは 1 回だけ描きます。凡例ではパラメーターのあとに時間足を書きます(MA 20 1h)。保存した状態にも含まれます。
chart.indicators.get(id)?.timeframe; // '1h'。指定がなければ null
chart.indicators.update(id, { timeframe: '4h' }); // 4 時間足に変える
chart.indicators.update(id, { timeframe: null }); // チャートの足に戻す別のインジケーターから計算するインジケーターは、そのインジケーターの時間足でその値から計算し、表示の規則も同じです。
const hourlyRsi = chart.indicators.add({ type: 'RSI', timeframe: '1h' });
chart.indicators.add({
type: 'EMA',
source: { kind: 'indicator', id: hourlyRsi }, // これも 1 時間足で計算する
pane: hourlyRsi
});これに別の timeframe を指定するとエラーになります。チャートなしで計算する computeIndicator() は変わりません。渡された足の時間足で計算します。
設定画面を作る
インジケーターにどんなパラメーターがあり、それぞれがどの範囲を取るかは、定義から読み取れます。
const definition = chart.indicators.definition('RSI');
definition?.params; // { period: { default: 14, min: 1, max: 2000, integer: true, label: 'RSI Length' }, … }options を持つパラメーターはその中の値しか取れないので(移動平均の種類など)、画面ではドロップダウンにします。ユーザーが入力した設定は、先に checkIndicatorInput() でチェックしてください。正しくなければ add() と同じエラーを投げます。
import { checkIndicatorInput } from '@kumo-charts/core/indicators';
checkIndicatorInput(chart.indicators.definition('RSI')!, userInput);多言語
インジケーターの定義は、名前やラベルを英語で書いています。凡例と valuesAt() をチャートの locale に合わせて中国語・日本語・韓国語で表示するには、ライブラリに付いている訳語 indicatorTexts をモジュールに渡します。
import { createChart } from '@kumo-charts/core';
import { indicators, allIndicators, indicatorTexts } from '@kumo-charts/core/indicators';
createChart(container, {
modules: [indicators(allIndicators, { texts: [indicatorTexts] })],
locale: 'zh-CN'
});渡さなければ英語のままで、indicatorTexts もバンドルに含まれません。MA や RSI のような略号はどの言語でも同じなので訳しません。
設定画面を作るときは、chart.indicators.title(type) がインジケーターの正式名を、chart.indicators.label(text) が定義のラベル(ライン、パラメーター、選択肢の名前)をチャートの言語で返します。
chart.indicators.title('BOLL'); // '布林带'
chart.indicators.label('Period'); // '周期'訳語は言語ごと、英語の原文ごとに書き、後から渡したものが優先されます。独自のインジケーターを多言語にしたいときや、いくつかの言葉を変えたいときは、もう 1 つ渡します。数字で終わるラベル(Upper Band #2 など)に専用の訳語がなければ、Upper Band #{n} の訳語の {n} をその数字に置き換えて使います。
import { indicators, allIndicators, indicatorTexts } from '@kumo-charts/core/indicators';
indicators(allIndicators, {
texts: [indicatorTexts, { zh: { labels: { Upper: '上沿' } } }]
});チャートがないとき(チャートより先に設定画面を開く場合など)は、indicatorLanguage(texts, locale) が同じ規則で title() と label() を返します。
組み込みインジケーター
下の表の「出力」は各ラインの key で、値を読むとき、色を設定するとき、アラートを設定するときに使います。移動平均のように一度に複数の期間を指定できるものは、出力の key に期間が付きます(例:ma20)。
移動平均
| タイプ | 名前 | デフォルトのパラメーター | 出力 |
|---|---|---|---|
MA |
単純移動平均 | 期間 9 | ma9 |
EMA |
指数平滑移動平均 | 期間 9 | ema9 |
SMMA |
平滑移動平均 | 期間 7 | smma7 |
WMA |
加重移動平均 | 期間 9 | wma9 |
HMA |
ハル移動平均 | 期間 9 | hma9 |
VWMA |
出来高加重移動平均 | 期間 20 | vwma20 |
ALMA |
アルノー・ルグー移動平均 | 9、オフセット 0.85、σ 6 | alma |
KAMA |
カウフマン適応型移動平均 | 10、短期 2、長期 30 | kama |
ALLIGATOR |
アリゲーター | 13・8・5、右へ 8・5・3 本ずらす | jaw、teeth、lips |
BBI |
ブル・ベア指数(中国式) | 3・6・12・24 | bbi |
DEMA |
二重指数移動平均 | 期間 9 | dema |
TEMA |
三重指数移動平均 | 期間 9 | tema |
LSMA |
最小二乗移動平均 | 25、オフセット 0 | lsma |
MCGINLEY |
マクギンリー・ダイナミック | 14 | mcginley |
RIBBON |
移動平均リボン | 20・50・100・200、すべて SMA | ma1、ma2、ma3、ma4 |
チャネル
| タイプ | 名前 | デフォルトのパラメーター | 出力 |
|---|---|---|---|
BOLL |
ボリンジャーバンド | 20、SMA、標準偏差の 2 倍 | basis、upper、lower |
KC |
ケルトナーチャネル | 20、EMA、ATR(10)の 2 倍 | upper、basis、lower |
DC |
ドンチャンチャネル | 20 | basis、upper、lower |
ICHIMOKU |
一目均衡表 | 9・26・52、ずらし 26 | conversionLine、baseLine、laggingSpan、leadingSpanA、leadingSpanB |
VWAP |
出来高加重平均価格 | 取引日ごとに計算し直す、標準偏差 1 倍のバンド | vwap、upperBand1、lowerBand1 |
ENVELOPE |
エンベロープ | 20、SMA、10% | basis、upper、lower |
MIKE |
MIKE 支持・抵抗線(中国式) | 10 | stor、midr、wekr、weks、mids、stos |
トレンドとストップ
| タイプ | 名前 | デフォルトのパラメーター | 出力 |
|---|---|---|---|
SAR |
パラボリック SAR | 0.02、0.02、0.2 | parabolicSar |
SUPERTREND |
スーパートレンド | 10、ATR の 3 倍 | upTrend、downTrend |
CHANDELIER |
シャンデリア・エグジット | 22、ATR 22、3 倍 | longExit、shortExit |
DMI |
方向性指数 | ADX の平滑化 14、DI 14 | adx、plus、minus |
AROON |
アルーン | 14 | aroonUp、aroonDown |
FRACTALS |
ウィリアムズ・フラクタル | 2 | downFractal、upFractal |
VSTOP |
ボラティリティ・ストップ | 20、ATR 2 倍 | upTrend、downTrend |
CKSTOP |
シャンデ・クロール・ストップ | ATR 10、1 倍、ストップ期間 9 | stopLong、stopShort |
VORTEX |
ボルテックス指標 | 14 | viPlus、viMinus |
PIVOTHL |
ピボット高値・安値 | 高値・安値とも左右 10 本 | pivotHigh、pivotLow |
ZIGZAG |
ジグザグ | 乖離 5%、深さ 10 | zigZag、high、low |
ピボット高値・安値とジグザグは、ピボットの右側の足が確定してからピボットを見つけ、ピボットの足にさかのぼって描きます。ピボット高値・安値は各ピボットに三角形を描き、価格を書きます。
ジグザグのピボットは、左右それぞれ深さの半分の本数の足の中で最も高い(安い)足で、前のピボットから乖離のパーセント以上離れたときだけ向きを変えます。同じ向きでさらに先のピボットが出ると最後のピボットがそこへ移るので、ラインの最後の区間は相場につれて変わります。ラインはデフォルトで最新の足まで延び、各ピボットの横に価格、前のピボットからの変化(changeMode: 1 でパーセント)、2 つのピボットの間の累積出来高を書きます。showPrice、showChange、showVolume で切り替え、extend: 0 で延長しません。
出力には各足がその時点で分かったことだけを記録し、後から変えません。high、low はその足で見つかりピボットになった高値と安値(ピボットの足に描かれ、後で置き換わったものも残ります)、zigZag はその足でラインが延びる先の価格です。そのため computeIndicator() の high で、間に low をはさまず続く値は最後の 1 つだけがピボットです。low も同じで、同じ足では高値が先です。独自のインジケーターでも同じように描けます。カスタムインジケーターを参照してください。
オシレーター
| タイプ | 名前 | デフォルトのパラメーター | 出力 |
|---|---|---|---|
MACD |
移動平均収束拡散法 | 12、26、9 | macd、signalLine、histogram |
RSI |
相対力指数 | 14、期間 14 の SMA 付き | rsi、rsiBasedMa |
STOCH |
ストキャスティクス | 14、%K の平滑化 1、%D の平滑化 3 | k、d |
STOCHRSI |
ストキャスティクス RSI | %K 3、%D 3、RSI 14、ストキャスティクス 14 | k、d |
CCI |
商品チャネル指数 | 20(hlc3)、期間 14 の SMA 付き | cci、cciBasedMa |
WR |
ウィリアムズ %R | 14 | wr14 |
ROC |
変化率 | 9 | roc |
MTM |
モメンタム | 10 | mom |
TRIX |
三重指数平滑移動平均 | 18 | trix |
DPO |
トレンド除去価格オシレーター | 21 | dpo |
FISHER |
フィッシャー・トランスフォーム | 9(hl2) | fisher、trigger |
AO |
オーサム・オシレーター | 5、34(hl2) | ao |
PPO |
パーセンテージ・プライス・オシレーター | 10、21、SMA | ppo |
CMO |
シャンデ・モメンタム・オシレーター | 9 | chandeMo |
UO |
アルティメット・オシレーター | 7、14、28 | uo |
KST |
ノウ・シュア・シング | ROC 10・15・20・30、SMA 10・10・10・15、シグナル 9 | kst、signalLine |
COPPOCK |
コポック・カーブ | WMA 10、ROC 14・11 | coppockCurve |
TSI |
トゥルー・ストレングス・インデックス | 25、13、シグナル 13 | trueStrengthIndex、signalLine |
SMI |
ストキャスティクス・モメンタム・インデックス | %K 10、%D 3、EMA 3 | smi、smiBasedEma |
RVGI |
レラティブ・ヴィガー・インデックス | 10 | rvgi、signalLine |
BOP |
バランス・オブ・パワー | なし | bop |
CRSI |
コナーズ RSI | RSI 3、連騰・連落 2、順位 100 | crsi |
BBP |
ボリンジャーバンド %B | 20、標準偏差の 2 倍 | bollingerBandsB |
KDJ |
ストキャスティクス KDJ(中国式) | 9、3、3 | k、d、j |
BIAS |
移動平均乖離率(中国式) | 6・12・24 | bias6、bias12、bias24 |
PSY |
サイコロジカルライン(中国式) | 12、6 | psy、psyma |
BRAR |
人気・意欲指標(中国式) | 26 | br、ar |
DMA |
移動平均の差(中国式) | 10、50、10 | dif、difma |
ASI |
累積スイング指数(中国式) | 26、10 | asi、asit |
CR |
中間意欲指標(中国式) | 26、移動平均 10・20・40・62 | cr、ma10、ma20、ma40、ma62 |
出来高
| タイプ | 名前 | デフォルトのパラメーター | 出力 |
|---|---|---|---|
VOL |
出来高 | 移動平均なし | volume |
OBV |
オン・バランス・ボリューム | 移動平均なし | onBalanceVolume |
MFI |
マネーフローインデックス | 14 | mf |
CMF |
チャイキン・マネーフロー | 20 | cmf |
EMV |
イーズ・オブ・ムーブメント | 14、除数 10000 | eom |
AD |
アキュムレーション・ディストリビューション | なし | accumulationDistribution |
CHAIKINOSC |
チャイキン・オシレーター | 3、10 | chaikinOscillator |
PVT |
プライス・ボリューム・トレンド | なし | pvt |
VO |
ボリューム・オシレーター | 5、10 | volumeOsc |
EFI |
エルダー・フォース・インデックス | 13 | elderForceIndex |
KVO |
クリンガー・オシレーター | 34、55、シグナル 13 | klingerOscillator、signalLine |
RVOL |
同時刻の相対出来高 | 取引日ごと、過去 5 日、累積 | relativeVolumeRatio、currentVolume、pastVolume |
VR |
ボリュームレシオ(中国式) | 26、6 | vr、mavr |
WVAD |
ウィリアムズ・バリアブル・アキュムレーション・ディストリビューション(中国式) | 24、6 | wvad、mawvad |
ボラティリティ
| タイプ | 名前 | デフォルトのパラメーター | 出力 |
|---|---|---|---|
ATR |
アベレージ・トゥルー・レンジ | 14、RMA | atr |
STD |
標準偏差 | 20 | std |
CHOP |
チョピネス・インデックス | 14 | chop |
ADR |
平均日中レンジ | 14 | adr |
HV |
ヒストリカル・ボラティリティ | 10 | hv |
MASS |
マス・インデックス | 10 | massIndex |
BBW |
ボリンジャーバンド幅 | 20、標準偏差の 2 倍、最大拡大と最小収縮は 125 | bollingerBandWidth、highestExpansion、lowestContraction |
期間とセッション
| タイプ | 名前 | デフォルトのパラメーター | 出力 |
|---|---|---|---|
PIVOTS |
ピボットポイント | トラディショナル、期間はチャートに合わせて自動で選ぶ | p、r1、s1 … r5、s5 |
PREVHLC |
前期間の高値・安値・終値 | 日 | high、low、close |
SESSIONS |
取引セッション | 東京・ロンドン・ニューヨーク | tokyoHigh、londonHigh、newYorkHigh など |
ピボットポイントの期間は、既定ではチャートの時間足に合わせて選びます。15 分足以下なら日、それ以外の日中足なら週、日足なら月、週足・月足なら年です。data.set() に interval を渡さなかったときは日です。
RVOL は、その日の足までの出来高を、過去 5 取引日の同じ時刻までの出来高の平均と比べます。1 を超えれば普段より出来高が多いということです。過去の各取引日では同じ時刻に始まった足を使い、なければその前の直近の足を使います。その時刻までに足がない日(データがその日の途中から始まる場合など)は平均に入れません。計算方法を足ごと(mode: 1)にすると、その足だけの出来高を比べます。基準の期間は週・月・四半期・年も選べ、どれもチャートの取引カレンダーで区切ります。基準の期間が足より長くないとき(日足で取引日ごとなど)は、足 1 本ずつが 1 期間になり、その足の出来高を直前の足の平均と比べます。
HV は終値の対数リターンの母標準偏差をパーセントにして年率換算したものです。日中足と 1 日足では √365、複数日の足・週足・月足では √(365/7) を掛けます。足の時間足に合わせて決まります(data.set() に interval を渡さなかったときは日足扱い)。
各インジケーターのすべてのパラメーターと出力は、chart.indicators.definition(type) で調べるか、API リファレンスを見てください。
中国で広く使われているソフトとの違い
中国で広く使われているソフトに慣れている場合は、次の点に注意してください。
- MACD:ヒストグラムは MACD ラインからシグナルラインを引いた値で、2 倍はしません。3 本のラインは
macd、signalLine、histogramです。 - RSI:デフォルトは期間 14 のライン 1 本で、基準線は 70 と 30、さらに期間 14 の移動平均が付きます。平滑化には Wilder の方法を使い、最初の 14 本は単純平均から始めます。
- WR:-100 から 0 の範囲を取り、0 が最も高い位置です。
- 移動平均:MA と EMA はデフォルトで期間 9 のライン 1 本です。何本も必要なら
periods: [5, 10, 20, 30]を指定します。EMA の最初の値は、最初の数本の単純平均です。 - 出来高:デフォルトでは移動平均が付きません。必要なら
periods: [5, 10]を指定します。
KDJ、BIAS、BRAR、PSY、DMA、VR、BBI、MIKE、WVAD、ASI、CR は中国でよく使われるインジケーターで、計算方法は中国で広く使われているソフトと同じです。CR の 4 本の移動平均も同じソフトどおり REF(MA(CR,M),M/2.5+1) で後ろにずらし、ずらす本数の小数は切り捨てます。期間 62 の移動平均は 25 本ずれます。ASI は、その足も前の足も動かなかったところ(R が 0)ではスイングを 0 とします。そうしないと、約定のない平らな足があるたびに ASI が何十本も途切れてしまいます。
チャートなしで計算する
import { computeIndicator, RSI } from '@kumo-charts/core/indicators';
const { rsi } = computeIndicator(RSI, bars);
// rsi[i] は i 本目の足の値。チャート上で計算した値と同じリアルタイムデータに合わせて 1 本ずつ計算するには createIndicatorCalculator() を使います。どちらも渡したデータだけに依存するので、Node.js でも使えます。たとえばサーバーでアラートを判定するのに使えます。VWAP、ピボットポイント、RVOL、HV のように取引日や時間足に沿って計算するインジケーターは、チャートの取引カレンダーと時間足も渡すと、チャートと同じ値になります:{ calendar, interval: '15m' }。
あるインジケーターを別のインジケーターから計算する(たとえば RSI の EMA)ときは、nextOf(bar, value) でその足の別のインジケーターの値を渡します。チャートで source に別のインジケーターを指定したときと同じ値になります。
import { createIndicatorCalculator, EMA, RSI } from '@kumo-charts/core/indicators';
const rsi = createIndicatorCalculator(RSI);
const ema = createIndicatorCalculator(EMA, { params: { periods: [5] } });
for (const bar of bars) {
const [value] = rsi.next(bar);
const [smoothed] = ema.nextOf(bar, value); // RSI にまだ値がない足(NaN)は、チャートと同じく飛ばされます
}独自のインジケーターを作るには、カスタムインジケーターを参照してください。