MT5 to Telegram Professional Library - MetaTrader 5のためのライブラリ

主な機能

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

必要条件

• MetaTrader 5 ビルド 2375 以上
• テレグラムボットトークン（@BotFatherから入手）
• チャットIDまたはチャンネル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. "Allow WebRequest for listed URL" をチェックする。
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("Failed to initialize bot");
        return INIT_FAILED;
    }
    
    // テスト・メッセージを送信する
    bot.SendMessage("Bot connected successfully!");
    
    // チャートのスクリーンショットを送る
    bot.SendChartScreenshot("Current market situation");
    
    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アドバイザーの例

本パッケージには、完全な機能を持つサンプルEAが含まれています：

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

メッセージフォーマット

HTMLフォーマット（推奨）

string message = "<b> Bold text</b>\n";
message += "<i> Italic text</i>\n";
message += "<code> Fixed-width code</code>\n";
message += "<a href='http://example.com'> Link</a>";
bot.SendHTMLMessage(message);

マークダウン形式

string message = "*Bold text*\n";
message += "_Italic text_\n";
message += "`Fixed-width code`\n";
message += "[Link](http://example.com)";
bot.SendMarkdownMessage(message);

パフォーマンス

• メッセージレート 最大30メッセージ/分
• ファイルサイズ制限: 1ファイルあたり50MB
• メッセージの長さ: 4096文字
• キャプションの長さ： 1024文字
• キューサイズ： 100メッセージ
• 平均応答時間: 50-200ms

エラー処理

ライブラリには包括的なエラー処理が含まれています：

• 接続検証
• レート制限保護
• 失敗時の自動再試行
• 失敗したメッセージのキューシステム
• 詳細なエラーログ

サポート

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

バージョン履歴

バージョン 1.0.0 (2024)

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

ライセンス

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

作者

Financial Blueprint
プロフェッショナル・トレーディング・ソリューション

免責事項

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

---

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

詳細なセットアップ手順

Telegram ボットを作成する

1. BotFather を見つける

   • テレグラムを開く
   • BotFatherを検索
   • スタートボタンを押す

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. チャット":{"id":123456789}を検索します。- これがあなたのチャットIDです

グループの場合

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

チャンネルの場合

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

よくある問題のトラブルシューティング

WebRequest エラー：

解決方法1.ツール → オプション → Expert Advisors 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> Entry Point</b>\n";
caption += "Pair: EURUSD\n";
caption += "Type: BUY\n";
caption += "Price: 1.1850";
bot.SendChartScreenshot(caption);

アカウントステータスの送信

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

デイリーレポートの設定

// EAの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%
================