Bir borsa API anahtarı eklediğinizde, Freya kaydetmeden önce onu kontrol eder — ve bir sorun varsa, neyi düzeltmeniz gerektiğini size söyler. Bu rehber, o sonucu okumanıza ve düzeltmenize yardımcı olur. (Anahtarınız zaten sorunsuz bağlandıysa ama sonradan bir bot durduysa, bu farklı bir sorundur — bkz. Botum Neden Duraklattı veya Durdu?.)
İlk kez kurulum adımları için Borsanızı Nasıl Bağlarsınız ile başlayın; bu makale, o bağlantı başarısız olduğunda ne yapmanız gerektiğiyle ilgilidir.
Önemli Noktalar
- Bir anahtar eklediğinizde, Freya kaydetmeden önce bağlanıp bağlanmadığını ve doğru izinlere sahip olup olmadığını kontrol eder — bir şey başarısız olursa, hata size neyi düzeltmeniz gerektiğini söyler.
- “Geçersiz API Anahtarı/Gizli Anahtar” genellikle bir kopyala/yapıştır hatası veya yeniden üretilmiş bir anahtar anlamına gelir; “IP” hataları ise anahtarın IP kısıtlamasının Freya'nın ihtiyaç duyduğuyla eşleşmediği anlamına gelir.
- Anahtarınızın okuma ve işlem izinlerine (asla para çekme değil) sahip olması ve botunuzla eşleşecek şekilde doğru piyasa için — spot veya vadeli — etkinleştirilmiş olması gerekir.
- OKX anahtarları, tam olarak eşleşmesi gereken bir parola gerektirir; vadeli anahtarlar için Freya, botun doğru şekilde işlem yapabilmesi için hesabınızı otomatik olarak hazırlar.
- Genel bir “Bağlantı Başarısız” hatası genellikle anlık bir ağ veya borsa aksaklığıdır — sadece tekrar deneyin.
Bir Anahtar Bağlanmadığında
Bir anahtar eklemek, körü körüne bir kaydetme işlemi değildir — Freya, anahtarı şifreli olarak saklamadan önce çalıştığını ve doğru izinlere sahip olduğunu doğrular. Bir sorun varsa, hata sizi doğrudan nedene yönlendirir — genellikle anahtar veya gizli anahtar, IP kısıtlaması ya da eksik bir izin. Aşağıdaki bölümler her hatayı ve nasıl düzeltileceğini adım adım ele alır.
"Geçersiz API Anahtarı" veya "Geçersiz Gizli Anahtar"
En yaygın bağlantı hatası ve genellikle en basit olanı:
- Bir kopyala/yapıştır hatası — araya kaçan bir boşluk veya eksik bir karakter. Hem anahtarı hem de gizli anahtarı dikkatlice yeniden kopyalayın.
- Gizli anahtar yalnızca bir kez gösterilir. Borsalar, gizli anahtarı siz oluşturduğunuzda yalnızca bir kez gösterir. Kaydetmediyseniz, onu kurtaramazsınız — yeni bir anahtar oluşturun.
- Anahtar, borsada silindi veya yeniden üretildi, bu yüzden artık eşleşmiyor.
Düzeltme: anahtarı ve gizli anahtarı tam olarak yeniden girin ya da yeni bir anahtar oluşturup tekrar deneyin.
IP Kısıtlaması Hataları
Freya kendi sunucularından bağlanır, bu yüzden anahtarın IP ayarları önemlidir. İki farklı durum vardır:
- "IP Beyaz Listede Değil" — anahtarınız IP kısıtlıdır, ancak Freya'nın sunucu adresi izin listesinde değildir. API Anahtarı Ekle ekranı, eklemeniz gereken IP adres(ler)ini size gösterir (kopyalama düğmesiyle birlikte) — bunları borsadaki anahtarın beyaz listesine ekleyin.
- "Kısıtlanmamış" — anahtarınızın hiç IP kısıtlaması yoktur. Güvenliğiniz için Freya, sizden IP kısıtlamasını açmanızı ve gösterdiği adresi eklemenizi, ardından tekrar denemenizi ister.
Her iki durumda da düzeltmenin mantığı aynıdır: anahtarı, Freya'nın pencerede gösterdiği IP'ye kısıtlayın.
İzin Hataları
Anahtar bağlandı, ama botunuzun ihtiyaç duyduğu şeyi yapamıyor:
- Okuma devre dışı — anahtarda okuma/görüntüleme iznini etkinleştirin.
- İşlem izni eksik — işlem yapmayı etkinleştirin (botunuza uygun olarak spot ve/veya vadeli).
- Spot–Vadeli uyuşmazlığı — bir vadeli bot, vadeli işlemin etkin olduğu bir anahtara ihtiyaç duyar; bir spot bot ise spot işleme ihtiyaç duyar. Bir vadeli bot için yalnızca spot bir anahtar eklediyseniz (veya tam tersi), Freya bunu işaretler. Anahtarın etkin piyasasının oluşturduğunuz botla eşleştiğinden emin olun.
Unutmayın: Freya'nın ihtiyaç duyduğu izinler yalnızca okuma ve işlem izinleridir — asla para çekme değil. Para çekme izni olmayan bir anahtar tam olarak istediğiniz şeydir.
Borsaya Özgü İncelikler
- OKX bir parola gerektirir. Bir OKX anahtarı oluşturduğunuzda bir parola belirlersiniz — o aynı parolayı, belirlediğiniz gibi tam olarak Freya'ya girin. Yanlış bir parola, yaygın bir OKX bağlantı hatasıdır.
- OKX vadeli kurulumu. OKX vadeli işlemi belirli bir hesap moduna ihtiyaç duyar ve Freya bunu sizin için otomatik olarak ayarlar — manuel olarak yapılandırmanıza gerek yoktur.
- Hedge modu (vadeli). Freya, vadeli hesaplar için hedge modunu kullanır. Bununla çelişen açık tek yönlü pozisyonlarınız zaten varsa, bir başarısızlık yerine bir uyarı görebilirsiniz — anahtar yine de kaydedilir ve mevcut pozisyonlar kapandığında botunuz işlem yapabilir.
- Binance ve Bybit bir parola kullanmaz — onlar için bir parola alanı yoktur.
Net Bir Neden Olmadan "Bağlantı Başarısız"
Genel bir bağlantı hatası çoğu zaman sizin hatanız değildir — anlık bir ağ kesintisi ya da borsanın kısa süreliğine yoğun olması. Bir an bekleyip tekrar deneyin. Birkaç denemeden sonra hâlâ başarısız oluyorsa, yukarıdaki anahtar/gizli anahtar ve IP ayarlarını yeniden kontrol edin.
Hâlâ Takıldınız mı? Hızlı Bir Kontrol Listesi
- Anahtarı borsada yalnızca okuma + işlem ile yeniden oluşturun (asla para çekme değil).
- Freya'nın API Anahtarı Ekle ekranında gösterdiği IP'ye kısıtlayın.
- Piyasayı eşleştirin — spot bot için spot anahtarı, vadeli bot için vadeli anahtarı.
- OKX: tam parolayı girin.
- Hâlâ başarısız mı? [email protected] ile iletişime geçin.
Sıkça Sorulan Sorular
Freya "Geçersiz API Anahtarı" diyor ama doğru kopyaladığımdan eminim — sorun ne?
Genellikle anahtara veya gizli anahtara gizli bir karakter ya da boşluk sızmıştır, ya da anahtar borsada yeniden üretilmiş/silinmiştir ve artık eşleşmemektedir. Her iki alanı da dikkatlice yeniden kopyalayın ve gizli anahtarın oluşturulurken yalnızca bir kez gösterildiğini unutmayın — sizde yoksa, yeni bir anahtar oluşturun.
"IP Beyaz Listede Değil" ile "Kısıtlanmamış" arasındaki fark nedir?
"IP Beyaz Listede Değil", anahtarınızın IP kısıtlı olduğu ama Freya'nın sunucu adresine henüz izin verilmediği anlamına gelir — Freya'nın gösterdiği adresi anahtarın beyaz listesine ekleyin. "Kısıtlanmamış" ise anahtarın hiç IP kısıtlamasının olmadığı anlamına gelir; güvenlik için Freya, kaydetmeden önce sizden IP kısıtlamasını açmanızı ve kendi adresini eklemenizi ister.
OKX anahtarım bağlanmıyor — parolaya ihtiyacım var mı?
Evet. OKX anahtarlarının, anahtarı oluştururken belirlediğiniz bir parolası vardır. O tam parolayı Freya'ya girmeniz gerekir — yanlış ya da eksik bir parola, yaygın bir OKX bağlantı hatasıdır. Binance ve Bybit parola kullanmaz.
Freya anahtarımın işlem açamayacağını söylüyor — bunu nasıl düzeltirim?
Anahtarınızın, botunuzun kullandığı piyasa için işlem izni etkin değildir. Borsada işlem iznini etkinleştirin — spot bot için spot işlem, vadeli bot için vadeli işlem — ardından yeniden bağlanın. Freya'nın okuma ve işlem izinlerine ihtiyacı vardır, asla para çekme iznine değil.
Vadeli anahtarım ekstra kuruluma ihtiyaç duyuyor (hesap modu / hedge modu) — bu bir sorun mu?
Hayır. Vadeli işlem, belirli bir hesap modu ve hedge modu gerektirir ve Freya bunu sizin için otomatik olarak ayarlar. Mevcut tek yönlü pozisyonlarınız varsa, bir hata yerine bir hedge modu uyarısı görebilirsiniz — anahtar yine de kaydedilir ve o pozisyonlar kapandığında botunuz işlem yapabilir.
Bir spot anahtarı ekledim ama vadeli botum onu kullanmıyor (veya tam tersi) — neden?
Bir anahtar belirli bir piyasa için etkinleştirilir. Bir vadeli bot, vadeli işlemin etkin olduğu bir anahtara ihtiyaç duyar; bir spot bot ise spot işleme. Eşleşmezlerse, Freya bunu işaretler. Etkin piyasası oluşturduğunuz botla eşleşen bir anahtar bağlayın.
Bağlantı net bir neden olmadan sadece "başarısız oldu" — sorun bende mi yoksa borsada mı?
Çoğu zaman bu, ayarlarınızdan değil, anlık bir ağ ya da borsa aksaklığından kaynaklanır. Bir an sonra tekrar deneyin. Hâlâ başarısız oluyorsa, anahtarı ve gizli anahtarı kopyalama hataları için yeniden kontrol edin ve IP kısıtlamasının Freya'nın gösterdiği adresle eşleştiğini doğrulayın.