Veriyi görün
Pozisyon, emir ve maliyet bilgilerini birbirine karıştırmadan takip edin.
Tüm adımları tek metinde okuyun
1. Başlamadan önce
SBekosistem → Borsalar
Borsanız bağlantıya açık mı?
SBekosistem’e giriş yapın ve Borsalar ekranındaki “Desteklenen Borsalar ve Yetenekler” tablosunu inceleyin. “Bağlanabilir” durumundaki borsalarla ilerleyin. “Yakında” veya kapalı bir borsanın API anahtarını oluşturmak onu desteklenen bir borsaya dönüştürmez.
Kontrol: Borsanızın adı, bağlantı durumu ve ihtiyacınız olan piyasa desteği birbiriyle uyumlu olmalı.
Kendi hesabınızı hazırlayın
Borsanın resmi web sitesine kendiniz gidin. Borsanın istediği kimlik doğrulamasını ve hesap güvenliği adımlarını tamamlayın; iki aşamalı doğrulamayı etkinleştirin. API oluşturma hakkı ülkenize, hesap türünüze ve borsanın kurallarına bağlı olabilir.
Kontrol: Borsa hesabına giriş yapabiliyor ve resmi API yönetimi bölümüne erişebiliyor olmalısınız.
Deneme ile gerçeği ayırın
Borsanız ve ilgili piyasa destekliyorsa önce Testnet veya Sandbox kullanın. Test ortamının anahtarı ile gerçek hesabın anahtarı farklı olabilir; birbirlerinin yerine geçmezler. Paper/simülasyon, borsanın Testnet ortamıyla aynı kavram değildir. Deneme ortamı yoksa sırf kılavuzu tamamlamak için gerçek işleme geçmeyin.
Kontrol: Anahtarı hangi ortamda oluşturduğunuzu not edin: Testnet, Sandbox veya Gerçek (Production).
Bu kılavuz bağlantıya açık borsalar için ortak yöntemdir. Her borsanın, bölgenin veya piyasanın desteklendiği anlamına gelmez.
2. API anahtarı oluşturun
Borsanız → API yönetimi
Doğru menüyü bulun
Borsanın hesap veya profil menüsünde “API”, “API Management” ya da “API ve bağlantılar” bölümünü arayın. Yeni anahtar oluşturmayı seçin. Menü adları değişebilir; aşağıdaki resmi yardım kaynaklarını kullanın. Mobil uygulamada menü yoksa borsanın resmi web sitesini deneyin.
Kontrol: Adres çubuğu borsanın resmi alan adını göstermeli; reklam, mesaj veya size gönderilen bir anahtar oluşturma bağlantısına güvenmeyin.
Ayırt edilebilir bir etiket verin
Anahtara “SBekosistem • Test hesabım” gibi amacını anlatan bir isim verin. Key ve Secret çifti sağlayan anahtar türünü kullanın; mevcut SBekosistem formu özel anahtar dosyası yükleme alanı sunmaz. Borsanın kendi ekranında istediği güvenlik onaylarını tamamlayın.
Kontrol: API Key ve API Secret aynı oluşturma işlemine ait olmalı. İki farklı anahtarın parçalarını birleştirmeyin.
Secret ve gerekiyorsa Passphrase’i koruyun
Secret çoğu borsada yalnızca oluşturulurken gösterilir. Gerekiyorsa güvenli bir parola yöneticisinde saklayın. Borsanız API için ayrıca Passphrase istiyorsa o değeri de koruyun; bu, borsa giriş parolanız değildir. Secret kaybolursa borsanın yenileme yönergesini izleyin.
Kontrol: Anahtarları ekran görüntüsüne, e-postaya veya sohbete eklemeyin. SBekosistem’de yalnızca gerçek “Anahtar Ekle” formuna girin.
SBekosistem bağlantısı için borsa giriş parolanızı, iki aşamalı doğrulama kodunuzu veya cüzdan kurtarma kelimelerinizi paylaşmayın.
3. İzinleri sınırlandırın
Borsanız → API izinleri
Okuma izinlerini inceleyin
Hesap, bakiye ve emir durumlarını okuyabilmek için borsanın ilgili okuma izinleri gerekebilir. İzin adları borsaya göre değişir. Yalnızca okuma yetkisi olan anahtarın emir gönderemeyeceğini bilin.
Kontrol: İzin açıklamalarını okuyun; tüm kutuları topluca işaretlemeyin.
Sadece kullanılacak piyasaya işlem izni verin
Spot için gerekli Spot işlem iznini, vadeli kullanım için ilgili vadeli işlem yetkisini değerlendirin. Gerekmeyen marjin, borçlanma, transfer veya hesap yönetimi yetkilerini açmayın. Borsa bazı izinleri birlikte sunuyorsa kapsamını resmi belgede okuyun; anlamadığınız geniş bir izni etkinleştirmeyin.
Kontrol: Borsa hesabının piyasa erişimi, anahtar izni ve SBekosistem planınızın yetkisi ayrı ayrı uygun olmalı.
Para çekme iznini kapalı tutun
“Withdraw”, “Withdrawal” veya “Para çekme” seçeneğini etkinleştirmeyin. API ile işlem yapmak, varlıklarınızı başka bir adrese çekme yetkisi vermeyi gerektirmez. İzinleri kaydettikten sonra son halini tekrar kontrol edin.
Kontrol: Para çekme kapalı. Gereksiz transfer yetkileri kapalı. Yalnızca gerekli okuma ve işlem kapsamı açık.
Para çekme izninin kapalı olması tüm riski kaldırmaz. İşlem yetkisine sahip bir anahtar kötüye kullanılırsa zararlı işlemler yapılabilir.
4. IP ve ortamı eşleştirin
Borsanız → API erişim kısıtlamaları
Yalnızca doğrulanmış IP kullanın
Borsa IP kısıtlaması sunuyorsa SBekosistem yönetiminin bu bağlantı için doğruladığı güncel sunucu çıkış IP adreslerini kullanın. Kendi telefonunuzun IP’sini, sitenin DNS adresini veya internette bulduğunuz bir adresi yazmayın.
Kontrol: Kullanacağınız adresin web sitesi adresi değil, borsaya istek gönderen sunucunun çıkış IP’si olduğu doğrulanmış olmalı.
Eksik bilgide güvenliği gevşetmeyin
Güncel çıkış IP bilgisi size verilmediyse tahmin etmeyin. Borsa IP kısıtlamasını zorunlu tutuyorsa doğru bilgi gelene kadar bu adımda bekleyin. “Her IP’ye izin ver” seçeneği bir hata giderme yöntemi değildir.
Kontrol: Bu kılavuz sabit bir IP adresi yayınlamaz. Gerekli adres netleşmeden zorunlu IP kısıtlamasını aşmaya çalışmayın.
Üçlü eşleşmeyi kontrol edin
Borsa anahtarınızın ortamını, SBekosistem’de seçeceğiniz ortamı ve piyasa türünü karşılaştırın. Bir borsanın Sandbox desteği, her piyasasının Sandbox desteklediği anlamına gelmez. Gerçek hesap anahtarını deneme ortamına veya tersini girmeyin.
Kontrol: Borsa + ortam + piyasa eşleşiyor. Bölgesel hesap ve API kısıtlamaları varsa resmi borsa açıklaması incelendi.
IP hatasını çözmek için anahtarın yetkilerini genişletmeyin veya para çekmeyi açmayın.
5. SBekosistem’de hesap ekleyin
SBekosistem → Borsalar → Hesap Bağla
Hesap Bağla formunu açın
SBekosistem’e giriş yaptıktan sonra Borsalar bölümündeki “Hesap Bağla” düğmesine basın. “Borsa” alanında bağlantıya açık borsanızı seçin. “Ortam” alanını anahtarınızı oluşturduğunuz Testnet, Sandbox veya Gerçek (Production) ortamıyla eşleştirin.
Kontrol: Pasif veya “Yakında” seçenekleriyle devam etmeyin. Destek bilgisi yüklenmezse anahtar eklemeye geçmeyin.
Hesap türünü ve etiketi belirleyin
Tek bir kişisel hesap için “Bağımsız hesap” seçin. “Etiket” alanına kolay tanıyacağınız bir ad yazın; örneğin “Spot deneme hesabım”. Üst hesap ve Alt hesap seçenekleri plan yetkisine bağlıdır. Alt hesapta aynı borsa ve aynı ortamda önceden oluşturulmuş uygun üst hesabı seçmeniz gerekir.
Kontrol: SBekosistem’de “Alt hesap” seçmek, borsanızda otomatik olarak yeni bir alt hesap açmaz; borsa tarafındaki hesabı ayrıca hazırlayın.
Oluşturun ve kartı bulun
Alanları kontrol edip “Oluştur” düğmesine basın. Başarı mesajından sonra hesabınızın kartını listede bulun. Yanlış ortam veya borsa seçtiyseniz anahtar girmeden önce durun. Ağ hatasında aynı kaydı tekrar tekrar oluşturmadan önce listeyi kontrol edin.
Kontrol: Doğru etiket, borsa ve ortam görünüyor. “Henüz anahtar eklenmedi” bu aşamada beklenen bir durumdur.
Hesap kartının oluşması, borsayla bağlantının doğrulandığı veya canlı işlemin başladığı anlamına gelmez.
6. Anahtarı hesaba ekleyin
Borsa hesabı kartı → Anahtar Ekle
API Key alanını doldurun
Doğru hesap kartındaki “Anahtar Ekle” düğmesine basın. Borsanın verdiği API Key değerini “API Key” alanına yapıştırın. Başında veya sonunda boşluk, satır sonu ya da tırnak işareti kalmadığını kontrol edin.
Kontrol: Anahtar etiketi, hesap kimliği veya borsa kullanıcı adını değil, API Key değerini girdiniz.
API Secret ve gerekiyorsa Passphrase girin
Aynı anahtar çiftinin Secret değerini “API Secret” alanına girin. Borsanız ayrıca API Passphrase kullanıyorsa oluştururken belirlediğiniz değeri “Passphrase (gerekirse)” alanına yazın. Kullanılmıyorsa boş bırakın; borsa giriş parolanızı buraya yazmayın.
Kontrol: Key, Secret ve gerekiyorsa Passphrase aynı borsa hesabı ve aynı anahtar kaydına ait.
Piyasa Türü seçip kaydedin
“Piyasa Türü” alanında anahtarınızın izin verdiği ve platformun desteklediği Spot, Vadeli (Linear), Vadeli (Inverse) veya Marjin seçimini yapın. Kilitli seçenekleri planınızın kapsamından kontrol edin. “Kaydet” düğmesine basın; başarı mesajı anahtarın doğrulamaya gönderildiğini belirtir.
Kontrol: Kaydetme mesajını bağlantı testi sonucu sanmayın. Bir sonraki adımda hesap ve anahtar durumunu inceleyin.
Anahtarlar kayıttan sonra maskeli görünür; maskeli görünmeleri anahtarın geçerli olduğunu kanıtlamaz. Gizli değeri yeniden görmek için ekran görüntüsü paylaşmayın.
7. Bağlantı durumunu okuyun
SBekosistem → Borsalar → Hesap kartı
Kaydı doğrulamadan ayırın
“Oluşturuldu” hesap kaydını, “Anahtar Bekleniyor” anahtarın henüz hazır olmadığını anlatır. “Anahtar Doğrulandı” veya “API Bağlı” gibi durumları kendi kartınızdan okuyun. Bu durumlar borsa, hesap ve süreç koşullarına göre değişebilir; her etiketin aynı sırayla görünmesi gerekmez.
Kontrol: Hesap durumuna ek olarak kartın API Anahtarları bölümündeki piyasa ve anahtar durumuna da bakın.
Hata varsa ilerlemeyin
“Anahtar Geçersiz”, “Hata” veya “Askıya Alındı” görürseniz canlı işleme geçmeyin. Borsa, ortam, piyasa, Key/Secret eşleşmesi, Passphrase ve IP izinlerini kontrol edin. Aşağıdaki sorun giderme bölümünde belirtileri ayrı ayrı inceleyin.
Kontrol: Hata metnini not edin; yardım isterken Secret, Key veya Passphrase’i metne ve ekran görüntüsüne eklemeyin.
Uygunluk ile etkinliği ayırın
“Canlıya Uygun”, hesabın uygunluk durumudur; tek başına canlı işlem başlatıldığı anlamına gelmez. “Canlıyı Etkinleştir” ayrı bir işlemdir ve plan yetkisi ile gerekli onaylara tabidir. Hesabın canlı etkinliği, belirli bir stratejinin başlatıldığı veya emrin gerçekleştiği anlamına da gelmez.
Kontrol: Bağlantı kılavuzunu tamamlamak için “Canlıyı Etkinleştir” düğmesine basmanız gerekmiyor.
Bu anlatımdaki etiketler açıklamadır; kendi hesabınızın gerçek bağlantı veya işlem sonucunu göstermez.
8. İşlemden önce deneyin
SBekosistem → Stratejiler / Planlar
Strateji kurallarını okuyun
Stratejiler ekranında erişebildiğiniz stratejinin sürümünü, piyasa ve zaman dilimi kapsamını inceleyin. Hesabınızla uyuşmayan stratejiyi seçmeyin. Bir planın stratejiyi içermesi, o planın canlı işlem yetkisi de verdiği anlamına gelmez; güncel plan kapsamını ayrıca okuyun.
Kontrol: Borsa hesabı, piyasa türü, strateji sürümü ve zaman dilimi bilinçli olarak seçildi.
Simülasyon sonuçlarını değerlendirin
Desteklenen test veya simülasyon akışında başlayın. Geçmiş veri testi (backtest), paper işlem ve borsa Testnet’i farklı test yöntemleridir. Komisyon, fonlama, gecikme ve fiyat kaymasının gerçek sonuçları değiştirebileceğini hesaba katın.
Kontrol: Deneme yaptığınız ortamın gerçek para kullanmadığından emin olun. Test başarısını gelecekteki kazanç olarak yorumlamayın.
Canlıya geçişi ayrı karar olarak verin
Canlı işlem düşünüyorsanız hesabın uygunluğunu, güncel plan yetkisini, gerekli yasal onayları, işlem boyutunu ve risk kontrollerini tek tek inceleyin. Anlamadığınız bir ayarı varsayılan olduğu için güvenli kabul etmeyin. Kılavuzun sonuna gelmek hiçbir yetkiyi açmaz.
Kontrol: Emir durumları ve açık pozisyonları nereden izleyeceğinizi, otomasyonu nereden durduracağınızı biliyorsunuz.
Kripto işlemleri sermayenizin tamamını kaybetmenize neden olabilir. Testler, otomasyon ve risk limitleri kâr veya zarardan korunma garantisi değildir.
9. Takip edin ve erişimi yönetin
SBekosistem + borsanızın hesap ekranı
Talep ile gerçekleşmeyi ayırın
Gönderilen emir, gerçekleşmiş işlem demek değildir. Emir durumlarını, kısmi gerçekleşmeleri, açık pozisyonları ve maliyetleri SBekosistem ile borsanızda karşılaştırın. Bağlantı kesilirse borsanın kendi ekranından hesap durumunu kontrol edin.
Kontrol: Uygulamada güncel veri alınamadığında “pozisyon yok” sonucuna varmıyorsunuz.
Anahtarı gerektiğinde yenileyin
Borsa anahtarı iptal edebilir, süresi dolabilir veya izinleri değişebilir. Yenilemede aynı hesap ve doğru ortam için yeni anahtar oluşturun; bağlantı durumunu kontrol edin. Birden fazla anahtar varsa hangisinin kullanıldığını doğrulamadan eski kaydı kaldırmayın.
Kontrol: Yeni anahtar eklenmesini eskisinin otomatik iptali olarak kabul etmeyin; eski yetkileri borsanızdan ayrıca inceleyin.
Şüpheli erişimde anahtarı iptal edin
Sızıntıdan şüpheleniyorsanız borsanın resmi API yönetiminden ilgili anahtarı iptal edin. İptal, otomasyonun açık pozisyonları yönetmesini de engelleyebilir; borsadaki açık emir ve pozisyonları hemen ayrıca kontrol edin. SBekosistem’de hesap silmek borsadaki anahtarın da iptal edildiği anlamına gelmez.
Kontrol: Otomasyonu durdurma, hesap silme ve API anahtarını iptal etme işlemlerinin açık pozisyonları kendiliğinden kapatmadığını biliyorsunuz.
Bu kılavuz hiçbir hesabı bağlamaz, anahtar saklamaz veya emir göndermez. Gerçek işlemleri yalnızca ilgili hesap ekranlarında yapın.