Sayısal tüm kolonları float64'e çevirmek için örnek:

for col in ['open', 'high', 'low', 'close', 'volume']:
    if col in df.columns:
        df[col] = df[col].astype(float)

Temel sinif: Strategy. Ana metodlar: initialize() ve on_candle(candle, df). Sık kullanılan çağrılar: self.buy, self.sell, self.close_position, self.get_position, self.get_state, self.set_state, self.plot, self.mark.

Input'lar indikatör/strateji çalışırken kullanıcıya ayar sunar. Örnekler:

length = input.int(10, title="SMA Periyodu", minval=1)
alpha  = input.float(0.8, title="Denge Katsayısı", minval=0.0, step=0.1)
use_smooth = input.bool(True, title="Yumuşatma Açık")
label = input.string("SMA", title="Etiket")
color_line = input.color("#2962FF", title="Çizgi Rengi")

İmza: plot_indicator(indicator_name: str, plot_type: str, on_graph: bool, indicator_data: list[tuple], color, line_width). • indicator_name: Grafikte görünen ad. • plot_type: "line", "area", "histogram" vb. • on_graph: True → ana fiyat grafiği üzerinde, False → ayrı panel. • indicator_data: (timestamp, value) çiftlerinden oluşan liste. • color: HEX veya input.color ile gelen değer. • line_width: Çizgi kalınlığı. Basit SMA örneği:

length = input.int(10, title="SMA Periyodu", minval=1)
sma = df['close'].rolling(window=length, min_periods=1).mean()
plot_indicator(
    "SMA_" + str(length),
    "line",
    True,
    list(zip(df['timestamp'], sma)),
    color="#0000FF",
    line_width=1
)

Stratejinize terminalden başka bir indikatörü import edebilirsiniz. Komutlar: • cls → Terminali temizler • help → Komutları listeler • time → Geçerli zamanı gösterir • uptime → Sayfanın açık olduğu süreyi gösterir • import <indicator> → Belirtilen indikatörü içe aktarır • list imports → İçe aktarılan indikatörleri listeler • reset <indicator|imports> → Belirli veya tüm içe aktarımları kaldırır

• Parametrelerinizi initialize() icinde tanimlayin. • Mum bazli karar mantigini on_candle(candle, df) icine yazin. • Long acmak icin self.buy(...), short acmak icin self.sell(...), kapatmak icin self.close_position(...) kullanin. • Pozisyon ve state takibini self.get_position(), self.get_state() ve self.set_state() ile yonetin. • Gorsel izler icin self.mark(...) ve self.plot(...) kullanin. • Bu gorsel cagrilar daha cok backtest ve grafik inceleme tarafinda gorunur; canli calismada gorunur sonuc uretmeyebilir. Ornek iskelet:

class MyStrategy(Strategy):
    def initialize(self):
        self.fast = self.input.int(20, label="Fast EMA")
        self.slow = self.input.int(50, label="Slow EMA")
        self.risk_pct = self.input.float(25.0, label="Risk %")

    def on_candle(self, candle, df):
        if len(df) < self.slow:
            return

        fast_ema = df["close"].ewm(span=self.fast, adjust=False).mean().iloc[-1]
        slow_ema = df["close"].ewm(span=self.slow, adjust=False).mean().iloc[-1]
        pos = self.get_position()

        self.plot("Fast EMA", fast_ema, color="blue")
        self.plot("Slow EMA", slow_ema, color="orange")

        if pos["status"] == "CLOSED" and fast_ema > slow_ema:
            self.buy(percentage=self.risk_pct)
            self.mark(label="Long", color="green", shape="arrow_up")
        elif pos["status"] == "OPEN" and fast_ema < slow_ema:
            self.close_position()
            self.mark(label="Close", color="red", shape="arrow_down")

Kaldıraç kullanacaksaniz bunu genelde emir cagrisinda belirtirsiniz. Bu ozellikle futures senaryolarinda anlamlidir. Örnek:

self.buy(percentage=20, leverage=3.0)

Kaldıraç arttıkça risk belirgin şekilde büyür. Bu nedenle zarar durdur, kademeli çıkış veya daha küçük yüzde kullanımı birlikte düşünülmelidir.

TP/SL mantigi genelde fiyat seviyesi olarak hesaplanir ve emir cagrisina parametre olarak verilir. Örnekler:

entry = float(candle["close"])
take_profit = entry + 50
stop_loss = entry - 30
self.buy(percentage=20, take_profit=take_profit, stop_loss=stop_loss)

tp_pct = self.input.float(2.5, label="TP (%)")
sl_pct = self.input.float(1.0, label="SL (%)")
entry = float(candle["close"])
self.buy(
    percentage=20,
    take_profit=entry * (1 + tp_pct / 100.0),
    stop_loss=entry * (1 - sl_pct / 100.0),
)

