MT5からTelegramへ - プロフェッショナル取引通知ライブラリ - MetaTrader 5のためのライブラリ

MetaTrader 5用Telegramボット統合のプロフェッショナルライブラリ。取引シグナル、スクリーンショット、レポート、リアルタイム通知をTelegramチャンネルやグループに送信するための完全なソリューションです。

主な機能

• 📨リアルタイム取引通知- ポジションの新規/決済/変更を即座にアラートします。
• チャートスクリーンショット- 注釈付きのチャートを自動的にキャプチャ
• 📊口座レポート- 日次、週次、月次パフォーマンスレポート
• ⚠️リスク管理アラート- ドローダウン、マージンレベル、ストップアウトアラート
• 🔄メッセージキューシステム- リトライメカニズムによる信頼性の高い配信
• 📝マルチチャンネル・サポート- 複数のTelegramチャット/チャンネルに送信
• 📝テンプレートシステム- カスタマイズ可能なメッセージテンプレート
• Ἷスマートレート制限- APIブロッキングの防止

必要条件

• MetaTrader 5 バージョン2375以上
• Telegram ボットトークン（@BotFather から取得）
• チャットまたはチャンネルID
• インターネット接続

インストール

ステップ1：テレグラムボットを作成する

1. Telegramを開き、@BotFatherを見つける。
2. newbotコマンドを送信
3. ボットの名前を選択
4. ユーザー名を選択（末尾は 'bot' でなければならない）
5. BotFather が提供するトークンを保存する

ステップ 2: チャット ID の取得

1. ボットをグループ/チャンネルに追加するか、プライベートチャットルームを開始します。
2. ボットにメッセージを送る
3. https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates にアクセスしてください。
4. 返信でチャットIDを見つける

ステップ3：MT5をセットアップする

1. MT5を開く → サービス → 設定 → Expert Advisors
2. 以下のURLのWebRequestを許可する」にチェックを入れる
3. URLを追加: https://api.telegram.org
4. OKをクリックします。

ステップ 4: ファイルのインストール

1. TelegramBot.mqhをMQL5/Include/フォルダにコピーします。
2. TelegramBot_Example.mq5をMQL5/Experts/フォルダにコピーします。
3. 両方のファイルをコンパイルする

クイックスタート

#include <TelegramBot.mqh> CTelegramBot bot; int OnInit() {     // ボットの初期化     if(!bot.Initialize("YOUR_TOKEN"。, "YOUR_CHAT_ID"))     {         Print(「ボットの初期化に失敗しました);         return INIT_FAILED;     }          // テスト・メッセージの送信     bot.SendMessage(「ボット接続成功);          // グラフのスクリーンショットを送る     bot.SendChartScreenshot("現在の市場の状況");          return INIT_SUCCEEDED; }

APIリファレンス

基本メッセージ

bool SendMessage(string text); bool SendHTMLMessage(string text); bool SendMarkdownMessage(string text); bool SendMessageToAll(string text);

取引シグナル

bool SendTradeSignal(ENUM_SIGNAL_TYPE type, string symbol, double price); bool SendPositionOpened(ulong ticket, string symbol, ENUM_POSITION_TYPE type, double volume, double price); bool SendPositionClosed(ulong ticket, string symbol, double profit, double commission, double swap);

メディアファイル

bool SendPhoto(string file_path, string caption); bool SendDocument(string file_path, string caption); bool SendChartScreenshot(); bool SendChartScreenshot(string caption);

レポート

bool SendAccountStatus(); bool SendDailyReport(); bool SendWeeklyReport(); bool SendMonthlyReport();

リスク管理

bool SendRiskAlert(double drawdown_percent); bool SendMarginWarning(double margin_level); bool SendStopOutWarning();

エキスパート・アドバイザーの例

本パッケージには、Expert Advisorのデモ用サンプルが含まれています：

• 通知によるポジション監視
• 取引イベント時の自動スクリーンショット
• 定期的な口座状況の更新
• リスク管理アラート
• デイリーレポート
• デモ取引シグナル

メッセージフォーマット

HTML形式（推奨）

string message = "<b> Жирный текст</b>\n"; message += "<i> Курсив</i>\n"; message += "<code> Моноширинный код</code>\n"; message += "<a href='http://example.com'> Ссылка</a>"; bot.SendHTMLMessage(message);

マークダウン形式

string message = "太字テキスト{n}"; message += 「イタリック体; message += 「等幅コード; message += "[Link](http://example.com)"; bot.SendMarkdownMessage(message);

パフォーマンス

• メッセージ速度： 1分間に最大30メッセージ
• ファイルサイズ制限: 1ファイルあたり50MB
• メッセージの長さ 4096文字
• 署名長： 1024文字
• キューサイズ： 100メッセージ
• 平均応答時間: 50-200ms

エラー処理

ライブラリには複雑なエラー処理が含まれています：

