Bir bot sizin için işlem yapabilmeden önce, Freya'nın paranızın bulunduğu borsayla — Binance, OKX veya Bybit — bir bağlantı kurması gerekir. Bunu yapmak için paranızı taşımaz veya şifrenizi paylaşmazsınız. Bunun yerine bir API anahtarı oluşturursunuz: Freya'nın sizin adınıza işlem yapmasına izin veren, ancak paranızın kendi borsa hesabınızda kalmasını sağlayan kısıtlı bir kimlik bilgisi.
Bu rehber, tam olarak hangi izinleri vermeniz (ve hangilerini asla vermemeniz) gerektiğini, anahtarı Freya'ya nasıl ekleyeceğinizi ve bağlantı doğrulanmadığında ne yapacağınızı açıklar. Bunun neden güvenli olduğuna dair daha geniş bir bakış istiyorsanız, önce Param Freya Finance'te Güvende mi? makalesini okuyun.
Önemli Noktalar
- Bir borsayı, para taşıyarak veya borsa şifrenizi paylaşarak değil, kısıtlı bir kimlik bilgisi olan bir API anahtarıyla bağlarsınız.
- Anahtarın Okuma ve Spot ve/veya Vadeli işlem izinlerine ihtiyacı vardır. ASLA çekim iznine sahip olmamalıdır.
- OKX anahtarları, oluştururken belirlediğiniz bir parola gerektirir; Binance ve Bybit gerektirmez.
- Anahtarı Freya'da Ayarlar → API Anahtarları → API Anahtarı Ekle altından ekleyin; Freya onu anında doğrular.
- Doğrulama başarısız olursa, Freya nedenini tam olarak söyler — geçersiz anahtar, beyaz listede olmayan IP veya eksik bir izin — ve her birinin basit bir çözümü vardır.
Adımlara Hızlı Bir Bakış
- Borsanızda bir API anahtarı oluşturun — okuma ve işlem izinleriyle, ancak çekim izni olmadan.
- Kimlik bilgilerini kopyalayın — API anahtarını, gizli anahtarı ve (OKX için) parolayı.
- Anahtarı Freya'ya ekleyin — Ayarlar → API Anahtarları → API Anahtarı Ekle altından ve borsanızı seçin.
- Freya'nın doğrulamasına izin verin — Freya bağlantıyı ve izinleri hemen kontrol eder.
- Bildirdiği herhangi bir hatayı giderin — doğrulama başarısız olursa Freya tam olarak neyin yanlış olduğunu söyler.
API Anahtarı Nedir — ve Freya Hangi İzinlere İhtiyaç Duyar?
Bir API anahtarı, bir uygulamanın borsa hesabınızla sınırlı bir şekilde iletişim kurmasını sağlayan bir kimlik bilgisi çiftidir (bir anahtar ve bir gizli anahtar). O anahtarın neye izinli olduğuna siz karar verirsiniz. Freya için yalnızca şunları etkinleştirin:
- Okuma — Freya'nın bakiyelerinizi, pozisyonlarınızı ve emir durumunuzu görebilmesi için.
- Spot işlem ve/veya Vadeli işlem — botunuzun ihtiyaç duyduğu emirleri verebilmesi için. Çalıştırmayı planladığınız botlara uygun olanı etkinleştirin.
Freya işlem yapar; hesabınızdan para çıkarmaya asla ihtiyaç duymaz. Bağladığınız anahtarda çekim iznini her zaman devre dışı bırakın. Bu, borsada sizin kontrol ettiğiniz bir izindir — kapalı olduğunda ne Freya ne de anahtarı ele geçirebilecek herhangi biri paranızı çekemez. Herhangi bir bot platformunu bağlarken edinilecek en önemli alışkanlık budur.
Adım 1: Borsanızda Bir API Anahtarı Oluşturun
Borsanızın API yönetimi bölümünde yeni bir API anahtarı oluşturun:
- Binance — anahtarı API Yönetimi altında oluşturun, okuma ile Spot ve/veya Vadeli işlemi etkinleştirin ve çekimleri kapalı bırakın.
- OKX — anahtarı oluşturun ve bir parola belirleyin (Freya'da buna ihtiyaç duyacaksınız); okuma ve işlemi etkinleştirin, çekimleri değil.
- Bybit — anahtarı, kullanacağınız ürünler için okuma ve işlem izinleriyle oluşturun ve çekimleri kapalı bırakın.
Borsanız IP beyaz listesi sunuyorsa, anahtarı Freya'nın IP adresleriyle sınırlamak iyi bir uygulamadır. Bunu yaparsanız, Freya'nın IP'lerini beyaz listeye eklediğinizden emin olun, aksi takdirde bağlantı reddedilir (aşağıdaki hatalar tablosuna bakın).
Anahtarı oluşturduğunuzda, borsa gizli anahtarı yalnızca bir kez gösterir. Onu hemen kopyalayın ve güvende tutun. Kaybederseniz, kurtaramazsınız — anahtarı silip yenisini oluşturmanız gerekir.
Adım 2: Anahtarı Freya'ya Ekleyin
Freya'da Ayarlar → API Anahtarları bölümüne gidin ve API Anahtarı Ekle'yi seçin. Ardından:
- Borsanızı seçin (Binance, OKX veya Bybit).
- API anahtarını ve gizli anahtarı yapıştırın. OKX için, belirlediğiniz parolayı da girin.
- Anahtara bir ad verin ki onu daha sonra tanıyabilesiniz.
Birden fazla borsa bağlayabilir ve anahtarlarınızı istediğiniz zaman bu aynı sayfadan yönetebilir veya silebilirsiniz.
Adım 3: Freya Anahtarınızı Doğrular
Anahtarı ekler eklemez Freya bağlantıyı ve izinleri kontrol eder — tahmine yer yoktur. Her şey doğruysa, anahtar doğrulanır ve kullanıma hazır olur. Bir şey yanlışsa, Freya tam olarak neyi düzeltmeniz gerektiğini açıklayan net bir mesaj gösterir.
Doğrulama Hatalarını Anlamak
Doğrulama başarısız olursa, Freya'nın gösterdiği mesajı aşağıdaki çözümle eşleştirin:
| Freya'nın gösterdiği | Ne anlama geldiği | Nasıl düzeltileceği |
|---|---|---|
| Geçersiz API Anahtarı | Anahtar yanlış kopyalandı veya borsada silindi | API anahtarını tam olarak yeniden kopyalayın veya yenisini oluşturun |
| Geçersiz Gizli Anahtar | Gizli anahtar, anahtarla eşleşmiyor | Gizli anahtarı yeniden kopyalayın; kaybettiyseniz yeni bir anahtar oluşturun |
| IP Adresi Beyaz Listede Değil | Anahtar IP kısıtlamalı ve Freya'nın adresine izin verilmiyor | Anahtarda Freya'nın IP'lerini beyaz listeye ekleyin veya IP kısıtlamasını kaldırın |
| Eksik İzinler | Anahtarda okuma veya işlem izni yok | Anahtarda okuma ile Spot/Vadeli işlemi etkinleştirin |
| Okuma İzni Devre Dışı | Freya hesabınızı okuyamıyor | Anahtarda okuma/görüntüleme iznini etkinleştirin |
| Spot/Vadeli İzni Devre Dışı | Anahtar, botunuzun ihtiyaç duyduğu emirleri veremiyor | Botunuza uygun işlem türünü (Spot veya Vadeli) etkinleştirin |
| Bağlantı Başarısız | Geçici bir ağ veya borsa sorunu | Bir an bekleyin ve anahtarı tekrar eklemeyi deneyin |
Freya ayrıca "Kısıtlamasız" modunda olan — yani IP kısıtlaması olmayan — bir anahtarı da işaretler. Güvenliğiniz için Freya, anahtar kaydedilmeden önce IP kısıtlamasını açmanızı ve gösterdiği adresi eklemenizi ister. Yalnızca okuma ve işlemi etkinleştirin (asla çekimi değil) ve anahtarı Freya'nın IP'siyle sınırlayın. (Bağlantı hataları hakkında daha fazlası için Borsanızı Bağlayamıyor musunuz? makalesine bakın.)
Güvenlik Üzerine Bir Not
Bağlantı tasarım gereği güvenlidir, ancak birkaç alışkanlık onu böyle tutar:
- Çekim her zaman kapalı — Freya buna asla ihtiyaç duymaz.
- IP beyaz listesini kullanın — borsanız desteklediğinde.
- Bir anahtar, bir amaç — ve artık kullanmadığınız anahtarları silin.
Paranızın ve anahtarlarınızın nasıl korunduğuna dair tam tablo için Param Freya Finance'te Güvende mi? ve Borsa API Güvenliği ve Risk Azaltma makalelerine bakın.
Sıkça Sorulan Sorular
Freya API anahtarımda hangi izinlere ihtiyaç duyar?
Okuma (bakiyelerinizi, pozisyonlarınızı ve emirlerinizi görmek için) ve Spot ve/veya Vadeli işlem (botunuzun emirlerini vermek için). Çalıştıracağınız botlara uygun işlem türünü etkinleştirin. Freya çekim iznine asla ihtiyaç duymaz, bu yüzden onu her zaman devre dışı bırakın.
Freya'nın paramı çekmek için izne ihtiyacı var mı?
Hayır. Freya yalnızca işlem verir ve yönetir; paranızı borsanızdan çıkaramaz ve çıkarabilecek durumda olmamalıdır. Bağladığınız anahtarda çekim iznini her zaman kapalı bırakın — bu, borsada sizin kontrol ettiğiniz bir izindir.
Freya neden "IP Adresi Beyaz Listede Değil" diyor?
API anahtarınız belirli IP adresleriyle sınırlandırılmış ve Freya'nın adresi listede değil. Ya borsanızda anahtarın beyaz listesine Freya'nın IP adreslerini ekleyin ya da anahtardan IP kısıtlamasını kaldırın. Güncelledikten sonra anahtarı Freya'ya tekrar ekleyin.
Neden "Geçersiz API Anahtarı" veya "Geçersiz Gizli Anahtar" diyor?
Genellikle anahtar veya gizli anahtar yanlış kopyalanmış ya da anahtar borsada silinmiş veya yeniden oluşturulmuştur. Her iki değeri de tam olarak yeniden kopyalayın. Gizli anahtar, anahtarı oluşturduğunuzda yalnızca bir kez gösterildiği için, artık elinizde yoksa anahtarı borsada silip yeni bir tane oluşturun.
Parola nedir ve OKX neden onu sorar?
OKX API anahtarları, anahtarı oluştururken kendinizin belirlediği bir parola içerir — bu, anahtar ve gizli anahtarın yanında ek bir kimlik bilgisidir. Bir OKX anahtarı eklerken Freya'da aynı parolayı girin. Binance ve Bybit parola kullanmaz.
Birden fazla borsa bağlayabilir miyim?
Evet. Binance, OKX ve Bybit için API anahtarları ekleyebilir ve bunları Ayarlar → API Anahtarları bölümünden istediğiniz zaman yönetebilir veya silebilirsiniz.
API anahtarımı Freya'ya vermek güvenli mi?
Evet, anahtar doğru kurulduğunda — yalnızca okuma ve işlem, çekim yok ve mümkün olduğunda IP beyaz listesi. Paranız kendi borsanızda kalır ve paylaştığınız anahtar onu taşıyamaz. Tam açıklama için Param Freya Finance'te Güvende mi? makalesine bakın.
Freya hangi borsaları destekler?
Freya şu anda Binance, OKX ve Bybit'e (spot ve vadeli) bağlanır. Zamanla daha fazla borsa eklenebilir. Bunlardan hangisini bağlarsanız onda işlem yaparsınız — paranız ve mevcut piyasalar o borsada kalır.
Hangi coinleri veya işlem çiftlerini işleme sokabilirim?
Mevcut çiftler, ayrı bir Freya listesinden değil, bağladığınız borsanın kendi listelemelerinden gelir — yani borsanız bir çifti listeliyorsa (ör. BTC/USDT, ETH/USDT), onun üzerine bir bot kurabilirsiniz. İşlemlerin çoğu, teklif para birimi olarak USDT'ye karşı yapılır. Bir borsa bir çifti listeden çıkarırsa, o çift orada işleme sokulamaz hâle gelir.