Kraken WebSocket API - Sıkça Sorulan Sorular

Kraken'ın bir WebSocket API'si var mı? Nasıl bağlanabilirim?

Kraken'ın hem bir REST API'si hem de bir WebSocket API'si bulunmaktadır. WebSocket API'miz aşağıdaki güvenli URL'lerde mevcuttur:

Herkese açık (kimlik doğrulaması yapılmamış) piyasa veri akışları: wss://ws.kraken.com/

Özel (kimlik doğrulaması yapılmış) hesap veri akışları ve işlem uç noktaları: wss://ws-auth.kraken.com/

Herkese açık piyasa veri akışlarına bağlanmak için kimlik doğrulaması gerekmez, ancak özel akışlar için geçerli bir kimlik doğrulama belirteci gereklidir.

WebSocket API aracılığıyla gönderilen ve alınan tüm mesajlar JSON formatında düz metin olarak kodlanmıştır. Her mesaj türünün ayrıntıları WebSocket API belgelerimizde sunulmaktadır.

WebSocket kütüphaneleriniz mevcut mu?

Doğrudan kullanılabilecek veya kendi uygulamanız için bir başlangıç noktası olarak kullanılabilecek çeşitli WebSocket API örnek kodlarımız mevcuttur:

WebSocket API'miz tercih ettiğiniz herhangi bir programlama dilinde uygulanabilir ve API destek ekibimiz size yardımcı olmaktan veya gerekirse ek dillerde örnek kod sağlamaktan memnuniyet duyacaktır.

Hangi akışlar/uç noktalar desteklenmektedir?

WebSocket API'miz çeşitli gerçek zamanlı piyasa veri akışları, hesap veri akışları ve işlem uç noktaları sunar. Mevcut akışların/uç noktaların tam listesi ve her bir akış/uç nokta için uygulama ayrıntıları WebSocket API belgelerinde bulunabilir.

Başarılı bir şekilde bağlandığımı nasıl anlarım? Hala bağlı olduğumu nasıl anlarım?

Bir akışa abone olunduğunda, saniyede 1 kalp atışı sıklığında {u'event': u'heartbeat'} mesajı alınacaktır.

Bunun yerine başka mesajlar (piyasa verileri, hesap verileri vb.) alınırsa kalp atışları alınmayacaktır. Piyasa veya hesap verilerinin ne zaman ve neden alındığı, abone olduğunuz akışa bağlıdır.

Düşük işlem hacmine sahip bir döviz çiftinin akışına abone oluyorsanız, uzun süreler boyunca yalnızca kalp atışları alabilirsiniz.

Bir akıştan aboneliğinizi iptal ederseniz, artık kalp atışları veya işlem verileri almazsınız ve 1 dakika boyunca hiçbir akışa abone olmadıktan sonra WebSockets akışından bağlantınız kesilir.

WebSocket ne zaman ve neden güncellenmiş veri gönderir?

Piyasa verilerinin veya hesap verilerinin ne zaman ve neden alındığı, abone olduğunuz akışa bağlıdır. Örneğin:

Ticker: Bir döviz çifti için bir işlem veya işlem grubu olduğunda, o çift için bir ticker mesajı yayınlanır. Bu mesajı yalnızca bu çiftin ticker akışına aboneyseniz alırsınız.

İşlem: Benzer şekilde, bir döviz çifti için bir işlem veya işlem grubu olduğunda, o çift için bir işlem mesajı da yayınlanır. Bu mesajı yalnızca bu çiftin işlem akışına aboneyseniz alırsınız.

OHLC: Bir döviz çifti için bir işlem veya işlem grubu yürütüldüğünde, her aralık için güncellenmiş bir OHLC aralığı yayınlanır. Yalnızca abone olduğunuz aralıklar için güncellemeler alırsınız. Bir aralık sınırını geçtikten sonra, bir sonraki işlem gerçekleşene kadar hiçbir mesaj gönderilmez.

Emir Defteri: Emir defteri akışına ilk abone olunduğunda, seçilen derinliğe sahip emir defterinin ilk anlık görüntüsü yayınlanır.

Emir defterine yeni emirler eklendiğinde veya abone olduğunuz emir defteri derinliğini etkileyen işlemler yürütüldüğünde, etkilenen fiyat seviyeleri ve hacimler için emir defteri güncellemelerini içeren bir mesaj yayınlanır. Bu güncellemeler yalnızca alış, yalnızca satış veya hem alış hem de satış içerebilir. Ayrıntılar için aşağıdaki Emir Defteri Nasıl Oluşturulur bölümüne bakın.

Spread: Yeni bir en yüksek alış veya en düşük satış emri verildiğinde veya en iyi alış veya en iyi satış fiyatını değiştiren bir işlem yürütüldüğünde, güncellenmiş alış ve satış fiyatlarını içeren bir spread mesajı yayınlanır.

WebSocket akışları geçmiş veriler mi yoksa yalnızca güncel veriler mi sağlar?

WebSocket piyasa veri akışları yalnızca güncel veriler sağlar, ancak güncel veriler için WebSocket API'ye ve geçmiş veriler için REST API'ye aynı anda bağlanmak mümkündür.

reqid parametresinin kullanımı.

Abonelik istekleri, daha sonra istenen WebSocket abonelik isteğini o aboneliğin kanal kimliğiyle eşleştirmek için kullanılabilecek, istemci tarafından sağlanan bir reqid parametresi içerebilir.

