ExMachina Telegram Bridge - MetaTrader 5 için uzman

NE YAPAR

EA, ticaret olaylarını iki bağımsız mekanizma aracılığıyla algılar: gerçek zamanlı algılama için OnTradeTransaction işleyicisi ve yedek olarak periyodik bir anlaşma geçmişi taraması. Tekilleştirme sistemi, her iki mekanizma da aynı olayda tetiklense bile aynı bildirimi asla iki kez almamanızı sağlar.

Desteklenen bildirimler:

- Açılan işlem: sembol, yön (AL/SAT), hacim, fiyat, SL, TP, sihirli sayı, işlem bileti

- İşlem kapandı: sembol, hacim, kapanış fiyatı, brüt K/Z, komisyon, takas, net K/Z, güncellenmiş bakiye

- SL/TP değiştirildi: eski ve yeni değerler yan yana görüntülenir (örn. SL: 1924.00 → 1926.50)

- Verilen bekleyen emirler: tür (Alış Limiti, Satış Limiti, Alış Durdurma, Satış Durdurma, Alış Durdurma Limiti, Satış Durdurma Limiti), fiyat, hacim

- Pozisyonun tersine çevrilmesi: yeni yön, kapalı K/Z

- Para yatırma ve çekme işlemleri: miktar ve güncellenmiş bakiye

- Periyodik hesap özetleri: bakiye, öz sermaye, serbest marj, değişken P/L, seans P/L, açık pozisyonlar, günlük yüksek/düşük öz sermaye, düşüş yüzdesi

- Oturum istatistikleri ile bağlantı ve bağlantı kesme mesajları

KURULUM - ADIM ADIM

Telegram'dan iki şeye ihtiyacınız var: bir Bot Jetonu ve Sohbet Kimliğiniz.

Adım 1: Bir Telegram Botu Oluşturun

Telegram'ı açın, @BotFather'ı arayın ve bir konuşma başlatın. /newbot komutunu gönderin. BotFather sizden bir görünen ad (istediğiniz herhangi bir şey) ve bir kullanıcı adı ("bot" ile bitmelidir) seçmenizi isteyecektir. BotFather oluşturulduktan sonra size bir API belirteci gönderir - 7123456789:AAH1bCdEfGhIjKlMnOpQrStUvWxYz gibi görünen uzun bir dize. Bu belirteci kopyalayın.

Adım 2: Sohbet Kimliğinizi Alın

Telegram'da @userinfobot'u (veya @getmyid_bot) arayın ve ona herhangi bir mesaj gönderin. Sayısal Sohbet Kimliğinizle yanıt verecektir (örneğin 123456789). Bu numarayı kopyalayın.

Grup bildirimleri için: botunuzu bir Telegram grubuna ekleyin, ardından grup Sohbet Kimliğini (negatif sayı, örneğin -1001234567890) almak için gruptaki @getidsbot'u kullanın.

Adım 3: Botunuzla Bir Sohbet Başlatın

Bu adımı unutmak kolaydır. Botunuzu Telegram aramasında kullanıcı adına göre bulun, açın ve Başlat'a basın. Bunu atlarsanız, Telegram'ın API'si tüm mesajları reddedecektir.

Adım 4: MetaTrader 5'te WebRequest'e İzin Verin

MT5'te Araçlar → Seçenekler → Uzman Danışmanlar'a gidin. "Listelenen URL için WebRequest'e İzin Ver" seçeneğini işaretleyin. Ekle'ye tıklayın ve tam olarak girin: https://api.telegram.org - ardından Tamam'a tıklayın. Bu tek seferlik bir yapılandırmadır. Bu adımı atlarsanız, Experts sekmesinde WebRequest error 4014 görürsünüz ve hiçbir mesaj gönderilmez.

Adım 5: EA'yı yükleyin

