MT5 to Telegram Professional Library - MetaTrader 5용 라이브러리

주요 기능

• 📨 실시간 거래 알림 - 포지션 오픈/청산/수정 즉시 알림
• 📸 차트 스크린샷 - 주석이 포함된 자동 차트 캡처
• 📊 계좌 보고서 - 일별, 주별, 월별 성과 보고서
• ⚠️ 위험 관리 알림 - 드로다운, 마진 수준 및 스톱 아웃 경고
• 🔄 메시지 대기열 시스템 - 재시도 메커니즘을 통한 안정적인 전달
• 👥 멀티 채널 지원 - 여러 텔레그램 채팅/채널에 브로드캐스트 가능
• 📝 템플릿 시스템 - 사용자 지정 가능한 메시지 템플릿
• 🎯 스마트 속도 제한 - API 스로틀링 방지

요구사항

• 메타트레이더 5 빌드 2375 이상
• 텔레그램 봇 토큰 (@BotFather에서 획득)
• 채팅 아이디 또는 채널 아이디
• 인터넷 연결

설치

1단계: 텔레그램 봇 생성

1. 텔레그램을 열고 @BotFather를 검색합니다.
2. 새봇 명령 보내기
3. 봇의 이름을 선택합니다.
4. 사용자명을 선택합니다 ('bot'으로 끝나야 합니다).
5. 봇파더에서 제공한 토큰을 저장합니다.

2단계: 채팅 ID 받기

1. 그룹/채널에 봇을 추가하거나 비공개 채팅을 시작합니다.
2. 봇에게 메시지 보내기
3. 방문: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
4. 응답에서 채팅 ID를 찾습니다.

3단계: MT5 구성하기

1. MT5 → 도구 → 옵션 → 전문가 조언을 엽니다.
2. "나열된 URL에 대한 웹 요청 허용"을 체크합니다.
3. URL 추가: https://api.telegram.org
4. 확인을 클릭합니다.

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();

예제 전문가 어드바이저

이 패키지에는 모든 기능을 갖춘 예제 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개 메시지
• 파일 크기 제한: 파일당 50MB
• 메시지 길이: 4096자
• 캡션 길이: 1024자
• 대기열 크기: 100개 메시지
• 평균 응답 시간: 50-200ms

오류 처리

라이브러리에는 포괄적인 오류 처리 기능이 포함되어 있습니다:

• 연결 유효성 검사
• 속도 제한 보호
• 실패 시 자동 재시도
• 실패 메시지에 대한 대기열 시스템
• 자세한 오류 로깅

지원

• 문서: 소스에 포함된 전체 API 문서
• 예제 EA: 모든 기능이 포함된 작업 예제
• 디버그 모드: 문제 해결을 위한 디버깅 기능 내장

버전 히스토리

버전 1.0.0 (2024)

• 초기 릴리즈
• 전체 텔레그램 봇 API 통합
• 멀티채널 지원
• 대기열 시스템
• 템플릿 엔진
• 위험 관리 알림

라이선스

이 라이브러리는 메타트레이더 5에서 사용할 수 있도록 있는 그대로 제공됩니다. 개인 및 상업적 용도로는 무료입니다.

저자

금융 청사진
전문 트레이딩 솔루션

면책 조항

이 소프트웨어는 어떠한 종류의 보증도 없이 "있는 그대로" 제공됩니다. 트레이딩은 상당한 손실 위험을 수반하며 모든 투자자에게 적합하지 않습니다. 과거 성과가 미래 결과를 보장하지 않습니다.

---

이 라이브러리가 유용하다고 생각되면 MQL5 코드베이스에서 평가해 주세요!

자세한 설정 지침

텔레그램 봇 만들기

1. 봇파더 찾기

   • 텔레그램 열기
   • 봇파더 검색
   • 시작을 누릅니다.

2. 새 봇 만들기

   • newbot 명령 보내기
   • 봇 이름 입력 (예: "내 트레이딩 봇")
   • 봇 사용자 이름 입력(예: my_trading_bot)
   • 토큰을 다음과 같이 저장합니다: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

3. 봇 구성

   • setprivacy를 보내고 비활성화(그룹 기능의 경우)를 선택합니다.
   • setjoingroups를 보내고 활성화를 선택합니다(그룹에 추가하려면).

채팅 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. "chat":{"id":-123456789} 찾기 - 그룹의 경우 음수

채널의 경우:

1. 봇을 채널 관리자로 추가하기
2. 채널에 메시지 보내기
3. 또는 @채널명을 채팅 ID로 사용

일반적인 문제 해결하기

웹 요청 오류:

해결 방법 1. 도구 → 옵션 → 전문가 상담원 2. 나열된 URL에 대해 WebRequest 허용 3. 추가: https://api.telegram.org 4. MT5 재시작

봇이 응답하지 않습니다:

확인: 1. 토큰 정확성 2. 채팅 ID 정확성 3. 인터넷 연결 상태 4. 웹리퀘스트 설정

메시지가 전달되지 않았습니다:

가능한 원인 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%
================