All
Filtreleme ölçütü:
Hesabıma nasıl nakit yatırabilirim?
Hesap doğrulaması ile ilgili yardıma ihtiyacım var
Hesabıma neden erişemiyorum?
Kripto para çekimlerinde herhangi bir ücret var mı?
Hesabıma giriş yapmak için yardıma ihtiyacım var
WebSocket API v1 - emir verme ve iptal etme
Son güncelleme: 1 Nisan 2025
WebSocket API v1'imiz, addOrder ve cancelOrder uç noktaları aracılığıyla alım satımı destekler. addOrder uç noktası yeni emirler vermek için, cancelOrder uç noktası ise mevcut (açık) emirleri iptal etmek için kullanılır.
Hem addOrder hem de cancelOrder özel uç noktalardır; bu da onlara yalnızca kimliği doğrulanmış bir WebSocket bağlantısı aracılığıyla erişilebileceği anlamına gelir.
Başlangıçta kimliği doğrulanmış WebSocket URL'si wss://ws-auth.kraken.com/ adresine bir bağlantı kurulmalı ve bu bağlantı, emirler verilirken ve iptal edilirken süresiz olarak açık tutulabilir. Tek bir WebSocket bağlantısı, birden fazla isteği desteklemek üzere tasarlanmıştır, bu nedenle alım satım uç noktalarına yapılan her çağrı için bağlanmak/bağlantıyı kesmek gerekli (veya önerilen) değildir.
WebSocket kimlik doğrulaması
Bir WebSocket kimlik doğrulama token'ı, REST API GetWebSocketsToken uç noktası aracılığıyla alınabilir.
Bir token alındıktan sonra, özel WebSocket URL'si wss://ws-auth.kraken.com/ adresine bir bağlantı kurulabilir ve addOrder ile cancelOrder uç noktaları süresiz olarak kullanılabilir (token, emir vermek ve iptal etmek için kullanıldığı sürece sona ermez).
Token'ı almak için kullanılan API anahtarının hem Modify Orders hem de Cancel/Close Orders izinlerine sahip olması gerektiğini unutmayın, aksi takdirde WebSocket API'den bir izin reddedildi hatası alınacaktır.
Emir verme
Kimliği doğrulanmış bir WebSocket bağlantısı kurulduktan sonra, aşağıdaki gibi bir mesaj gönderilerek bir emir verilebilir:
- •
{"event":"addOrder", "token":"nT9n23/7oLdq+bNHNMNJ4VvF1hiHhjTnPOaCMiB1GJ0", "pair":"XBT/USD", "type":"buy", "ordertype":"limit", "price":"9857", "volume":"0.002", "leverage":"5", "userref":"8874657"}
Daha sonra isteğin durumunu (emrin kabul edilip edilmediğini veya reddedilip reddedilmediğini) belirten bir yanıt alınacaktır. Başarıyla kabul edilen ve verilen bir emir için yanıt, durumun ok olduğunu belirtecek ve aşağıdaki gibi olacaktır:
- •
{"descr":"buy 0.00200000 XBTUSD @ limit 9857.0 with 5:1 leverage","event":"addOrderStatus","status":"ok","txid":"OPOUJF-BWKCL-FG5DQL"}
Reddedilen ve verilmeyen bir emir için yanıt, durumun error olduğunu ve reddedilme nedenini (geçersiz argümanlar, yetersiz bakiye vb.) belirten bir hata mesajı içerecektir; örneğin, minimum emir boyutunu karşılamayan bir emir için aşağıdaki ret:
- •
{"errorMessage":"EOrder:Order minimum not met","event":"addOrderStatus","status":"error"}
Emir iptali
Kimliği doğrulanmış bir WebSocket bağlantısı kurulduktan (veya tercihen mevcut bir bağlantı yeniden kullanıldıktan) sonra, aşağıdaki gibi bir mesaj gönderilerek bir emir iptal edilebilir:
- •
{"event":"cancelOrder", "token":"s74Ajl83it0dNNKcF072NJ5wDmLTGIceaCbV96eWbFg", "txid":["OJZ3DI-IU6QC-ME7TVE"]}
Daha sonra isteğin durumunu (iptalin kabul edilip edilmediğini veya reddedilip reddedilmediğini) belirten bir yanıt alınacaktır. Başarıyla iptal edilen bir emir için yanıt, durumun ok olduğunu belirtecek ve aşağıdaki gibi olacaktır:
- •
{"event":"cancelOrderStatus","status":"ok"}
Reddedilen bir iptal isteği için yanıt, durumun error olduğunu ve reddedilme nedenini (geçersiz emir kimliği vb.) belirten bir hata mesajı içerecektir; örneğin, zaten iptal edilmiş bir emri iptal etme isteği için aşağıdaki ret:
- •
{"errorMessage":"EOrder:Unknown order","event":"cancelOrderStatus","status":"error"}
REST API CancelOrder uç noktasından farklı olarak, tek bir WebSocket iptal mesajında birden fazla emir kimliği belirtmenin mümkün olduğunu unutmayın. İptal edilecek emir kimlikleri, txid dizisi içinde ayrı girişler olarak aşağıdaki gibi dahil edilmelidir:
- •
{"event":"cancelOrder", "token":"c4JjTNHSurKmWDsnrGaCxIuCOa4FurCZK2ppktvT2Yo", "txid":["OLVCRZ-DNKJI-VRTZKY","O67X6E-PBGSR-GU23R5","OECCDC-T2R4V-52CR7T"]}