AutoTrendLineAssistant

  • Indicadores
  • Semih Erten
    Semih Erten
    TRMentorFx — Otomatikleştirilmiş Forex Çözümleri
    2021 yılından bu yana forex piyasalarında aktif olarak çalışmaktayım. Bu süreçte edindiğim bilgi ve deneyimi, tamamen kendi geliştirdiğim strateji modellerine dönüştürdüm.
  • Versão: 2.0
  • Ativações: 5
# AUTO TREND LINE ASSISTANT v2.0
### MQL5 Market — Ürün Açıklaması / Çalışma Mantığı / Kullanım Talimatları

---

## 🔷 ÜRÜN AÇIKLAMASI (MQL5 Market Listing)

**Auto Trend Line Assistant v2.0**, piyasanın anlık yönünü otomatik olarak analiz eden ve kurallara dayalı şekilde yalnızca doğru trend çizgisini çizen akıllı bir MetaTrader 5 göstergesidir.

> **Tek cümleyle:** Yükselen piyasada sadece eğik destek, düşen piyasada sadece eğik direnç — fazlası yok, eksiği yok.

Klasik trend çizgisi araçlarının aksine bu gösterge, **gereksiz çizgilerle ekranı doldurmaz**. Piyasanın yapısını okur, yönüne karar verir ve o yöne uygun tek tip çizgiyi algoritmik doğrulukla yerleştirir.

---

### ✅ NE İŞE YARAR?

| Sorun | Çözüm |
|---|---|
| Manuel trend çizgisi çizmek zaman alır | Tamamen otomatik, her bar güncellemesinde yeniden hesaplar |
| Yanlış tip çizgi çizilir (düşen trendde destek aramak gibi) | Piyasa yönünü tespit edip sadece kurala uygun çizgi çizer |
| Pivot noktalarını gözle bulmak hatalı olur | Matematiksel pivot algoritması, sol/sağ bar karşılaştırmasıyla doğrular |
| Zayıf trend çizgileri güçlülerle karışır | Güç skoru (temas sayısı + uzunluk + güncellik) ile sıralama yapar |
| Temas ve kırılımları takip etmek zordur | Anlık Alert, Push Bildirim ve E-posta uyarısı sistemi |

---

### 🎯 TEMEL ÖZELLİKLER

- **Akıllı Piyasa Yönü Tespiti** — Higher High/Higher Low ve Lower High/Lower Low yapısıyla trend yönü belirlenir
- **Kural Bazlı Çizgi Seçimi** — Yükselen trendde SADECE eğik destek, düşen trendde SADECE eğik direnç
- **ATR Tabanlı Tolerans** — Temas ve kırılım eşikleri piyasanın volatilitesine göre otomatik ayarlanır
- **Güç Skoru Algoritması** — Her çizgiye temas sayısı, uzunluk ve güncellik skoruna göre puan verilir, en güçlüler öne çıkar
- **Çoklu Çizgi Desteği** — Aynı anda en fazla N adet trend çizgisi gösterilir (parametreyle ayarlanır)
- **Gerçek Zamanlı Uyarılar** — Fiyat çizgiye temas ettiğinde ve çizgiyi kırdığında anında bildirim
- **Görsel Pivot İşaretleri** — Tepe ve dip pivotları grafik üzerinde işaretlenir
- **Bilgi Paneli** — Piyasa yönü, aktif çizgi sayısı, pivot sayısı ve ATR değeri canlı gösterilir
- **Tüm Sembol ve Zaman Dilimlerine Uyumlu** — Forex, Kripto, Hisse, Emtia, Endeks

---

### 📊 UYUMLU PLATFORMLAR

- MetaTrader 5 (Build 2000+)
- Tüm broker ve semboller
- Tüm zaman dilimleri (M1'den MN'e kadar)

---

---

## ⚙️ ÇALIŞMA MANTIĞI

### ADIM 1 — Pivot Noktalarının Tespiti

Gösterge, her hesaplama döngüsünde klasik **Williams Fractal** mantığına benzer bir pivot algoritması çalıştırır.

**Tepe Pivot (Pivot High):**
Bir bar, solundaki `InpLeftBars` kadar barın en yüksek değerinden ve sağındaki `InpRightBars` kadar barın en yüksek değerinden büyükse bu bar bir **pivot tepe** olarak işaretlenir.

**Dip Pivot (Pivot Low):**
Aynı mantıkla, bir bar solundaki ve sağındaki tüm barların en düşük değerinden küçükse bu bar bir **pivot dip** olarak işaretlenir.

> Örnek: `InpLeftBars = 5`, `InpRightBars = 3` → Bir tepe pivotu oluşabilmesi için o barın solundaki 5 bar ve sağındaki 3 barın hepsinden yüksek olması gerekir.

---

### ADIM 2 — Piyasa Yönünün Belirlenmesi

Son bulunan pivot noktaları karşılaştırılarak piyasa yapısı okunur:

```
Higher High + Higher Low → YÜKSELEN TREND (TREND_UP)
Lower High  + Lower Low  → DÜŞEN TREND   (TREND_DOWN)
Karışık yapı             → YATAY         (TREND_SIDEWAYS)
```