Guncel strateji modelinde dinamik takip icin state kullanimi daha dogru yaklasimdir. Ornegin bir onceki EMA degeri, son grid seviyesi, sayaç veya kademeli risk bilgisi self.get_state() / self.set_state() ile tutulabilir. Örnek:

last_grid = self.get_state("last_grid", default=None)
if last_grid is None:
    self.set_state("last_grid", -1)

• self.mark(label=..., color=..., shape=..., note=...) aktif mum uzerine tek bir isaret ekler. Genelde alis, satis, cikis veya ozel olaylari etiketlemek icin kullanilir. • self.plot(name, value, color=..., panel=...) ise cizgi veya seri degerlerini grafik uzerinde gostermek icin kullanilir. • Bu gorseller backtest ve grafik inceleme akisinda anlamlidir; canli calismada gorunur sonuc uretmeyebilir. Ornek:

self.plot("Fast EMA", fast_ema, color="blue")
self.plot("Slow EMA", slow_ema, color="orange")
self.mark(label="Long", color="green", shape="arrow_up")
self.mark(label="Exit", color="red", shape="arrow_down", note="EMA kirilimi")

• Toplam getiri, Max Drawdown, Win/Loss oranı, Profit Factor, Sharpe/Sortino (uygunsa) • İşlem listesi (giriş/çıkış zamanları, fiyat, PnL, komisyon) • Zaman serisi kâr eğrisi • İndikatör ve sinyal işaretleri ile senkronize grafik

Beğendiğiniz koşuları arşivleyip daha sonra karşılaştırabilirsiniz. Arşiv; strateji sürümü, parametreler, tarih aralığı ve sonuç metriklerini içerir.

Yeni Bot oluşturma formu; Bot Adı, Tür (Spot/Futures), API bağlantısı, Strateji seçimi, Periyot, Minimum Mum Sayısı, Çalışma Gün/Saatleri ve Çoklu Coin listesi alanlarını içerir. ‘Mevcut sinyalde hemen gir’ seçeneği işaretlendiğinde, bot uygun alım bölgesindeyse ilk sinyali beklemeden pozisyona giriş yapar.

Stratejinizin doğru çalışması için ihtiyaç duyduğu geçmiş verinin miktarını yazmanız gerekir. Örneğin EMA(200) kullanıyorsanız 200 mum + tampon veri önerilir. Emin değilseniz 5.000 yazabilirsiniz; bu, botunuzun tepki süresini uzatabilir ancak veri bütünlüğünü garanti eder.

Bağlı API’den anlık bakiyeniz çekilir ve kaydırma çubuğu ile bota ayıracağınız toplam tutarı belirleyebilirsiniz. Birden fazla coin eklendiğinde toplam riskinizi stratejinizin emir yüzdelerine göre planlamalısınız. Aynı anda birden fazla sembolde giriş tetiklenebileceği için, strateji içindeki percentage değerlerini toplam maruziyetinizi aşmayacak şekilde seçin. Botunuzun oluşturduğu emirlerin pratikte çok küçük kalmaması için tahsis ve yüzde planlamasını dengeli yapın.

Botlar, ana sayfada kartlar halinde listelenir. Her kartta API adı, strateji, periyot, planlanan gün/saat, izlenen kripto paralar ve bot durumu (Aktif/Pasif) yer alır. Güç sembolü (yeşil/kırmızı) botun çalışma durumunu.

• Çalıştır (Run): Bot, gerçek zamanlı veri akışıyla sinyalleri uygular. • Güvenli Kapatma (Shutdown): Tüm açık pozisyonlar kapatılır, ardından bot durdurulur. Bu işlem geri alınamaz. • Sil (Delete): Bot silinir; açık işlemleri kapatmaz. Yalnızca risksiz durumlarda önerilir. • Panik butonu: Onayladığınızda tüm botlarınızın tüm pozisyonları kapatılır.

Kiralık botlarda kalan süre, bot kartı üzerinde net biçimde gösterilir. Süre bitiminde sistem, açık pozisyonları emir tiplerine uygun şekilde kapatır ve botu otomatik olarak kapatır. Bu süreç, kullanıcı müdahalesi olmadan güvenli kapanış sağlar.

Bot detay penceresinde kâr/zarar grafiği (yüzdesel), anlık işlem listesi, komisyon etkisi, yön (BUY/SELL), kaldıraç, miktar ve tutar bilgileri sunulur. ‘Açık Pozisyonlar’ ve ‘Spot/Futures Varlıklar’ panelleri portföyünüzü anlık olarak yansıtır. İşlem ve sistem olayları, zaman damgalı loglar altında izlenebilir.