• 接続チェック
• リミットオーバー保護
• 失敗時の自動再試行
• 失敗メッセージのキューイングシステム
• 詳細なエラーログ

サポート

• ドキュメント: 完全なAPIドキュメントがソースコードに含まれています。
• EAサンプル: すべての機能を備えた動作例
• デバッグモード: トラブルシューティングのためのデバッグ機能内蔵

バージョン履歴

バージョン 1.0.0 (2024)

• 最初のリリース
• Telegram Bot APIの完全統合
• 複数チャンネルのサポート
• キューイングシステム
• テンプレートエンジン
• リスク管理アラート

ライセンス

このライブラリはMetaTrader 5で使用するために「現状のまま」提供されます。個人および商用利用は無料です。

作者

Forex Trading Blueprint
(Stepan Sinic)

免責事項

本ソフトウェアは、いかなる保証もなく「現状のまま」提供されます。取引には多額の損失リスクが伴い、すべての投資家に適しているわけではありません。過去の実績は将来の結果を示すものではありません。

---

このライブラリが有用であるとお感じになりましたら、MQL5 CodeBaseで評価してください！

詳細なセットアップ手順

テレグラムでボットを作成する

1. BotFatherを見つける

   • テレグラムを開く
   • 検索に @BotFather と入力
   • STARTを押す

2. 新しいボットを作成する

   • コマンド /newbot を送信
   • ボットの名前を入力 (例: "My Trading Bot")
   • ボットのユーザー名を入力 (例: my_trading_bot)
   • トークンを保存します：123456789:ABCdefGHIjklMNOpqrsTUVwxyz

3. ボットを設定する

   • setprivacyを送信し、DISABLEを選択します（グループ内で作業する場合）。
   • setjoingroupsを送信し、ENABLEを選択します（グループに追加する）。

チャットIDの取得

プライベートメッセージの場合

1. ボットとの対話を開始する
2. 任意のメッセージを送信
3. ブラウザで開く: https://api.telegram.org/bot<TOKEN>/getUpdates
4. chat":{"id":123456789} - これがあなたのチャットIDです。

グループの場合

1. ボットをグループに追加
2. グループにメッセージを送る
3. ブラウザで開く: https://api.telegram.org/bot<TOKEN>/getUpdates
4. チャット":{"id":-123456789}はグループに対して負の数です。

チャネルの場合

1. チャンネル管理者としてボットを追加
2. チャンネルにメッセージを送る
3. またはチャネルの @username をチャット ID として使用する

よくある問題の解決方法

WebRequest エラー

解決方法: 1. ツール → 設定 → アドバイザー 2.次のURLに対してWebRequestを許可する 3.追加: https://api.telegram.org 4.MT5を再起動する

ボットが応答しません：

チェック: 1. トークンが正しい 2.チャット ID が正しい 3. インターネット接続 4. WebRequest の設定

メッセージが届きません：

考えられる原因: 1.API制限を超えている (30メッセージ/分) 2.メッセージのHTML形式が正しくない 3.メッセージが長すぎる（4096文字以上）

使用例

買いシグナルの送信

bot.SendTradeSignal(SIGNAL_BUY, "EURUSD", 1.1850, 1.1800, 1.1900);

注釈付きスクリーンショットの送信

string caption = "<b> Точка входа</b>\n"; caption += "Пара: EURUSD\n"; caption += "Тип: BUY\n"; caption += "Цена: 1.1850"; bot.SendChartScreenshot(caption);

口座状況の送信

bot.SendAccountStatus(); // 残高、エクイティ、マージンなどを自動的に送信する。

デイリーレポートの設定

// OnTimer()アドバイザーの中で if(TimeHour(TimeCurrent()) == 23 && TimeMinute(TimeCurrent()) == 0) {     bot.SendDailyReport(); }

ドローダウンアラート

double drawdown = CalculateDrawdown(); // 計算関数 if(drawdown > 20.0) // ドローダウンが20%以上 {     bot.SendRiskAlert(drawdown); }

メッセージの構成

ポジションオープン

[POSITION OPENED] ↑ ================ Ticket: #12345678 Symbol: EURUSD Type: BUY Volume: 0.10 Price: 1.18500 Time: 2024.01.15 10:30 ================

ポジションクローズ

[POSITION CLOSED] ================ Ticket: #12345678 Symbol: EURUSD Profit: +125.50 USD Commission: -2.00 Swap: -0.50 Total: +123.00 USD Time: 2024.01.15 14:45 ================

日次レポート

[DAILY REPORT] ================ Date: 2024.01.15 ACCOUNT SUMMARY ---------------- Balance: 10,125.50 USD Equity: 10,250.00 USD Floating P/L: +124.50 USD TRADING ACTIVITY ---------------- Trades Today: 5 Today's Result: +250.00 USD Open Positions: 2 BOT STATISTICS ---------------- Messages Sent: 45 Signals Sent: 8 Success Rate: 98.5% ================