Pivot bazlı analizin yanı sıra, `InpTrendLookback` periyodundaki kapanış fiyatı değişimi ve ortalama bar aralığı da yardımcı kriter olarak kullanılır.

---

### ADIM 3 — Kurala Göre Trend Çizgilerinin Seçimi

Bu, göstergenin kalbidir. Şu kural **asla değişmez:**

| Piyasa Yönü | Çizilen Çizgi Tipi | Kullanılan Pivotlar |
|---|---|---|
| YÜKSELEN | Sadece Eğik Destek | Dip Pivotları (Low) |
| DÜŞEN | Sadece Eğik Direnç | Tepe Pivotları (High) |
| YATAY | Her iki tip | Her iki pivot grubu |

**Yükselen Piyasada Eğik Destek Algoritması:**
1. Tüm dip pivot çiftleri kombinasyonları incelenir
2. Eğim pozitif olmak zorundadır (Higher Lows yapısı)
3. İki pivot arasında minimum bar mesafesi kontrolü yapılır
4. Çizgi boyunca tüm barlar taranır — fiyat çizginin tolerans dışı altına inmemeli
5. Minimum temas sayısı (`InpMinTouches`) sağlanmalı
6. Güç skoru hesaplanır ve sıralanır

**Düşen Piyasada Eğik Direnç Algoritması:**
1. Tüm tepe pivot çiftleri kombinasyonları incelenir
2. Eğim negatif olmak zorundadır (Lower Highs yapısı)
3. Çizgi boyunca fiyat tolerans dışı üstüne çıkmamalı
4. Minimum temas ve güç skoru kriterleri uygulanır

---

### ADIM 4 — Güç Skoru Hesaplama

Her aday trend çizgisine 0–100 arasında bir **güç puanı** verilir:

```
Güç = Temas Skoru (40%) + Uzunluk Skoru (30%) + Güncellik Skoru (30%)

Temas Skoru   = min(temas_sayısı / 5, 1.0) × 40
Uzunluk Skoru = min(çizgi_uzunluğu / 100 bar, 1.0) × 30
Güncellik     = max(0, (50 - son_pivottan_uzaklık) / 50) × 30
```

En yüksek puanlı çizgiler grafiğe çizilir. `InpMaxTrendLines` parametresiyle kaç çizgi gösterileceği belirlenir.

---

### ADIM 5 — ATR Tabanlı Tolerans Sistemi

Sabit pip değeri yerine **ATR (Average True Range)** kullanılması, göstergenin farklı enstrümanlarda ve farklı volatilite ortamlarında tutarlı çalışmasını sağlar.

```
Temas Toleransı = ATR(14) × InpTouchTolerance
Kırılım Toleransı = ATR(14) × InpBreakTolerance
```

- Düşük volatilite dönemlerinde tolerans daralır → daha hassas
- Yüksek volatilite dönemlerinde tolerans genişler → sahte kırılımları filtreler

---

### ADIM 6 — Uyarı Sistemi

**Temas Uyarısı:**
Mevcut barda fiyat (High veya Low), trend çizgisine temas toleransı içine girdiğinde tetiklenir.

**Kırılım Uyarısı:**
Önceki bar çizginin doğru tarafında kapanırken mevcut bar çizginin yanlış tarafında kırılım toleransını aşarak kapanırsa tetiklenir. Kırılan çizgi otomatik olarak deaktive edilir.

Uyarı kanalları: `Alert()` penceresi · Push Bildirim · E-posta

---

---

## 📋 KULLANIM TALİMATLARI

### Kurulum

1. `.ex5` dosyasını indirin
2. MetaTrader 5'i açın
3. **Dosya → Veri Klasörü Aç** → `MQL5/Indicators/` klasörüne dosyayı kopyalayın
4. MetaTrader 5'i yeniden başlatın veya **Navigator** panelinde sağ tık → **Yenile** yapın
5. İstediğiniz grafik üzerine sürükleyip bırakın

---

### Parametre Ayarları

#### 🔧 Trend Tespit Ayarları

| Parametre | Varsayılan | Açıklama |
|---|---|---|
| `InpLeftBars` | 5 | Pivot tespiti için solda kaç bar bakılacak. Düşürürseniz daha fazla pivot bulur, artırırsanız daha az ama daha güçlü pivotlar |
| `InpRightBars` | 3 | Pivot tespiti için sağda kaç bar bakılacak. Düşük değer daha hızlı sinyal verir |
| `InpTrendLookback` | 50 | Piyasa yönü hesabında kullanılan bar sayısı |
| `InpMinTouches` | 2 | Bir trend çizgisinin geçerli sayılması için minimum temas sayısı. 3'e yükseltirseniz sadece çok güçlü çizgiler gösterilir |
| `InpTouchTolerance` | 0.3 | Temas için kabul edilen mesafe (ATR çarpanı). Büyütürseniz daha "geniş" temaslar kabul edilir |
| `InpBreakTolerance` | 0.5 | Kırılım için gereken mesafe (ATR çarpanı). Büyütürseniz daha az kırılım uyarısı alırsınız |
| `InpMaxTrendLines` | 3 | Aynı anda gösterilecek maksimum trend çizgisi sayısı |

