Paper Mode Detaylı Rehber

Paper Mode Nedir?

Paper mode (kağıt üzerinde trading veya dry run), grid botunuzu gerçek para kullanmadan çalıştırma moddur. Bot tüm normal işlemlerini yapar — fiyat takibi, grid seviyeleri hesaplama, emir gönderme, fill tespiti, TP yönetimi — ancak hiçbir emir gerçek borsaya iletilmez. Bunun yerine dahili bir simülasyon motoru emirleri sanal olarak işler.

Bu mod, yeni bir stratejiyi test etmek, parametreleri optimize etmek veya botun davranışını anlamak için vazgeçilmezdir.

Simülasyon Motoru Nasıl Çalışır?

Gridera’nın paper mode’u basit bir “rastgele eşleşme” değil, gerçekçi bir simülasyon motorudur. Üç temel bileşen vardır:

SimOrderBook — Sanal Emir Defteri

SimOrderBook, gerçek borsanın emir defterini taklit eder. Paper mode’da gönderilen tüm limit emirler bu sanal deftere yazılır. Her cycle’da güncel mark price ile karşılaştırılır:

• BUY emri: Mark price, emrin fiyatına eşit veya altına düştüğünde emir “filled” olarak işaretlenir.
• SELL (TP) emri: Mark price, emrin fiyatına eşit veya üstüne çıktığında emir “filled” olarak işaretlenir.

Bu mantık gerçek borsadaki limit emir davranışını yakından taklit eder.

SimWallet — Sanal Cüzdan

SimWallet, paper mode’daki bakiye ve pozisyon takibini yapar:

• Başlangıç bakiyesi config’den alınır
• Her BUY fill’de bakiyeden düşer, pozisyon açılır
• Her TP fill’de bakiyeye eklenir, pozisyon kapatılır
• Ücretler hesaplanır ve bakiyeden düşülür
• PnL (kâr/zarar) gerçek zamanlı olarak izlenir

FillModel — Eşleşme Modeli

FillModel, emirlerin ne zaman ve nasıl eşleştiği konusunda kararlar verir:

• Limit emirler, fiyat seviyeye ulaştığında anında eşleşir (gerçekte partial fill olabilir, simülasyonda tam eşleşme varsayılır)
• Market emirler anında eşleşir
• Slippage simülasyonu yoktur (gerçekte büyük emirlerde slippage olabilir)

Paper Mode Aktif Etme

Config dosyanızda dry_run parametresini true yapın:

execution:
  dry_run: true
  debug: true   # Paper mode'da debug açmak önerilir

Bot başladığında logda şu mesajı göreceksiniz:

[DRY RUN] Simülasyon modu aktif. Gerçek emir gönderilmeyecek.

Gerçekçi Olan ve Olmayan Yönler

Paper mode ile gerçek trading arasında farklar vardır. Bu farkları anlamak, paper mode sonuçlarını doğru yorumlamanız için kritiktir.

Gerçekçi Olan

Gerçekçi Olmayan

Önemli: Paper mode sonuçları genellikle gerçekten %10-30 daha iyi görünür. Slippage, partial fill ve latency’nin olmaması kâr rakamlarını şişirir. Paper mode’da %5 getiri gördüyseniz, gerçekte %3.5-4.5 beklemeniz daha gerçekçidir.

Canlıya Geçiş Öncesi Test Kontrol Listesi

Paper mode’da yeterli test yaptıktan sonra canlıya geçiş için şu listeyi kontrol edin:

Strateji Doğrulaması

• En az 3 gün (tercihen 7 gün) paper mode’da çalıştırdınız
• Grid break olmadan çalıştı (aralık uygun)
• Günlük en az 2-3 döngü tamamlandı (spacing uygun)
• Fee/kâr oranı %10’un altında kaldı
• Toplam PnL pozitif

Parametre Kontrolü

• Grid aralığı mevcut volatiliteye uygun
• Seviye sayısı ve spacing mantıklı
• Leverage seçimi risk toleransınıza uygun
• Emir büyüklüğü bakiyenize uygun
• Grid break buffer ayarları doğru

Teknik Kontrol

