---
name: smc_detector
description: "Grafik üzerindeki fiyat hareketlerinden swing noktaları, Smart Money Concepts (BOS, CHOCH, FVG) ve Harmonik formasyonları tarar ve otomatik çizim koordinatları üretir."
---

# SMC & Harmonic Detector Skill

Bu yetenek, fiyat grafiklerindeki yapısal piyasa modellerini (Smart Money Concepts, Fibonacci Harmonikleri) geometrik kurallar ve ekstrem taramaları ile yakalamak üzere tasarlanmıştır.

## Algoritma ve Kurallar

1. **Swing Noktaları (Tepe/Dip):**
   - Belirlenen zaman penceresindeki local extrema noktalarını bulur. Otomatik çizimlerin tepe ve dip referans noktaları bu swing barlarından türetilir.

2. **Fair Value Gaps (FVG):**
   - 3 ardışık barın oluşturduğu verimsiz likidite boşluklarını yakalar.
   - Boğa FVG bölgesinin üst sınırı 3. barın en düşüğü (`low`), alt sınırı 1. barın en yükseğidir (`high`). Bu dikey alanlar SVG katmanında renklendirilerek retest uyarıları tetiklenir.

3. **BOS / CHOCH (Yapı Kırılımları):**
   - Trend yönünde bir swing tepesinin veya dibinin gövde kapanışıyla aşılması durumunda **Break of Structure (BOS)**; trend yönünün değiştiğini ima eden kırılımlarda ise **Change of Character (CHOCH)** işaretlenir.

## Ajanlar İçin Kullanım Talimatı

Fiyat verileri üzerinde FVG ve swing analizlerini çalıştırmak için:

```python
import pandas as pd
from skills.smc_detector.detector import SMCDetector

# 1. Örnek OHLCV verisi oluştur
data = {
    "open": [10.0, 10.5, 11.2, 11.5, 12.0],
    "high": [10.6, 11.0, 11.3, 12.2, 12.5],
    "low": [9.9, 10.4, 11.1, 11.4, 11.9],
    "close": [10.4, 10.9, 11.2, 12.1, 12.3],
    "volume": [1000, 1500, 1200, 3000, 2500]
}
df = pd.DataFrame(data)

# 2. Detector'ı başlat ve FVG'leri tarat
detector = SMCDetector(swing_window=2)
fvgs = detector.detect_fair_value_gaps(df)
print(fvgs)
```