BtcTurk | Kripto'da kullanıcılarımız, API ile yapmak istedikleri işlemleri programlayabilir ve belirledikleri parametrelere göre otomatik hale getirebilirler.
Application Programming Interface (API) Nedir ve Ne İşe Yarar?
Türkçe’ye çevrildiğinde Uygulama Programlama Ara yüzü anlamına gelir.
API ile kullanıcılar BtcTurk | Kripto’da yapmak istedikleri işlemleri bir yazılım ile programlayabilir ve belirledikleri parametrelere göre otomatik hale getirebilirler.
Daha farklı bir ifade ile API ile bir kullanıcı yapacağı işlemler için matematiksel algoritma yazar. Bu algoritma o kullanıcı yerine otomatik olarak emir açar/kapatır.
API’ler otomasyon imkanı verir. Süreçleri hızlandırmayı, otomatikleştirmeyi sağlar.
API hakkında daha fazla bilgi almak içinse https://www.btcturk.com/bilgi-platformu/api-nedir-neden-kullanilir/ bağlantısını ziyaret edebilirsiniz.
API ile Hangi İşlemler Yapılabilir?
Bireysel bir kullanıcının BtcTurk | Kripto’da yapabildiği tüm işlemler (emir verme, alım/satım gibi) API ve algoritmalar vasıtasıyla otomatize edilerek yapılabilir.
Bot Nedir? API ile Farkı Nedir?
BOT ve API aynı anlamda kullanılmaktadır.
API ile uygulama/algoritma yazılır, işlem kısaca Bot ismi verilen robot tarafından otomatik yapılır.
API ya da Botları Kimler Kullanır? Kimler İşlem Yapar?
API genellikle programlama konusunda bilgi sahibi kişiler tarafından kullanılır. Ama BtcTurk tüm kullanıcılarına API hizmeti sağlamaktadır. Dileyen herkes bu hizmetten yararlanabilir.
API Güvenli Midir?
Güvenlidir ama sizin aldığınız önlemler kritiktir. API anahtarı oluştururken, erişim yetkilerinizi tamamen kendiniz belirleyebilir ve API erişimini sadece belirlediğiniz IP Adresiyle sınırlandırabilirsiniz.
API anahtarınızı oluşturduktan sonra dilerseniz oluşturduğunuz anahtarın sağında yer alan butonla API anahtarını geçici olarak kullanıma kapatabilir veya tamamen silebilirsiniz.
API Servisinden Nasıl Faydalanabilirim?
Öncelikle API anahtarı oluşturmalısınız. API anahtarınızı oluşturmak için BtcTurk | Kripto web sitesinde Hesap>API Erişimi adımından Toplam Varlık, AL-SAT, Hesap veya Websocket seçimleri yapılarak “API KEY OLUŞTUR” butonuna tıklanması yeterlidir.
API Anahtarı Üretme ve Kullanım Şartları
BtcTurk | Kripto API anahtarı üretme ve kullanım şartları 20 Ekim 2021 Çarşamba 15.00 itibarıyla değişmiştir.
- API anahtarı oluşturmak için IP adresi girilmesi zorunlu hale getirilecektir.
- Bir kullanıcı en fazla 20 adet API anahtarı oluşturabilecektir.
- Bu değişiklikten sonra API anahtarları, değişiklikten etkilenmeyecek olup yeni API anahtarı oluşturmak için API anahtarını bir IP adresine bağlamanız gerekecektir.
- BtcTurk | Kripto hesabına bağlı API anahtarı adedi 20'yi aşan kullanıcılarımız, fazla sayıdaki API anahtarlarını silerek yeni API anahtarı oluşturabilirler.
20 Ekim 2021 Çarşamba 15.00 itibarıyla BtcTurk | Kripto API üzerinden eski API anahtarları ile yapılacak işlemlerde herhangi bir kesinti yaşanmayacağını, söz konusu değişikliğini yeni üretilecek API anahtarları için geçerli olduğunu kullanıcılarımızın bilgisine sunarız. Eski API anahtarları, süreçten etkilenmeyecektir.
Bahsettiğiniz Algoritmayı Nasıl Yazacağım? Parametreleri Nereden Giriyorum?
BtcTurk | Kripto Graph API ile 1 dakika-1 yıl arasındaki belirli zaman dilimleri için piyasa verilerini alabilirsiniz.
Bu bilgileri analiz etmek ve algoritma oluşturmak ile ilgili talepleriniz için kullandığınız yazılım dilinin topluluklarından, yazılım kütüphanelerinden destek alabilirsiniz.
API ve Botlarla Yapılan İşlemler Etik Midir?
Kriptopara alım/satım platformlarında alıcısı ve/veya satıcısı olan (yani karşılığı olan) her şey etiktir.
Örneğin; 1.000 TL'niz var ve belli miktarda BTC almak istiyorsunuz. Botunuz sürekli en tepeye limit alım açıyor. Bu işlemi manuel de yapabilirsiniz; ancak 1.000 TL parayı platforma zaten yatırmışsınız ve bakiyenizde 1.000 TL bulunuyor. Yani borsanın kasasında emaneten sizin 1.000 TL bakiyeniz var. Bu botetiktir.
Eğer platformda karşılığı olmayan bir işlem varsa bu durumda etik olmaz ama BtcTurk’te kesinlikle böyle bir şey söz konusu değildir.
BOT Kullanarak Fiyatlara Müdahale Mi Ediyorsunuz?
API BOT işlemleri sitemize kayıtlı gerçek kullanıcılar tarafından yapılmaktadır. Kullanıcılar emirlerini Web ara yüzünden, mobil uygulamamızdan veya geliştirdikleri bir yazılım yardımıyla verebilirler.
Genellikle bu işlemleri, Web yazılımcıları ve program geliştiricileri yapmaktadır. BtcTurk olarak bizim bu süreçte hiçbir müdahalemiz bulunmuyor.
Sistemde API (bot) var, emir veremiyorum. / Emrim bir türlü gerçekleşmiyor; ancak farklı emirler gerçekleşiyor.
BtcTurk'te kullanıcılar web sitesi ve mobil uygulamadaki al-sat menüsü üzerinden ya da API aracılığıyla emir verebilir. API bot işlemleri de gerçek kullanıcılar tarafından yapılmaktadır. Her durumda emrinizin gerçekleşmesi için karşı bir emirle eşleşmesi gerekir. Örneğin, alıcı pozisyonundaysanız karşı tarafta mutlaka sizin almak istediğiniz fiyat ve miktarda satış emri veren bir kullanıcının olması gerekir. Hatırlatmak isterim ki, bu noktada sizin gibi aynı fiyattan emir veren farklı kullanıcılar da olabilir. Bu durumda fiyat kadar, emrin verildiği zaman da önemlidir. Çünkü emirler, emir defterine sırayla yazılır.
Botlar İşlem Yapmamızı Engelliyor Mağdur Oluyoruz Buna Bir Çözümünüz Yok Mu?
Bu işlemler sitemize kayıtlı gerçek kullanıcılar tarafından yapılmaktadır. Kullanıcılar emirlerini Web arayüzünden, mobil uygulamamızdan veya geliştirdikleri bir yazılım yardımıyla verebilirler.
Genellikle bu işlemleri, web yazılımcıları ve program geliştiricileri yapmaktadır. BtcTurk olarak bizim bu süreçte hiçbir müdahalemiz bulunmamaktadır.
API İle İlgili Sorun Yaşanması
API ile ilgili yazılım ekibimizden destek alıyoruz. Kullanıcıya yardımcı olmak amacı ile talebine ait detaylar eksiksiz talep edilmelidir.
- Ekran görüntüsü (Alınan hataya dair hata kodu ve hata mesajı)
- Aldığı hatanın APİ kullanımına engel olan durumlarının neler olduğu.
API Destek Talebi
API dokümanlarına ve kod örneklerine https://docs.btcturk.com/ adresinden ulaşabilirsiniz.
Kullanıcıdan yapmak istediği işlem detayları, varsa alınan hata bilgisi ve hatanın ekran görüntüsü talep edilir. Not bölümüne tüm detaylar mutlaka yazılmalıdır.
Kayıt, Yazılım ekibine iletilmelidir. API'de hata aldığını ileten kullanıcılar, Github'a yönlendirilmemelidir.
Alınan hata kodlarının detaylarına link üzerinden ulaşabilirsiniz.
https://docs.btcturk.com/docs/general-information/
API WebSocket Authentication
WebSocket Authentication ile ilgili KDM kullanıcılardan gelebilecek sorular ve yanıtları aşağıdaki gibidir.
NOT: Websocket Linki: https://docs.btcturk.com/websocket-feed/protocol
Serverlarınız tam olarak nerede?
Serverlarımız Amsterdam'dadır.
En hızlı erişimi nasıl sağlayabiliriz?
Cloudflare Amsterdam sunucularımıza yakın bir bağlantı sağlanması önerilmektedir.
İnternette yalnızca Rest API dokümanı gözüküyor FIX API de var mı varsa bu dokümana nereden ulaşabiliriz?
Github üzerinden yayına aldığımız API'yi kullanabilir. Harici bir API hizmetimiz bulunmuyor.
Azure Europe West Amsterdam lokasyonundaki serverlarınıza Co-Location üzerinden hızlı bağlantı sağlamak için seçeneklerimiz var?
Şirket politikamız gereği Co-Location seçeneği sunmuyoruz. Sunucularımızda yalnızca kendi uygulamalarımız yer alıyor.
Belirtilen Azure Region üzerinde Cloud Server kiralamaktan farklı yapabileceğimiz neler var?
Farklı bir seçenek bulunmuyor.
Public interneti By-Pass eden bağlantı noktalarınız var mı?
Public interneti By-Pass eden bağlantı noktası bulunmuyor.
Co-Location üzerinden en hızlı bağlantıyı ne şekilde sağlayabiliriz?
Co-Location seçeneği bulunmuyor.
Account data için (pozisyon vs. account related bilgiler) bir websocket stream hizmetiniz var mı?
Bunun için WebSocket Private Channel mesajları dinlenebilir. HMAC Auth yapılması durumunda private channellardan data alınabilir.
https://docs.btcturk.com/websocket-feed/models#private-socket-messages
API ile işlem yapıldığında balance updateleri websocket üzerinden almak için ne yapılmalıdır?
Balance updatelerini adınıza gerçekleşen tradeler üzerinden takip edebilirsiniz(441UserOrderMatch). Emriniz eşleştiğinde gelen mesajları takip etmeniz gerekmektedir.
Whitelist etmek nedir? API ile bağlantısı nedir?
Whitelist etmek daha çok kriptopara çekme işlemleri için kullanılan bir tabirdir. Kurumsal müşteriler için çekme işlemlerini aktif etmek adına ilgili API Key’i Database’e kaydetmemiz gerekir. Bu süreç yalnızca kurumsal müşteriler için uygulanır.
WebSocket tarafında 451 modelini kullanarak kendim emir açabilir miyim?
WebSocket ile emir girme işlemi yapılamaz. Mevcut WebSocket hizmeti sadece mesaj dinlemek için kullanılabilir. Bu sebeple 451 (Order Insert) Modeli yalnızca okuma yapılabilecek bir kanaldır.
1-2 saniyede time-out aldığını ileten kullanıcıya nasıl yanıt verilebilir?
Kullanıcı yazılım kodunda hata almış olabilir, bağlantı kaynaklı hata alabilir, uygulamalarını diploy ettiği serverla alakalı bir durum olabilir.
Kayıt, Yazılım ekibine iletilir.