‘Panik Butonu’ acil durumlarda tüm botları durdurur ve açık pozisyonları güvenli biçimde kapatır. İşlem geri alınamaz olduğundan, ikinci bir onay ekranı ile teyit alınır. Bu özellik; beklenmedik piyasa oynaklığı veya altyapı risklerinde zarar kontrolü için tasarlanmıştır.

Vitrinde işlem yapabilmek için Phantom cüzdanınızı bağlamanız gerekir. Cüzdan bağlantısı olmadan satın alma ve kiralama işlemleri mümkün değildir. İlk bağlantıda kullanıcıya Phantom Wallet yükleme yönlendirmesi yapılır. Bağlantı sonrası bakiye (SOL) kontrolü sistem tarafından otomatik yapılır.

Bir bot geliştiricisi olarak, botunuzu satışa veya kiralığa çıkarabilirsiniz. İlan oluştururken: • Satış Bedeli: Botun kalıcı satış fiyatı (USD). • Kiralama Bedeli: Günlük ücret (USD/gün). • Gelir Cüzdan Adresi: Doğru cüzdan adresini girmek tamamen sizin sorumluluğunuzdadır. Yanlış adres girildiğinde sistem geri ödeme yapmaz. • İlan Açıklaması: Botun stratejisi, kullanım senaryoları ve risk uyarıları. İlan oluşturulurken Solana üzerinden tek seferlik 1 USD ilan ücreti tahsil edilir. İşlem Phantom üzerinden onaylanır ve geri alınamaz.

Tüm ödeme ve ilan işlemleri Phantom cüzdan ile imzalanır. Kullanıcılar işlem öncesinde tutarı, ağ ücretini ve tahmini SOL karşılığını görür. ‘Onayla’ ile işlem blokzincire yazılır, geri dönüş mümkün değildir. Yanlış onay veya hatalı adres girişi sonucu oluşan kayıplar tamamen kullanıcı sorumluluğundadır.

Vitrindeki botlar, satış ve kiralama fiyatlarıyla listelenir. Her bot için toplam kâr yüzdesi, Spot/Futures türü ve performans geçmişi gösterilir. Kullanıcılar arama kutusu üzerinden bot veya geliştirici adına göre filtreleme yapabilir.

Bir bot kiralandığında, günlük fiyat üzerinden toplam bedel hesaplanır ve Phantom cüzdan üzerinden ödeme yapılır. Kiralama süresi bitiminde bot otomatik olarak kapanır ve açık işlemler sistem tarafından güvenli biçimde kapatılır.

Satın alınan veya kiralanan botlar, kullanıcı panelinde gerçek zamanlı takip edilir. Kâr grafiği, işlem geçmişi, açık pozisyonlar ve performans oranları şeffaf olarak sunulur.

• Doğru cüzdan adresi girmek ve Phantom işlem onaylarını dikkatle kontrol etmek tamamen kullanıcının sorumluluğundadır. • Yanlış adres girilmesi veya yanlış işlem onayı geri alınamaz ve Whaleer herhangi bir sorumluluk kabul etmez. • Pazar yerinde listelenen botların strateji başarısı ve risk profili geliştiriciye aittir; kullanıcıların detayları dikkatle inceleyerek karar vermesi gerekir.

API bağlamak için borsanızdan aldığınız API Key ve Secret Key bilgilerini girmeniz gerekir. Doğrulama sonrası sistem, bakiye ve hesap bilgilerini kontrol ederek bağlantıyı aktif hale getirir.

Eklediğiniz tüm API anahtarlarını liste halinde görüntüleyebilir, düzenleyebilir veya silebilirsiniz. Varsayılan API, profil sayfanız açıldığında otomatik seçili gelir; ancak bu sadece kullanım kolaylığı içindir. Botlarınızı başlatırken dilediğiniz API’yi manuel seçebilirsiniz.

Bir API silindiğinde, bu API’ye bağlı çalışan tüm botlar otomatik olarak devre dışı bırakılır. Eğer aktif botlarınız varsa, önce güvenli şekilde kapatılır, ardından API anahtarı sistemden kaldırılır. Bu işlem geri alınamaz.

API anahtarlarınızı Binance üzerinden oluşturup Whaleer platformuna ekleme süreci detaylı bir eğitim videosu ile anlatılmaktadır. Video, adım adım rehberlik ederek kullanıcıların güvenli bağlantı yapmasına yardımcı olur.

• API anahtarınızı hiçbir zaman üçüncü kişilerle veya açık platformlarda paylaşmayın. • Yalnızca gerekli izinleri verin; para çekme yetkisi her zaman kapalı olmalıdır. • API anahtarınız aktif ve geçerli olmalıdır; iptal edilen anahtarlar botların çalışmasını engeller.

