Harmonic Pattern Pine v5

<!-- shields -->

Türkçe | English

TradingView’de hem otomatik hem manuel XABCD harmonik desen tespiti yapan açık-kaynaklı Pine Script indikatörü.
Gartley, Bat, Butterfly, Crab, Deep Crab, Shark ve Cypher desenlerini gerçek-zamanlı çizer, D noktası tahmin bölgesi (PRZ) oluşturur, uyum skoru verir ve alarm atar.

---

📌 Özellikler

Özellik	Açıklama
7 Desen	Gartley, Bat, Butterfly, Crab, Deep Crab, Shark, Cypher
İki Mod	Otomatik tarama / Manuel nokta girişi
Skorlama	0-100 % uyum oranı
PRZ	Çoklu-D hedef bölgesi (1.27-1.618 fib)
Alarm	D noktasına %1 yaklaşınca uyarı verir
Renk Temaları	Boğa/Ayı için ayrı renk, tema dostu
Hızlı	500 bara kadar optimize döngü
Ücretsiz	MIT lisansı, ticari kullanım serbest

---

🚀 3 Dakikada Kurulum

1. İndir
   Latest Release sayfasından harmonic-pattern-v5.pine dosyasını bilgisayarına kaydet.

2. TradingView’e Ekle

   • TradingView hesabına giriş yap → Pine Editor ⚙️
   • “Open” → “Import” → indirdiğin .pine dosyasını seç
   • “Add to Chart” → bitti!

3. Ayarları Yap (grafik üstü)

   • Sağ üstte ⚙️ (Ayarlar) → Inputs:
     • Çalışma Modu: “Otomatik” seçersen desenler kendiliğinden çizilir.
     • Minimum Skor %: 60 altındakileri göstermez.
     • D Hedef Bölgesi: Açık bırakırsan PRZ kutusunu çizer.

---

📊 Desen Oranları (Tolerans ±%15)

Desen	XAB	ABC	BCD	XAD
Gartley	0.618	0.382-0.886	1.27-1.618	0.786
Bat	0.382-0.50	0.382-0.886	1.618-2.618	0.886
Butterfly	0.786	0.382-0.886	1.618-2.24	1.27
Crab	0.382-0.618	0.382-0.886	2.618-3.618	1.618
Deep Crab	0.886	0.382-0.886	2.0-3.618	1.618
Shark	0.446-0.618	1.13-1.618	1.618-2.24	0.886-1.13
Cypher	0.382-0.618	1.13-1.41	1.27-2.0	0.786

---

🎯 Manuel Kullanım (XABC Noktaları)

1. Inputs → Çalışma Modu: “Manuel”
2. Aşağıdaki alanlara fiyatı ve tarihi yaz:
   • X, A, B, C (D opsiyonel)
3. Indikatör:
   • Deseni çizer
   • Otomatik D hesaplar
   • Oranları ve uyum % tabloda gösterir

---

🔔 Alarm Kurma

• Grafik üstü “Alerts” → “Create Alert”
• Condition: “Harmonic Pattern Pine v5” → “Any Alert() Function Call”
• Message: Harmonik D noktası yakın!
• Frequency: “Once Per Bar Close”

---

🎨 Renk Ayarları

Bileşen	Varsayılan	Açıklama
Boğa Deseni	Yeşil	Manuel
Ayı Deseni	Kırmızı	Manuel
Oto-Boğa	Mavi	%40 transparan
Oto-Ayı	Turuncu	%40 transparan
D Hedefi	Mor	PRZ kutusu

---

⚙️ Parametre Listesi

Input	Varsayılan	Aralık
Otomatik Geriye Bakış	100 bar	50-500
Minimum Skor	60 %	0-100
Pivot Uzunluğu	5 bar	3-20
Tolerans	%15	%1-30
Bacak Asimetrisi	%250	0-1000

---

🛠️ Güncelleme Nasıl Yapılır

1. GitHub’daki “Releases” → “Draft new release”
2. Tag: v1.1.0
3. Açıklamaya neyi değiştirdiğini yaz → Publish
4. Kullanıcılar aynı linkten (/releases/latest) yenisini indirir.

---

🐞 Hata Bildirimi

• GitHub → “Issues” → “New Issue” → Bug seçeneğini doldur.
• Gerekli: TradingView sembolü, zaman aralığı, ekran görüntüsü.

---

🤝 Katkıda Bulunma

1. Fork
2. Branch aç: feat/yeni-ozellik
3. Pull Request gönder
4. Pine syntax kontrolü otomatik çalışır.

---

📜 Lisans

MIT License – ticari kullanım dahil her türlü kullanım serbest.
Copyright (c) 2024 Your Name

---

<span id="english-summary">English Summary</span>

Open-source Pine v5 indicator that detects Gartley, Bat, Butterfly, Crab, Deep Crab, Shark and Cypher patterns on TradingView.

• Auto & manual modes
• Pattern-score 0-100 %
• Potential Reversal Zone (PRZ) box
• Alerts when price is 1 % away from point D
• MIT licensed – free for commercial use.

Download: Latest Release