Aynı anda birden fazla WebSocket aboneliği yaparsanız, hepsine aynı reqid değeri atanacağını unutmayın. Farklı bir reqid değeri atamak için her akışa ayrı ayrı abone olunmalıdır.

Daha fazla ayrıntı istiyorum, bunları nerede bulabilirim?

Tam WebSocket API spesifikasyonu WebSocket API belgelerinde mevcuttur.

REST ve WebSocket API'lerindeki döviz çifti sembolleri arasındaki farklar.

WebSocket API'si yalnızca XBT/USD gibi ISO 4217-A3 formatındaki döviz çifti sembollerini kabul eder.

REST API AssetPairs uç noktası, sembolleri REST API sürümleri (XBTUSD veya XXBTZUSD gibi) ile WebSocket API sürümü (XBT/USD gibi) arasında çevirmek için kullanılabilir.

https://api.kraken.com/0/public/AssetPairs

wsname alanı WebSocket API sembolünü sağlar.

Emir defteri nasıl oluşturulur?

WebSocket API emir defteri akışı, tüm WebSocket akışları arasında en karmaşık olanıdır, ancak emir defteri akış mesajları doğru yorumlandığı sürece, yalnızca birkaç satır kodla emir defterinin yerel bir kopyasını tutmak mümkündür.

WebSocket API destek sayfalarımız, emir defteri akış mesajlarını yorumlamak için ayrıntılı talimatlar, bir örnek emir defteri dökümü ve geçerli bir yerel emir defteri kopyasını sürdürmek için örnek kod (Python'da) sunmaktadır.

WebSocket API bağlantı limitleri nelerdir?

WebSocket API'si, kötüye kullanıma (örneğin DDoS saldırıları gibi) karşı koruma sağlamak için eşzamanlı bağlantıların maksimum sayısını sınırlar. WebSocket istemciniz aynı anda çok fazla bağlantı kurarsa, aşağıdaki hata mesajı alınacaktır:

{“error”: {“message”: “WebSocket bağlantıları için maksimum kapasiteye ulaştınız. Herhangi bir sorunuz için lütfen Kraken destek ekibiyle iletişime geçin.“, “hint”: “Kodunuz çok sık veya gerekmediği zamanlarda yeniden bağlanıyor olabilir.“, “name”: “WebSocket bağlantı oranı hatası”}}

WebSocket API'si, tek bir WebSocket bağlantısı aracılığıyla birden fazla akış aboneliğine izin verir (örneğin, XBT/USD döviz çifti için mevcut tüm piyasa verilerine tek bir bağlantı aracılığıyla abone olmak gibi), bu nedenle tüm döviz çiftleri için mevcut tüm piyasa verilerini WebSocket bağlantı limitlerine ulaşmadan yayınlamak mümkündür.

WebSocket API hız limitleri nelerdir?

Aynı işlem hız limitleri tüm emir giriş arayüzlerinde (web sitesi, Kraken Terminal, REST ve WebSocket API'leri) geçerlidir ve hız limitleri destek sayfamızda ayrıntılı olarak açıklanmıştır.

Tek bir WebSocket API bağlantısının mesaj hız limiti, sistemdeki yüke bağlı olarak değişecektir. Mesaj hız limiti aşıldığında WebSocket API istemcileri {"Error": "Exceeded msg rate"} hata mesajını alacaktır.

WebSocket API aracılığıyla işlem yapma (emir verme/iptal etme).

WebSocket API aracılığıyla işlem yapma, sırasıyla yeni emirler vermek ve mevcut (açık) emirleri iptal etmek için kullanılan addOrder ve cancelOrder uç noktaları aracılığıyla mümkündür.

WebSocket işlem uç noktaları, özel hesap yönetimi akışları (openOrders ve ownTrades) ile aynı özel WebSocket bağlantısı (wss://ws-auth.kraken.com/) aracılığıyla mevcuttur.

İşlem uç noktalarıyla ilgili tüm ayrıntılar WebSocket API belgelerinde mevcuttur ve WebSocket API destek sayfalarımız, işlem uç noktalarını kendi kodunuzda kullanmak için daha fazla bilgi ve örnekler sunmaktadır.

WebSocket API'ye bağlanırken neden 403 hatası alıyorum?

WebSocket API bağlantıları Cloudflare aracılığıyla sağlanır, bu nedenle Cloudflare tarafından uygulanan herhangi bir güvenlik ayarı hem herkese açık (wss://ws.kraken.com) hem de özel (wss://ws-auth.kraken.com) URL'lere yapılan bağlantıları etkileyebilir.

Cloudflare, tüm TLS bağlantıları için Sunucu Adı Göstergesi (SNI) kullanılmasını gerektirir, aksi takdirde WebSocket bağlantısı başarısız olur ve bunun yerine bir HTTP 403 Yasak hatası döndürülür. Cloudflare'ın destek sayfaları, TLS SNI gereksinimleri hakkında daha fazla ayrıntı sağlar.

Resmi Python WebSocket API kütüphanemiz TLS SNI'yi destekleyecek şekilde güncellenmiştir, ancak bazı üçüncü taraf WebSocket API kütüphaneleri hala etkilenebilir. WebSocket API kodunuzu TLS SNI'yi destekleyecek şekilde güncellemek için herhangi bir yardıma ihtiyacınız olursa lütfen API destek ekibimizle iletişime geçin.

WebSocket API yardımı.

WebSocket API istemcinizi uygularken herhangi bir yardıma ihtiyacınız olursa lütfen API destek ekibimizle iletişime geçin.