Tüm botların doğru çalışabilmesi için Enable Reading seçeneği mutlaka aktif edilmelidir. Bu izin, sadece bakiye ve piyasa bilgilerini görüntülemeye yarar, herhangi bir fon transferine izin vermez.

Spot piyasada işlem yapmak isteyen kullanıcıların bu izni aktif etmesi gerekir. Bu yetki, botun alım-satım emirlerini göndermesine olanak tanır. Margin kullanımı tercih edilmediği sürece yalnızca spot işlemler için sınırlı kalır.

Futures işlemler (Futures) kullanan botlar için bu izin zorunludur. Etkinleştirilmediği takdirde futures tabanlı stratejiler çalışmaz.

Spot ve Futures hesapları arasında bakiye aktarımı yapacak botlar için bu yetki açılmalıdır. Bu izin olmadan sistem, fonlar arasında otomatik geçiş yapamaz.

• Enable Withdrawals seçeneği her zaman kapalı tutulmalıdır.

class SmaRsiMacdStrategy(Strategy):
    def initialize(self):
        self.length_sma = self.input.int(50, label="SMA Periyodu")
        self.rsi_len = self.input.int(14, label="RSI Periyodu")
        self.risk_pct = self.input.float(25.0, label="Risk %")

    def on_candle(self, candle, df):
        if len(df) < self.length_sma:
            return

        close = df["close"].astype(float)
        sma = close.rolling(window=self.length_sma, min_periods=1).mean().iloc[-1]

        delta = close.diff()
        gain = delta.clip(lower=0)
        loss = (-delta).clip(lower=0)
        rs = gain.rolling(self.rsi_len, min_periods=self.rsi_len).mean().iloc[-1] / max(loss.rolling(self.rsi_len, min_periods=self.rsi_len).mean().iloc[-1], 1e-10)
        rsi = 100 - (100 / (1 + rs))

        pos = self.get_position()
        if pos["status"] == "CLOSED" and candle["close"] > sma and rsi < 70:
            self.buy(percentage=self.risk_pct)
            self.mark(label="Buy", color="green", shape="arrow_up")
        elif pos["status"] == "OPEN" and rsi > 75:
            self.close_position()
            self.mark(label="Exit", color="red", shape="arrow_down")

Bu yaklaşım, guncel proje yapisindaki gibi sinif tabanli strateji mantigini ve emir cagrilarini kullanir.

class TrendLeverageStrategy(Strategy):
    def initialize(self):
        self.ema_period = self.input.int(200, label="EMA")
        self.base_pct = self.input.float(20.0, label="Baz Yüzde")

    def on_candle(self, candle, df):
        if len(df) < self.ema_period:
            return

        ema = df["close"].astype(float).ewm(span=self.ema_period, adjust=False).mean().iloc[-1]
        dist = (float(candle["close"]) - ema) / ema if ema else 0.0
        pos = self.get_position()

        if pos["status"] == "CLOSED" and dist > 0.02:
            leverage = 2.0 if dist <= 0.04 else 3.0
            self.buy(percentage=self.base_pct, leverage=leverage)
            self.mark(label="Trend Long", color="green", shape="arrow_up")
        elif pos["status"] == "OPEN" and dist < 0:
            self.close_position()
            self.mark(label="Exit", color="orange", shape="arrow_down")

Bu ornek, kaldiraci position kolonu yerine dogrudan emir cagrisinda tanimlayan guncel yaklasimi gosterir.

Guncel yapida ana kavramlar Strategy sinifi, initialize(), on_candle(), emir metodlari ve state yonetimidir. Islem buyuklugu genelde self.buy(percentage=...) veya self.sell(percentage=...) ile, kaldirac ise gerekirse leverage= parametresiyle verilir.

Whaleer'da TP/SL mantigi genelde emir cagrisinda fiyat seviyesi olarak verilir. Oransal bir hedef kullanmak istiyorsaniz, once kendi strateji mantiginizda bunu fiyata cevirip sonra self.buy(..., take_profit=..., stop_loss=...) gibi parametrelerle kullanabilirsiniz.

0–1 aralığında ondalık bir değerdir (örn. 0.001 = %0.1). Borsanızın işlem komisyonuna yakın seçmeniz backtest uyumu için önemlidir.

Kullandığınız indikatörlerin pencere boyutlarını düşünün (örneğin EMA 200 + tampon). Emin değilseniz 5000 üst sınırı kullanabilirsiniz; bu performansı etkileyebilir.

Birden fazla coin ayni anda sinyal uretebilecegi icin strateji icindeki percentage degerlerini toplam maruziyetinizi asmayacak sekilde planlamalisiniz. Esit dagilim bir zorunluluk degildir; onemli olan toplam riskin hesabinizla uyumlu kalmasidir.

Açık tüm işlemler otomatik kapatılır ve bot kendini kapatır.