ExMachina_TelegramBridge.mq5 dosyasını MQL5/Experts/ klasörünüze kopyalayın (MT5'te Dosya → Veri Klasörünü Aç aracılığıyla erişin). MetaEditor'ü (F4) açın, dosyaya gidin ve Derle'ye (F7) basın. 0 hata(lar), 0 uyarı(lar) görmelisiniz.

Adım 6: Bir Grafiğe Ekleyin

EA'yı Navigator panelinden herhangi bir grafiğin üzerine sürükleyin. Ayarlar iletişim kutusuna Bot Belirtecinizi ve Sohbet Kimliğinizi yapıştırın. Tamam'a tıklayın. Saniyeler içinde, Telegram'da hesap numaranızı, sunucunuzu, bakiyenizi, öz sermayenizi ve açık pozisyon sayınızı gösteren bir bağlantı mesajı almalısınız.

GİRİŞ PARAMETRELERİ

Telegram Yapılandırması:

- Bot Token: @BotFather'dan API tokenınız (gerekli)

- Sohbet Kimliği: sayısal sohbet kimliğiniz (gereklidir, bir grup kimliği olabilir)

Bildirim Ayarları:

- İşlem Açıldığında Bildir: true/false (varsayılan: true)

- İşlem Kapanışında Bildir: true/false (varsayılan: true)

- SL/TP Değişikliğinde Bildir: true/false (varsayılan: true)

- Bekleyen Siparişlerde Bildir: true/false (varsayılan: true)

- Para Yatırıldığında/Çekildiğinde Bildir: true/false (varsayılan: true)

Hesap Özeti:

- Özet Rapor Aralığı: Kapalı, Her 1 Saatte Bir, Her 4 Saatte Bir, Her 8 Saatte Bir, Her 24 Saatte Bir (varsayılan: Her 4 Saatte Bir)

- Özeti Özete Dahil Et: true/false (varsayılan: true)

- Düşüş Bilgisini Dahil Et: true/false (varsayılan: true)

Ekran ve Stil:

- Mesaj Stili: Minimal (kompakt tek satır), Ayrıntılı (etiketlerle tam bilgi) veya Emoji-zengin (Unicode simgeleriyle ayrıntılı). Varsayılan: Emojice zengin.

- Grafikte Gösterge Tablosunu Göster: true/false (varsayılan: true)

- Gösterge Panosu Arka Planı, Metin Rengi, Vurgu Rengi: özelleştirilebilir. Varsayılan olarak ExMachina çelik paleti kullanılır.

Filtreler:

- Sembol Filtresi: izlenecek sembollerin virgülle ayrılmış listesi. Tüm semboller için boş bırakın. Örnek: "EURUSD,XAUUSD"

- Bildirim için Min Lot Büyüklüğü: bir bildirimi tetiklemek için minimum hacim. 0 = filtre yok. Mikro lotları görmezden gelmek için kullanışlıdır.

- Sihirli Sayı Filtresi: yalnızca bu belirli sihirli sayıya sahip işlemler için bildirimde bulunur. -1 = tüm işlemler (manuel dahil).

MESAJ STİLLERİ

Minimal - kompakt tek satırlı format:

XAUUSD | AL | 0,50 lot @ 1928,45

Detaylı - etiketlenmiş alanlarla yapılandırılmış:

TİCARET KAPANDI

━━━━━━━━━━━━━━━━━━━━

Sembol XAUUSD

Kapanış: SAT (yakın AL)

Hacim: 0,50 lot

Fiyat: 1935.20

───────────────────

Brüt K/Z: +340,00$

Komisyon: -$2.50

Takas: -$0,00

Net K/Z: +$337,50

Bakiye: 10,585.00 USD

Fırsat #182947363

Emoji-zengin (varsayılan) - Ayrıntılı ile aynı ancak her alan için Unicode simgeleri var. İşlem açılışlarında AL için yeşil, SAT için kırmızı daire gösterilir. Kapanışlarda kâr için bir onay işareti ve zarar için bir çarpı işareti gösterilir.

FİLTRELER

Sihirli Sayı filtresi, aynı hesapta birden fazla EA çalıştırıyorsanız özellikle kullanışlıdır. Yalnızca o EA'dan bildirim almak için belirli bir EA'nın sihirli numarasına ayarlayın. Her şeyi almak için -1 olarak ayarlayın (manuel işlemler dahil).

Sembol filtresi virgülle ayrılmış bir liste kabul eder: "XAUUSD,EURUSD,GBPUSD". Yalnızca bu semboller üzerindeki işlemler bildirim oluşturacaktır. Tüm sembolleri izlemek için boş bırakın.

HESAP ÖZETLERİ

Periyodik özetler şunları içerir: bakiye, öz sermaye, serbest marj, açık pozisyon sayısı, toplam değişken P/L (takas dahil), EA başlatıldığından beri oturum P/L, günün en yüksek öz sermayesi, günün en düşük öz sermayesi ve günün en yüksek seviyesinden hesaplanan düşüş yüzdesi.

Günlük düşüş limitlerini uzaktan izlemesi gereken prop firması yatırımcıları için kullanışlıdır. Aktif oturumlar sırasında aralığı 1 Saat olarak ayarlayın.

GRAFIK ÜSTÜ GÖSTERGE TABLOSU

Grafiğin sol üst köşesindeki kompakt bir durum paneli şunları gösterir:

- Bağlantı durumu: BAĞLI (yeşil) veya BAĞLANTISI KESİK (kırmızı)

- Bot kullanıcı adı

- Çalışan sayaçlar: gönderilen ve başarısız olan mesajlar

- ExMachina sloganı

Gösterge paneli varsayılan olarak ExMachina çelik paletini kullanır (arka plan C'8,10,18', vurgu C'0,180,220') ve Ekran girişleri aracılığıyla özelleştirilebilir veya devre dışı bırakılabilir.

NASIL TEST EDİLİR

Adım 1: EA'yı bir demo hesabındaki herhangi bir grafiğe ekleyin. "Bot @YourBotName'e bağlandı" için Uzmanlar sekmesini kontrol edin. Bağlantı mesajı için Telegram'ı kontrol edin.

Adım 2: Manuel olarak küçük bir piyasa emri açın (örneğin 0,01 lot EURUSD). Bir "TRADE OPENED" bildirimi almalısınız.

Adım 3: Açık pozisyonunuzun SL veya TP'sini değiştirin (sağ tıklayın → Değiştir). Eski → yeni değerleri gösteren bir "SL/TP MODIFIED" bildirimi almalısınız.

Adım 4: Pozisyonu kapatın. P/L dökümü ile birlikte bir "TRADE CLOSED" bildirimi almalısınız.

Adım 5: Bekleyen bir emir verin (örneğin Limit Al). "BEKLEYEN EMİR VERİLDİ" bildirimi almalısınız.

Adım 6: EA'yı grafikten kaldırın. Oturum istatistiklerini içeren bir "Bağlantı Kesildi" mesajı almalısınız.

Hızlı tarayıcı testi: EA'yı kullanmadan önce token ve sohbet kimliğinizi doğrulamak için bu URL'yi herhangi bir tarayıcıya yapıştırın (yer tutucuları değiştirin):

https://api.telegram.org/bot<YOUR_TOKEN>/sendMessage?chat_id=<YOUR_CHAT_ID>&text=Test

Yanıtta {"ok":true} görürseniz, kimlik bilgileriniz doğrudur.

Hızlı duman testi komut dosyası: bunu MQL5/Scripts/ içinde bir Komut Dosyası (EA değil) olarak kaydedin, derleyin ve bir demo grafik üzerinde çalıştırın:

#include <Trade\Trade.mqh>

void OnStart()

{

CTrade ticaret;

trade.Buy(0.01, "EURUSD");

Sleep(3000);

for(int i = PositionsTotal()-1; i >= 0; i--)

{

if(PositionGetSymbol(i) == "EURUSD")

trade.PositionClose(PositionGetTicket(i));

}

}

Telegram'da hem açık hem de kapalı bir bildirim almalısınız.

Önemli: Bu EA, Strateji Test Cihazında çalışmaz. Strateji Test Cihazı WebRequest'i (ağ çağrıları) desteklemez. EA, internet erişimi olan canlı veya demo bir grafik üzerinde çalışmalıdır.

DİĞER EA'LARIN YANINDA ÇALIŞMAK

MT5, grafik başına yalnızca bir EA'ya izin verir. Telegram Köprüsü'nü ayrı bir grafiğe (herhangi bir sembol) ekleyin. Yalnızca bağlı olduğu grafiği değil, tüm hesabı izler. Tüm EA'lardan ve manuel işlemlerden gelen tüm işlemler, Köprünün hangi grafikte çalıştığına bakılmaksızın algılanacaktır.

Bildirimleri belirli bir EA ile sınırlamak için Sihirli Numara filtresini kullanın.

SORUN GIDERME

Mesaj alınmadı:

1. https://api.telegram.org'un Araçlar → Seçenekler → Uzman Danışmanlar → WebRequest'e İzin Ver'de olduğunu kontrol edin

2. Bot Token ve Sohbet Kimliğinin doğru olduğunu doğrulayın (fazladan boşluk yok)

3. Botunuzun Telegram sohbetinde Başlat'a bastığınızdan emin olun

4. Hata mesajları için Uzmanlar sekmesini (Görünüm → Araç Kutusu → Uzmanlar) kontrol edin

WebRequest hatası 4014: Telegram URL'si izin verilenler listesinde değil. Bu en yaygın sorundur.

HTTP 401 Yetkisiz: geçersiz Bot Token. BotFather'dan tekrar kopyalayın.

HTTP 400 Kötü İstek: yanlış Sohbet Kimliği veya botunuzla bir konuşma başlatmadınız.

HTTP 429 Çok Fazla İstek: Telegram hız sınırı. EA, geri çekilme ile yerleşik yeniden deneme mantığına sahiptir. Bu yalnızca son derece yüksek ticaret sıklığında gerçekleşir.

EA INIT_PARAMETERS_INCORRECT gösteriyor: Bot Token ve Sohbet Kimliğinin her ikisi de gereklidir. Her iki alanın da boş olmadığından emin olun.

Gösterge tablosu gösterilmiyor: EA girişlerinde "Gösterge Tablosunu Grafikte Göster" seçeneğinin true olarak ayarlandığından emin olun.

TEKNİK DETAYLAR

- İşlem algılama: OnTradeTransaction aracılığıyla ikili mekanizma (gerçek zamanlı) + her 2 saniyede bir işlem geçmişi yoklama (geri dönüş)

- Tekilleştirme: bellekte saklanan işlenmiş anlaşmalar (izlenen son 500 anlaşma)

- SL/TP algılama: pozisyon anlık görüntü dizisi her tikte karşılaştırılır, herhangi bir değişiklikte tetiklenir

- Telegram API: WebRequest aracılığıyla HTTPS POST, URL kodlu yük, Markdown ayrıştırma modu

- Yeniden deneme mantığı: mesaj başına en fazla 3 deneme, yeniden denemeler arasında 1 saniyelik gecikme, HTTP 429'da 3 saniyelik gecikme

- Bağlantı testi: /getMe uç noktası, belirteci doğrulamak ve bot adını almak için başlangıçta çağrılır

- Özet zamanlayıcı: EventSetTimer(60) yapılandırılan aralığın geçip geçmediğini kontrol eder

- Grafik nesneleri: tüm gösterge tablosu nesneleri "EXTB_" önekini kullanır ve deinit sırasında temizlenir

- Harici DLL'ler yok, üçüncü taraf sunucular yok. HTTPS üzerinden doğrudan MT5 → Telegram iletişimi.

Bu EA ücretsiz ve açık kaynaklıdır. Geri bildirim, derecelendirme ve önerilerinizi bekliyoruz.

ExMachina Ticaret Sistemleri - Kârdan önce hassasiyet.