Haven MT5 to Telegram

Haven MT5 to Telegram 2.0 — MT5の取引をTelegramへ公開

Haven MT5 to Telegram は、MetaTrader 5 の取引イベントをTelegramへ自動公開するためのユーティリティです。

ポジションの新規建て・決済、Stop Loss と Take Profit の変更、部分決済、指値・逆指値注文のイベントを監視します。メッセージにはチャートのスクリーンショット、Trade ID、取引結果を含めることもできます。

Haven MT5 to Telegram 2.0 の新機能

バージョン2.0では、新しいインターフェースと再設計された取引イベント公開システムを導入しました。

• SIMPLE モード
  主要な設定を1つの画面にまとめています。Telegram接続の確認、主要な通知タイプの有効・無効、 スクリーンショット、初回シグナルの公開方法を設定できます。

• ADVANCED モード
  拡張インターフェースには、公開、表示、レポート、診断の各セクションがあります。SIMPLE と ADVANCED は同じ 設定を共有します。

• 取引ライフサイクル全体に対応
  Haven は、Market Entry、SL/TP変更、Break Even、部分決済、全決済、主要な指値・逆指値注文 イベントを公開できます。

• 初回メッセージ送信前のSL待機
  新規エントリーでは Immediately、Fixed Delay、Wait for SL の各モードを利用できます。これにより Haven は保護レベルの設定を待ち、 最初のメッセージに Entry、SL、TP をまとめて送信できます。待機時間には設定可能な最大タイムアウトがあります。

• STANDARD と CUSTOM TEMPLATES
  STANDARD はすぐに使えるメッセージ形式を提供します。CUSTOM TEMPLATES では、独自のHTMLテンプレートや TXTファイルを使って Pending、Open、Close メッセージを設定できます。

取引通知

Haven は MT5 内の取引イベントを直接監視し、現在の設定に従ってメッセージを生成します。

• Market Entry — 新規ポジションの開始。
• SL / TP Change — Stop Loss または Take Profit の変更。
• Break Even — 保護レベルをエントリー価格付近へ移動。
• Partial Close — ポジションの部分決済。
• Full Close — ポジションの全決済。
• Pending Created — 指値・逆指値注文の作成。
• Pending Modified — 指値・逆指値注文パラメータの変更。
• Pending Activated — 指値・逆指値注文の約定。
• Pending Cancelled / Expired — 注文のキャンセルまたは期限切れ。

取引イベントでは安定した Trade ID を使用し、同一銘柄の個別取引を区別しやすくしています。

STANDARD メッセージ

STANDARD モードでは、HTMLを編集する必要はありません。Haven がメッセージ構造を自動生成します。

表示する項目を選択できます：

• Symbol
• Direction
• Entry / Exit
• Stop Loss
• Take Profit
• Trade ID
• Duration
• Close Reason
• Volume
• Money P/L
• Ticket

Volume、Money P/L、Ticket などの任意項目は、公開したくない場合に無効化できます。

チャートスクリーンショット

Haven は対応する取引メッセージにチャートスクリーンショットを自動添付できます。

• 自動フレーミング
  スクリーンショット作成前に、イベント時刻と取引レベルに応じてチャートの縮尺と表示範囲を調整します。

• 取引レベル
  スクリーンショットには Entry、Exit、Stop Loss、Take Profit を表示できます。決済済み取引では、エントリーから決済までの実際の範囲も 表示できます。

• Watermark
  スクリーンショットにテキストの透かしや @username を追加できます。テキスト、サイズ、位置を設定でき、色は チャート背景に合わせて選択されます。

• パネルを非表示
  スクリーンショット作成中に Haven パネルを一時的に非表示にし、完了後に元へ戻すことができます。

レポートとオープンポジション

Haven には専用のレポートセクションがあります。

• Daily Trading Report — 手動送信、またはブローカーサーバー時間に基づく自動日次レポート。
• Weekly Trading Report — 現在の週の開始時点から集計する手動週次レポート。
• Open Positions — 現在のオープンポジション一覧を送信。

V2レポートでは、完全に終了した取引セグメントを1件として集計します。部分決済は該当取引の最終結果に含まれ、別の完了取引として Trades 数を増やしません。

レポートには以下を含めることができます：

• Trades
• Wins / Losses / Breakeven
• Win Rate
• Gross P/L
• Trading Costs
• Net P/L

Trading Costs には、MT5履歴から取得可能な手数料、fees、swap が含まれます。

技術機能

SIMPLE インターフェース

SIMPLE モードは素早い設定を目的としています。Telegramの状態と主要な公開設定を1画面で確認できます：

• Market Entry
• Trade Close
• SL / TP Updates
• Pending Orders
• Screenshots
• Initial Signal

追加設定が不要な場合は、Telegram接続後に初期設定のまま利用を開始できます。

ADVANCED インターフェース

ADVANCED モードでは Haven のすべての設定へアクセスできます：

• Overview — 接続とキューの状態。
• Publish — 取引通知タイプ、メッセージ形式、Initial Signal 設定。
• Style — スクリーンショットと Watermark 設定。
• Reports — Daily / Weekly Reports、Open Positions、Economic Calendar 通知。
• System — Telegram と配信システムの診断。

Telegram の接続

ステップ1：Telegram Bot を作成

1. Telegram を開き、公式の BotFather ボットを検索します。
2. /newbot コマンドで新しいボットを作成します。
3. 名前と username を設定します。
4. BotFather が Bot Token を発行します。保存してください。

ステップ2：送信先を準備

Haven は Telegram Bot がアクセスできる個人チャット、グループ、チャンネルへメッセージを送信できます。

チャンネルを使用する場合は、ボットを管理者として追加し、メッセージ公開権限を与えたうえで対応する Chat ID を取得してください。

ステップ3：MT5 を設定

1. ツール -> オプション -> エキスパートアドバイザ を開きます。
2. 指定したURLへのWebRequestを許可する を有効にします。
3. Telegram API アドレスを追加します：https://api.telegram.org
4. OK をクリックします。

ステップ4：Haven を起動

1. Haven MT5 to Telegram をチャートへ追加します。
2. F7 を押し、Bot Token と Chat ID を入力します。
3. 設定を適用します。
4. SIMPLE パネルで VERIFY TELEGRAM をクリックします。
5. 確認に成功すると、ステータスが READY に変わります。
6. 必要に応じて SEND TEST をクリックし、メッセージ配信を確認します。

ステータスが READY になれば、Haven は選択した取引イベントを監視し、設定済みのTelegram送信先へ公開する準備が完了しています。