#### 🎨 Görsel Ayarlar

| Parametre | Varsayılan | Açıklama |
|---|---|---|
| `InpSupportColor` | DodgerBlue | Eğik destek çizgisi rengi |
| `InpResistanceColor` | OrangeRed | Eğik direnç çizgisi rengi |
| `InpLineWidth` | 2 | Çizgi kalınlığı (1–5) |
| `InpShowPivots` | true | Pivot noktalarını grafik üzerinde göster/gizle |
| `InpShowInfo` | true | Sol üst köşedeki bilgi panelini göster/gizle |

#### 🔔 Uyarı Ayarları

| Parametre | Varsayılan | Açıklama |
|---|---|---|
| `InpAlertTouch` | true | Fiyat trend çizgisine temas ettiğinde uyarı |
| `InpAlertBreak` | true | Trend çizgisi kırıldığında uyarı |
| `InpPushNotify` | false | MetaTrader mobil uygulamasına push bildirim gönder |
| `InpEmailNotify` | false | MT5 ayarlarındaki e-posta adresine bildirim gönder |

---

### Önerilen Ayarlar (Kullanım Senaryosuna Göre)

#### 📈 Scalping (M1–M5)
```
InpLeftBars     = 3
InpRightBars    = 2
InpTrendLookback = 30
InpMinTouches   = 2
InpTouchTolerance = 0.4
InpMaxTrendLines  = 2
```

#### 📊 Swing Trading (H1–H4)
```
InpLeftBars     = 5
InpRightBars    = 3
InpTrendLookback = 50
InpMinTouches   = 2
InpTouchTolerance = 0.3
InpMaxTrendLines  = 3
```

#### 📉 Pozisyon Trading (D1–W1)
```
InpLeftBars     = 8
InpRightBars    = 5
InpTrendLookback = 100
InpMinTouches   = 3
InpTouchTolerance = 0.25
InpMaxTrendLines  = 2
```

---

### Grafik Üzerinde Göstergeler

| Görsel Öğe | Anlamı |
|---|---|
| 🔵 Mavi yukarı ok | Dip pivot noktası tespit edildi |
| 🔴 Kırmızı aşağı ok | Tepe pivot noktası tespit edildi |
| Mavi eğik çizgi | Aktif eğik destek (yükselen trendde) |
| Kırmızı eğik çizgi | Aktif eğik direnç (düşen trendde) |
| Çizgi etiketi | Çizgi tipi + temas sayısı gösterir |
| Sağ üst panel | Piyasa yönü, aktif çizgi sayısı, ATR |

---

### Uyarılar Nasıl Çalışır?

**Temas Uyarısı örneği:**
```
Eğik Destek TEMAS! | Fiyat: 1.08542 | Çizgi: 1.08510 | Temas #3
```
Bu uyarı, fiyatın destek çizgisine yaklaştığını gösterir.
→ Yükselen trendde bu, **alım fırsatı** sinyali olabilir.

**Kırılım Uyarısı örneği:**
```
Eğik Destek KIRILDI! | Fiyat: 1.08201 | Çizgi: 1.08490
```
Bu uyarı, destek çizgisinin aşağı kırıldığını gösterir.
→ **Trend dönüşü** veya **short fırsatı** sinyali olabilir.

---

### Sık Yapılan Hatalar ve Çözümleri

| Hata | Neden | Çözüm |
|---|---|---|
| Çizgi görünmüyor | Pivot bulunamadı | `InpLeftBars` ve `InpRightBars` değerlerini düşürün |
| Çok fazla çizgi var | `InpMinTouches` düşük | 3'e yükseltin |
| Yanlış trend yönü gösteriyor | `InpTrendLookback` çok kısa | Değeri artırın |
| Çok fazla uyarı geliyor | Toleranslar düşük | `InpTouchTolerance` değerini artırın |
| Kırılım uyarısı çok erken tetikleniyor | `InpBreakTolerance` düşük | 0.7–1.0 arasına yükseltin |

---

### ⚠️ Önemli Notlar

- Bu gösterge **analiz aracıdır**, tek başına alım/satım kararı vermez. Fiyat aksiyonu, hacim ve diğer analizlerle birlikte kullanın.
- Uyarılar **gecikmeli** tetiklenebilir; bar kapanışında değerlendirme yapılır.
- Push bildirimi için MetaTrader 5 hesabınızda MetaQuotes ID tanımlanmış olmalıdır.
- E-posta bildirimi için **Araçlar → Seçenekler → E-posta** menüsünden SMTP ayarları yapılmış olmalıdır.
- Gösterge, geçmiş bar verilerini kullanarak test edilebilir; ancak gerçek zamanlı performans için canlı piyasada gözlemleyin.

---

*Auto Trend Line Assistant v2.0 — Algoritmik Trend Analizi, Basit Kural, Güçlü Sonuç.*
Filtro:
Sem comentários
Responder ao comentário