• Bot hatasız çalıştırdı (logda kritik hata yok)
• Reconciliation düzgün çalıştı (eksik emir tespiti)
• TP emirleri doğru fiyatlarda gönderildi
• Clean shutdown test edildi (shutdown.flag ile)

Sermaye Kontrolü

• Gerçek hesapta yeterli bakiye var
• Bakiye >= emir_usd x seviye_sayısı x 1.2
• Kaybetmeyi göze aldığınız tutarla başlıyorsunuz

Paper Mode’dan Canlı Moda Geçiş

Geçiş için tek değişiklik config dosyasındadır:

execution:
  dry_run: false    # true'dan false'a değiştirin
  debug: false      # Canlı modda debug kapatılabilir

Botu yeniden başlatın. Bot artık gerçek emirler gönderecektir.

Öneriler:

1. Kademeli geçiş: İlk canlı denemede emir büyüklüğünü paper mode’dan düşük tutun. Örneğin paper mode’da $100 kullandıysanız, canlıda $50 ile başlayın. Her şey düzgün çalıştığını gördüğünüzde artırın.

2. İlk 24 saat: Botu yakından izleyin. Logları kontrol edin. Emirlerin doğru fiyatlarda açıldığını, TP’lerin doğru geldiğini doğrulayın.

3. Geri dönüş planı: Herhangi bir sorun görürseniz shutdown.flag dosyası oluşturarak botu güvenle durdurun. Bu, clean shutdown tetikler ve tüm emirleri iptal eder.

Paper vs Live Sonuç Karşılaştırması

Paper mode ve canlı mod sonuçlarını karşılaştırarak simülasyonun ne kadar gerçekçi olduğunu ölçebilirsiniz:

Yaygın Tuzaklar

1. Paper Mode’a Fazla Güvenmek

Paper mode sonuçları her zaman gerçekten daha iyidir. “Paper mode’da %20 kazandım, canlıda da kazanırım” düşüncesi tehlikelidir. Her zaman %20-30 daha düşük getiri bekleyin.

2. Yetersiz Test Süresi

1-2 gün paper mode yeterli değildir. Piyasa koşulları değişir — düşük volatilite, yüksek volatilite, ani düşüş, haber etkisi. En az 5-7 gün, ideal olarak farklı piyasa koşullarını kapsayan 2 hafta test edin.

3. Farklı Parametrelerle Geçiş

Paper mode’da test ettiğiniz parametrelerle canlıya geçin. “Paper mode’da 10 seviye test ettim ama canlıda 20 seviye kullanayım” yapmak, test etmediğiniz bir stratejiyi canlı çalıştırmak demektir.

4. Debug Loglarını Okumamak

Paper mode’da debug: true açın ve logları düzenli okuyun. Loglar, botun neden emir gönderip göndermediğini, reconciliation sonuçlarını ve olası sorunları gösterir. Bu bilgiler canlı modda karşınıza çıkacak sorunları önceden görmemizi sağlar.

5. Funding Rate’i Göz Ardı Etmek

Paper mode funding rate hesaplamaz. Ancak canlı perpetual pozisyonlarda her 8 saatte bir funding rate ödenir veya alınır. Uzun süre açık kalan pozisyonlarda bu maliyet birikebilir. Özellikle negatif funding dönemlerinde (long pozisyon için) bu ek maliyeti hesaba katın.

Özet

• Paper mode, gerçek para riskini almadan strateji test etmenin en güvenli yoludur.
• Simülasyon motoru gerçek fiyat verisi kullanır ancak slippage, partial fill ve latency simülasyonu yoktur.
• Paper mode sonuçları gerçekten %10-30 daha iyi görünür; beklentinizi buna göre ayarlayın.
• Canlıya geçiş öncesi en az 5-7 gün test edin ve kontrol listesini tamamlayın.
• Kademeli geçiş yapın: düşük emir büyüklüğü ile başlayın, ilk 24 saat yakından izleyin.
• Paper mode’da test ettiğiniz parametrelerin aynısını canlı modda kullanın.

Sonraki Adım

Paper mode ile stratejinizi doğruladıktan sonra, botun iç mekanizmasını anlayarak daha bilinçli kararlar verebilirsiniz:

Grid Botun İç Mekanizması →