Hata Mesajları ve Çözümleri

Hata Mesajları ve Çözümleri

Grid bot çalıştırırken çeşitli hata mesajlarıyla karşılaşabilirsiniz. Bu rehberde en sık görülen hataların sebeplerini ve çözümlerini inceliyoruz. Her hata için nedenini, etkisini ve adım adım çözümünü bulacaksınız.

BALANCE_CHECK Hatası

Neden: Bot başlarken hesap bakiyesinin yeterli olup olmadığını kontrol eder. Gerekli minimum bakiye formülü: order_usd x grid_levels x 1.2. Bu tutarın altında bakiye varsa bot başlatılmaz.

Etkisi: Bot başlamaz. Mevcut emirler ve pozisyonlar etkilenmez çünkü bot henüz işlem yapmamıştır.

Çözüm: Hesabınıza yeterli bakiye ekleyin. Alternatif olarak grid_levels sayısını azaltarak veya order_usd değerini düşürerek gerekli minimum bakiyeyi küçültebilirsiniz. Örneğin 1000 dolar bakiyeniz varsa ve hata alıyorsanız: 1000 / 1.2 = 833 dolar’a kadar toplam emir hacmi ayarlayabilirsiniz. 10 seviye için order_usd: 83 uygun olur.

RUNLOCK Hatası

Neden: Aynı kullanıcı ve sembol için zaten çalışan bir bot instance’ı var. Gridera aynı piyasada aynı anda yalnızca bir bot çalıştırmaya izin verir. Bu koruma duplicate emirleri ve tutarsız state’i önler.

Etkisi: İkinci bot başlatma denemesi reddedilir. Zaten çalışan bot etkilenmez ve çalışmaya devam eder.

Çözüm: Öncelikle zaten çalışan bir bot olup olmadığını kontrol edin. Dashboard’da bot durumuna bakın. Eğer bot çalışıyorsa ve ikinci bir tane başlatmak istiyorsanız önce mevcut botu durdurun. Bot durmuş görünüyor ama RUNLOCK hatası alıyorsanız önceki bot’un temiz kapanamadığı anlamına gelir. Redis üzerindeki kilit kaydını temizleyin veya kilit TTL’sinin dolmasını bekleyin.

API Timeout Hatası

Neden: Pacifica API’ye yapılan istek belirlenen süre içinde yanıt almadı. Sebepleri arasında borsanın yoğun olması, internet bağlantı sorunu veya API sunucularında gecikme bulunur.

Etkisi: Timeout olan istek başarısız sayılır. Eğer REST open_orders isteği timeout olursa o cycle’da hiçbir emir gönderilmez. Bu bir güvenlik mekanizmasıdır ve duplicate emirleri önler. Bot bir sonraki cycle’da tekrar dener.

Çözüm: Tek seferlik timeout normaldir ve bot otomatik olarak toparlanır. Sürekli timeout alıyorsanız internet bağlantınızı kontrol edin. Pacifica API durumunu borsanın status sayfasından kontrol edin. cycle_interval_sec değerini artırarak API’ye daha az istek gönderin. VPN kullanıyorsanız farklı bir sunucu deneyin.

WebSocket Disconnect

Neden: WebSocket bağlantısı koptu. Sebepleri arasında internet kesintisi, borsanın WS sunucusunda sorun veya uzun süreli inaktivite sayılabilir.

Etkisi: WS bağlantısı koptuğunda bot gerçek zamanlı fiyat ve emir bilgisi alamaz. Fiyat için REST fallback devreye girer ancak gecikme artar. Emir bildirimlerinde gecikme fill tespitini yavaşlatır.

Çözüm: Bot otomatik olarak WS yeniden bağlantı dener. Çoğu durumda birkaç saniye içinde bağlantı yeniden kurulur. Sürekli kopma yaşanıyorsa internet bağlantınızı kontrol edin. Firewall veya proxy ayarlarınızı gözden geçirin çünkü bazı ağlar WS bağlantılarını engelleyebilir. Loglardan yeniden bağlantı sıklığını izleyin; dakikada birden fazla yeniden bağlantı ciddi bir altyapı sorunu işaret eder.

Grid Break

Neden: Mark fiyat grid aralığının dışına çıktı. Fiyat grid_low altına düştüğünde veya grid_high üstüne çıktığında tetiklenir. Buffer mekanizması (varsayılan yüzde 0.2) küçük aşılmaları tolere eder ancak buffer’ı aşan hareketlerde grid break aktif olur.

Etkisi: Bot clean_shutdown protokolünü başlatır. Sırasıyla tüm entry emirleri iptal edilir, tüm TP emirleri iptal edilir ve açık pozisyonlar market emriyle kapatılır. Bot durur.

Çözüm: Grid break sonrası şu adımları izleyin. Pacifica web arayüzünden gerçek pozisyon ve emir durumunu doğrulayın. Clean_shutdown’ın başarılı tamamlandığını loglardan kontrol edin. Yeni piyasa koşullarına göre grid parametrelerini güncelleyin. Özellikle grid_low ve grid_high değerlerini güncel fiyata uyumlu hale getirin. Botu yeni parametrelerle yeniden başlatın.

Grid break’i azaltmak için: daha geniş grid aralığı kullanın, ATR bazlı aralık hesabı yapın, grid break buffer_pct değerini artırın ve önemli haber öncesinde botu durdurun.

Diğer Yaygın Hatalar

INSUFFICIENT_MARGIN: Emir göndermek için yeterli marjin yok. Açık pozisyonlar çok fazla marjin kullanıyor. Pozisyon küçültün veya bakiye ekleyin.

ORDER_REJECTED: Borsa emri reddetti. Sebep genellikle hatalı fiyat, yetersiz bakiye veya minimum notional altında emir büyüklüğü. Log mesajındaki detaylı sebebi kontrol edin.

RATE_LIMIT: API istek limiti aşıldı. cycle_interval_sec değerini artırarak istek sıklığını azaltın.

Genel Sorun Giderme Adımları

Hangi hata ile karşılaşırsanız karşılaşın şu genel adımları izleyin: önce log dosyasını inceleyin (logs/ klasörü), hata mesajını tam olarak okuyun, Pacifica web arayüzünden gerçek emir ve pozisyon durumunu doğrulayın, gerekirse botu durdurup yeniden başlatın. Kod değişikliği yapmadan önce mevcut durumu belgeleyin.

Özet

• BALANCE_CHECK yetersiz bakiyede, RUNLOCK aynı piyasada ikinci bot denemesinde oluşur ve çözümleri basittir
• API timeout ve WS disconnect genellikle geçicidir, bot otomatik toparlanır, sürekli oluşursa altyapı kontrolü yapın
• Grid break sonrası clean_shutdown doğrulayın, yeni parametrelerle botu yeniden başlatın ve daha geniş aralık kullanmayı düşünün

Sonraki Adım

Grid Trading’in Avantajları ile devam edin.