Macro Event Countdown and Caution Zones
- インディケータ
- バージョン: 1.1
- アクティベーション: 5
Macro Event Countdown and Caution Zones（経済指標カレンダー・ニュース警告）は、MT5 に内蔵されている経済カレンダーから、チャートの通貨に関係する経済指標を読み出して表示する MT5 用インジケーターです。指標の一覧と残り時間、発表時刻の縦線、重要な指標の前後の「注意帯」を表示し、今が注意時間中かどうかをひと目で確認できます。プロップファームのニュース前後のルールや、ご自身の「指標の前後は新規に入らない」といった決まりを守るための確認用、また EA から次の指標までの時間を読み取る用途を想定しています。表示とアラートだけのツールで、売買シグナルは出さず、注文の発注・変更・決済も一切しません。
■ 表示するもの
・パネル：今後24時間（1〜168）の指標を、日時・残り時間・通貨・重要度（色分け）・指標名・結果・予想・前回の値とともに一覧表示します。発表済みの指標は60分間（0〜1440）一覧に残します。最大10行（1〜30）。
・日時は、サーバー時間（チャートと同じ）／パソコンのローカル時間／UTC から選べます。
・チャートに指標時刻の縦線（初期値は点線）と、指標の前後の注意帯（初期値は前15分・後15分、それぞれ0〜240）を描きます。過去3日分（0〜10）の指標も描くので、指標の前後のチャートを振り返れます。線と帯は4時間足まで描きます（変更可）。
・パネルの上部に「通常」「注意時間」の状態と、次の注意対象の指標・残り時間を表示します。
・結果の数値の色（緑／赤）は、MetaQuotes が提供するカレンダーの「影響」の項目（予想と比べて、その指標の通貨にとって良い数値か悪い数値か）です。チャートの銘柄の買い・売りの向きを示すものではありません。
・折りたたみボタン、表示する隅（4か所）、大きさ3段階、色の変更に対応。パネルの文字は MT5 の表示言語から自動で日本語／英語を選びます（手動でも切り替え可）。
■ 通貨と重要度
・自動：チャートの銘柄の基軸通貨と決済通貨（EURUSD なら EUR と USD）。金・株価指数・暗号資産は決済通貨を使います（例：XAUUSD なら USD）。
・ご自身で指定した通貨（例：USD,EUR,JPY）だけ、または自動＋指定も選べます。
・一覧と縦線の重要度：初期値は「高＋中」。注意帯・注意状態・アラートの重要度は別に設定でき、初期値は「高のみ」です。
■ アラート（初期値はオフ）
・指標の N 分前（初期値15分、1〜240）に、注意対象の重要度の指標について通知します。ポップアップ／音／プッシュ通知／メール。
・複数のチャートに入れても、MT5 全体で1つの指標につき1回だけ通知します。
・同じ時刻に同じ通貨の指標が複数発表されるとき（例：CPI の前月比・前年比など）は、その件数分のアラートが出ます。
・インジケーターを読み込んだ時点や、MT5 を閉じていた間にすでに通知時刻を過ぎていた指標では鳴りません。
■ EA で使う場合（iCustom）
バッファは2つで、最新の足（shift 0）に値が入ります。
・バッファ0：選んだ通貨の、次の「高」重要度の指標までの分数。-1 ＝ 先読み時間内に該当なし、-2 ＝ カレンダーのデータなし（読み込み前、またはストラテジーテスター）。
・バッファ1：注意帯の時間中は 1、それ以外は 0。
マーケットで購入した商品は Indicators\Market フォルダーに入るため、名前は "Market\\Macro Event Countdown and Caution Zones" です。1つ目の引数に false を渡すと、チャートに何も描かず、チャートの描画枠（最大8個）も使いません。ほかの入力は初期値のままです。例：
int h = iCustom(_Symbol, _Period, "Market\\Macro Event Countdown and Caution Zones", false);
double v[1];
if(CopyBuffer(h, 0, 0, 1, v) == 1) { /* v[0] ＝ 次の高重要度の指標までの分 */ }
ほかの入力も渡す場合、引数は46個です（入力41個＋入力グループの見出し5個。入力タブの並び順）。
これらの値を受けて EA がどう動くかは、EA を作る方のご判断です。このインジケーター自体は取引をしません。
■ 制限事項（ご購入前に必ずお読みください）
・MT5 のストラテジーテスターには経済カレンダーのデータがありません。テスターでは案内を表示するだけで、バッファ0は -2 を返します。指標回避の EA のバックテストには使えません。
・指標名は MT5 のカレンダーから、MT5 の表示言語で取得します。日本語の MT5 でパネルを英語にしても、指標名は日本語のままです。
・ローカル時間・UTC の表示は、今の時差で換算します。夏時間の切り替えをまたぐ先の指標は、1時間ずれて表示されることがあります（サーバー時間の表示はずれません）。
・終日・時刻未定の指標は、一覧には出ますが、注意帯とアラートの対象外です。
・MT5 のカレンダーに無い通貨（例：CNH、TRY）は表示されません。
・結果の数値は、確認の間隔（初期値30秒、10〜300）の分だけ遅れて表示されることがあります。データの正確さや更新のタイミングはカレンダーの提供元（MetaQuotes）によります。このインジケーターはそれを表示するだけです。
・プロップファームや取引会社は、別のニュースの情報源や別のルールを使っていることがあります。このインジケーターは、口座で何が許されるかを判断するものではありません。各社のルールはご自身でご確認ください。
・描画ありの状態で1つのチャートに入れられるのは最大8個です。同じチャートで複数が注意帯を描くときは、最初に入れたものの帯の設定が使われます。描画オフ（iCustom 用）は数に入りません。
・バッファは最新の足の値だけを持ちます（過去の足は空です）。
・テンプレートを保存するとパネルの図形も保存されますが、読み込んだときに作り直します。
■ ご注意
・売買シグナルではなく、指標で価格がどう動くかを予想するものでもありません。利益や結果を約束するものではありません。売買の判断はご自身の責任で行ってください。
・名前が「ECN」で始まる図形は、このインジケーターの描画とみなします。チャート間でアラートやパネルの状態を共有するため、「ECN」で始まる一時的なグローバル変数を使います。
・プッシュ通知とメールは、MT5 側の設定が必要です。
■ その他
・MetaTrader 5 専用です（MT4 には経済カレンダーの機能がないため、MT4 版はありません）。どの銘柄・時間足でも使えます。動作確認は MT5 のデモ口座で行いました。
・DLL、外部へのインターネット通信は使いません。データは MT5 内蔵のカレンダーからだけ取得します。
・サポートは MQL5 のメッセージで、3営業日以内に返信します。対応範囲は導入・設定・不具合のご報告です。相場観、指標発表時の売買のしかた、売買の判断についてのご質問にはお答えできません。
