Eagle Telegram Signal Provider MT5
- ユーティリティ
- バージョン: 1.4
Signal Provider
取引をしている間に、口座の取引を Telegram のチャット、グループまたはチャンネルに配信します。新規注文、変更、部分決済、決済、待機注文、そして日次・週次・月次レポートです。各メッセージには価格の水準、金額とパーセントでのリスク、結果、さらに希望すれば取引を描き込んだチャートのスクリーンショットが付きます。文章を打つ必要はありません。あなたは取引し、EA が書きます。
Eagle Signal Provider は口座のすべての取引と待機注文を追跡し、イベントごとに、発生した直後に分かりやすい Telegram メッセージを送ります。購読者は、あなたが何を、いくらで、どれだけのリスクで行い、どんな結果になったかを、スマートフォンで読みやすい形で確認できます。遅延、ストップロスのルール、フィルターが配信内容を決めるので、手動の取引、別の EA の取引、ストップロスのない取引が誤ってチャンネルに流れることはありません。
購読者が受け取る内容
- 新規注文：銘柄、方向、エントリー、SL と TP とその距離、ロット、残高または有効証拠金に対する金額と % でのリスクと目標、リスクリワード比、口座の行、コメント。
- 変更：変更の意味を言葉で表示します。ストップを建値へ、利益を確保、リスク減少または増加、ストップロスの設定または削除、目標の拡大、縮小、設定または削除、注文の移動。旧価格と新価格、そして変更後のリスクと目標。
- 部分決済：決済したロットと残りのロット、初期サイズに対する割合、部分決済の番号、結果、保有時間、新しい残高。MT4 では旧チケットと新チケット。
- 決済：理由（テイクプロフィット、ストップロス、ストップアウト、手動、Expert による決済、待機注文の削除または期限切れ）、エントリーとエグジット、pips・金額・%・初期リスクの倍数（例 +2.2R）での結果、保有時間、新しい残高。
- 待機注文の約定：指定価格、約定価格、スリッページ。
- レポート：日次・週次・月次。選んだ時刻に自動で、またはパネルからワンクリックで送信。
スマートフォンの画面向けのメッセージ
- 1 行目は通知のプレビューです。銘柄、方向、イベントが並ぶので、購読者はチャットを開く前に何が起きたか分かります。
- 価格は等幅のブロックに、高い価格を上にして表示します。買いは上から TP、エントリー、SL、売りはその逆です。距離には符号が付き、+ は利益の方向です。
- 小さなバー：新規注文のリスクリワード、決済時の SL から TP までの道筋とエントリー・エグジットの位置、部分決済の決済割合、レポートの勝率。
- スレッド：変更、部分決済、決済、約定は新規注文のメッセージへの返信として届くため、取引ごとにチャットの中でまとまります（スイッチ "Reply to the signal"）。
- 最後に銘柄のハッシュタグ、例えば #EURUSD。タップするとその銘柄のすべてのシグナルが表示されます（スイッチ "Symbol hashtag"）。
- メッセージは 5 言語：英語、イタリア語、ドイツ語、スペイン語、フランス語。
チャートのスクリーンショット
- 新規注文と決済のとき、EA は銘柄のチャートを開いて取引を描き（ストップロスとテイクプロフィットのゾーン、エントリーライン、決済時はエントリーからエグジットへの線）、画像を撮って文章と一緒に送ります。
- 時間足（現在の時間足または M1 から MN1）、ピクセル単位のサイズ（0 = チャート全体）、色を決めるチャートテンプレートを選べます。
- 決済時に描く水準は、最初の SL/TP、最も広い SL/TP、最後の SL/TP から選べます（Levels drawn）。
- Screenshot time limit 内にチャートの準備ができなければ、文章は画像なしで送られます。スクリーンショットのせいでメッセージが失われることはありません。
何を配信するかはあなたが決めます
- 新規注文の遅延：設定した秒数の後に、その間に置いた SL と TP を含めてシグナルが出ます。その最初の調整は変更としては送られません。
- Announce market trades only with a stop loss：ストップロスのない取引はストップロスを待ちます。時間内に設定されなければ、そのシグナルと以降のすべてのメッセージは送られません。
- マジックナンバー、銘柄、コメントによる注文フィルター。含めるか除外するかを選べ、複数の値は ";" で区切ります。フィルターはレポートにも適用されます。
- 待機注文：発注、変更、削除をすべて通知するか、通知せずに約定して取引になったときだけ配信するか（Announce as new trade）。
- すべてのメッセージ用のスイッチ、種類ごとのスイッチ、さらに各メッセージの各行のスイッチ。
レポート
- 日次は毎日、週次は選んだ曜日、月次は月の最終日に、あなたのタイムゾーン（GMT Offset）のレポート時刻に送ります。各レポートは一度だけ送られ、ターミナルの再起動後でも 1 時間以内の遅れなら送信されます。
- 対象期間、金額・%・pips での合計結果、勝ち・負け・建値の取引数、バー付きの勝率、プロフィットファクター、最良と最悪の取引。
- 決済済み取引の一覧（希望すれば部分決済を 1 行にまとめます）、続いてまだ保有中の取引とその含み損益、未約定の待機注文。
- "Break-even band (%)" は小さな結果をいつ建値とみなすかを決めます。"Send even without trades" は取引のない期間もレポートするかを決めます。
メッセージの送信のしくみ
- 口座は 250 ミリ秒ごとに、MT5 では取引イベントのたびにもチェックされます。
- 各取引の状態は保存されます。ターミナルを閉じている間に起きたこと（例えば夜間に TP に達した取引）は EA の次の起動時に送られ、同じイベントが二度送られることはありません。初回起動時、すでに保有している取引はメッセージなしで引き継がれます。
- Telegram が待機を求めた場合、メッセージは待ってから再送され、最大 30 回試みます。Telegram が書式を受け付けない場合はプレーンテキストで送ります。Telegram の 1 通より長い文章は行末で分割されます。
- WebRequest の許可がない場合は解決方法を説明する警告が表示され、直近の結果は常にパネルに表示されます。
チャート上のパネル
- メインウィンドウ：Daily report now、Weekly report now、Monthly report now、Settings、あなたのタイムゾーンの時計、直近の結果（送信済み、待機中、エラー）。
- Settings：Main settings、New trade、Trade closed、Partial exit、Order changes、Pending filled、Reports、Try a message、合計 83 の設定。設定は保存され、再起動後も戻ります。
- Try a message：ワンクリックで、チャートの銘柄でテスト用の新規注文、決済、変更、約定のメッセージを送り、取引の前にチャンネルで見え方を確認できます。
- 移動、最小化、拡大縮小（Panel size）ができるダークカラーのウィンドウ。
アドバンストモード：あなた自身の文章
- "Use custom message files (advanced mode)" を有効にすると、メッセージは編集できるテキストファイルから作られます。新規注文、決済、部分決済、変更、待機注文の約定、レポートのそれぞれに 1 ファイルです。
- ファイルは Terminal\Common\Files\EagleSignalProvider\CustomMsg にあります。"Template" フォルダーは起動のたびに現在の書式で書き直されます。コピーして名前を変え、その名前を "Folder of your message files" に入力してください。存在しないフォルダーはテンプレートから作成されます。
- すべての値のプレースホルダー、条件が成り立つときだけ表示される行（コメントあり、SL 設定済み、TP 設定済み、待機注文または成行注文）、各絵文字と各決済理由の文字、Telegram の書式（太字、斜体、等幅）。すべてのプレースホルダーは Info.txt で説明しています。
- ファイルはメッセージごとに読み直されます。変更は EA を再起動しなくても次のメッセージから反映されます。
4 つのステップで開始
1. Telegram で BotFather を使ってボットを作成し、トークンをコピーします。ボットをグループまたはチャンネルに追加し、チャンネルでは投稿権限のある管理者にします。
2. MetaTrader で "Tools, Options, Expert Advisors"（ツール、オプション、エキスパートアドバイザ）を開き、リストの URL への WebRequest を許可して https://api.telegram.org を追加します。
3. EA を 1 つのチャートに設定し、Telegram bot token と Telegram chat ID を入力します（グループやチャンネルの ID は負の数で、チャンネルの ID は -100 で始まります）。
4. Settings、Try a message を開いてテストメッセージを送ると、チャットに表示されます。それ以降、口座のすべての取引が配信されます。
動作要件
- 口座とチャットごとに、1 つのチャートに 1 つの EA。フィルターの異なる 2 つの EA は同じチャットに配信できます。
- ターミナルは開いたまま接続している必要があります。Windows VPS ならパソコンの電源を切ってもメッセージは送られます。
- ヘッジ口座とネッティング口座に対応。ネッティング口座では、ポジションへの追加の数量は通知されません。
- EA は取引をせず、注文も変更しません。口座を読み取ってメッセージを送るだけです。
- ストラテジーテスターからは Telegram に接続できません。テスターでは EA は各メッセージを送信する代わりに操作ログに書き込みます。
- MetaTrader 5 版と MetaTrader 4 版があり、同じ機能を持つ 2 つの製品です。お使いのターミナルに合うものをインストールしてください。
パラメーター：TELEGRAM
- Telegram chat ID：メッセージを受け取るチャット、グループまたはチャンネル。
- Telegram bot token：あなたのボットのトークン。
- Use custom message files (advanced mode)：内蔵の書式の代わりに、カスタムフォルダーのテキストファイルからメッセージを作ります。
- Folder of your message files：Terminal\Common\Files\EagleSignalProvider\CustomMsg の中の、あなたのファイルがあるフォルダーの名前。
- Wait before announcing a new trade (seconds)：新規注文を配信するまでの待ち時間。
- Announce market trades only with a stop loss：ストップロスのない成行取引を配信しません。
- Extra wait for the stop loss (seconds)：シグナルを破棄する前にストップロスを追加で待つ時間。
- Panel size：Automatic（画面の設定に合わせる）または 75% から 200%。
- Chart loading time before the screenshot (seconds)：撮影前にチャートの読み込みを待つ最短時間。
- Screenshot time limit (seconds)：この時間を過ぎると文章は画像なしで送られます。
パラメーター：注文フィルター
- Publish only these magic numbers / Never publish these magic numbers：例 1001;1002。
- Publish only these symbols / Never publish these symbols：例 EURUSD;XAUUSD。
- Publish only comments containing / Never publish comments containing：取引コメントの一部，例 Scalper。
- 空欄 = フィルターなし。大文字と小文字は区別しません。
パネルの設定
- Main settings：Publish to Telegram、Publish pending orders、Your time zone (GMT)、Break-even band (%)、Distances in (Pips / Points)、% relative to (Balance / Equity)、Picture width (px)、Picture height (px)、Chart template for pictures、Message language、Reply to the signal、Symbol hashtag。
- New trade：Publish new trades、Attach chart picture、Picture timeframe、Ticket number、Lot size、Stop loss price、Stop loss distance、Take profit price、Take profit distance、Risk/reward bar、Account size、Risk in money and %、Target in money and %、Free margin、Margin level、Trade comment、Your extra text。
- Trade closed：Publish closed trades、Attach chart picture、Levels drawn (First / Widest / Last SL/TP)、Ticket number、Entry price、Exit price、Result in money、Result in %、Result in pips/points、Lot size、Time in the trade、Balance after closing、Reason in the title、Your extra text。
- Partial exit：Publish partial exits、Ticket number、Closed share、Number of the partial、Result in money、Result in %、Result in pips/points、Closed and left lots、Time in the trade、Balance after closing、Closed share text、Your extra text。
- Order changes：Publish order changes、Ticket number、Previous value、Risk/target distance、Risk/target in money、Risk/target in %。
- Pending filled：Publish pending fills、Announce as new trade、Ticket number。
- Reports：Daily report、Weekly report、Monthly report、Sending time、Weekly report day、Send even without trades、Buy / sell in the list、Pips/points in the list、% in the list、Join partial exits、Total in pips/points、Total in money、Total in %、Counts and statistics、Win rate、Open trades、Pending orders、Note under joined partials、Your extra text。
リスクに関する注意
この EA はあなたの口座の取引を報告するもので、取引を行うことも取引の助言をすることもありません。メッセージやレポートの結果はこの口座の過去の結果であり、将来の結果を予測するものではありません。シグナルに従う人は、スプレッド、スリッページ、メッセージが届くまでの時間、ブローカーの条件によって異なる結果になることがあります。購読者に配信する前に、デモ口座と非公開のテスト用チャンネルで EA を試してください。
ご質問やご提案は、この製品のコメント欄または MQL5 のプライベートメッセージでお寄せください。
