API hata mesajları

İzin reddedildi hataları, API istemcisinin API anahtarının izni olmayan bir görevi denemesi durumunda döndürülür. Örneğin, bir API istemcisi, işlem erişimine izin verecek şekilde yapılandırılmış ancak hesap yönetimi erişimine izin vermeyen bir API anahtarı kullanarak hesap bakiyesini almaya çalışırsa, izin reddedildi hatası döndürülür. Lütfen API anahtarlarınızı ve ayarlarını (izinleri gibi) hesap yönetiminin Ayarlar -> API sekmesi aracılığıyla inceleyin. Üçüncü taraf uygulamalarınız tarafından kullanılan API anahtarlarının, uygulamalarınızın gerektirdiği tüm ayarlara ve izinlere sahip olduğundan emin olmanız gerekir.

Bu hata, çağrı için kullanılan API anahtarının süresi dolduğunda veya devre dışı bırakıldığında döndürülür. Lütfen hesap yönetiminin Ayarlar -> API sekmesindeki API anahtarınızı inceleyin veya yeni bir tane oluşturup uygulamanızı güncelleyin.

Varlık çiftlerimizin tam listesini AssetPairs genel çağrısından alabilir ve çift adını Json başlıklarının girişi olarak veya "altname" parametresiyle arayabilirsiniz: https://api.kraken.com/0/public/AssetPairs

Bu hata, bir yöntem gerekli parametreler olmadan çağrıldığında döndürülür. Örneğin, QueryOrders yöntemini geçerli bir işlem kimliği (txid) parametresi belirtmeden çağırmak, geçersiz argümanlar hatasının döndürülmesine neden olur. Gereksiz parametrelerle bir yöntem çağırmak yine de geçersiz argümanlar hatasını döndürmez, çünkü gereksiz parametreler basitçe göz ardı edilir.

Geçersiz imza hataları, API anahtarınızın veya API gizli anahtarınızın programınızda yanlış yazılması veya kimlik doğrulamasında kullanılan POST verileri ile API'ye gönderilen POST verilerinin eşleşmemesi durumunda ortaya çıkar.Ek referans olarak, API imza algoritmasını uygulamak için aşağıdaki Python kodu örneği verilmiştir. Uygun API genel anahtarı hesap yönetiminden kopyalanıp yapıştırılmalı ve API yöntemi ile POST verileri uygun şekilde güncellenmelidir. Çıktı değeri, API-Sign HTTP başlığı için doğrudan değer olarak kullanılabilir. #!/usr/bin/env python

# Gerekli Python kütüphanelerini içe aktar
import time
import base64
import hashlib
import hmac

# Hesap yönetiminde görüntülenen base64 formatındaki API özel anahtarını çöz
api_secret = base64.b64decode("nmlrD83t1J+yVWKUBx9vD6j26C5zhC11tFfXpN+Ww+8oOVuGgse5AeADcvl95jYaD+UAi3D5CrVfFr8GfQ7zhA==")

# Değişkenler (API yöntemi, nonce ve POST verileri)
api_path = "/0/private/TradeBalance"
api_nonce = str(int(time.time()*1000))
api_post = "nonce=" + api_nonce + "&asset=xxbt"

# Kriptografik hash algoritmaları
api_sha256 = hashlib.sha256(api_nonce + api_post).digest()
api_hmac = hmac.new(api_secret, api_path + api_sha256, hashlib.sha512)

# API-Sign değerinde kullanılan base64 formatına imzayı kodla
api_signature = base64.b64encode(api_hmac.digest())

# API-Sign HTTP başlığında kullanılacak API kimlik doğrulama imzası
print(api_signature)SHA256, nonce değerinin kendisi ve API yöntemi için POST verileri kullanılarak hesaplanır ve POST VERİLERİ, nonce (tekrar) ve API yöntemi parametreleri için ad/değer çiftlerinden oluşur. TradeBalance yöntemi için SHA256'ya iletilmesi gereken verilere bir örnek aşağıdaki gibidir:SHA256 = "1541933977000nonce=1541933977000&asset=xxbt" değerinin SHA256'sıSHA256'ya iletilen dize değeri ek boş (\0) değerler içermemeli ve dize değeri base64 veya onaltılık olarak kodlanmamalıdır (yani, dize değeri düz metin dizesi olmalıdır).URI yolu, "https://api.kraken.com" öneki hariç API yönteminin tüm URL'sidir, bu nedenle TradeBalance yönteminin URI yolu (örneğin) ek boş değerler olmadan "/0/private/TradeBalance" dize değeri olacaktır.HMAC SHA512, URI yolu ve daha önce hesaplanan SHA256 özeti kullanılarak, base64 çözülmüş API özel anahtarı HMAC anahtarı olarak hesaplanır. HMAC'ye iletilmesi gereken verilere bir örnek aşağıdaki gibidir:base64 çözülmüş özel anahtar kullanılarak HMAC SHA512 = "/0/private/TradeBalanceSHA256" değerinin HMAC'siAPI-Key ve API-Sign HTTP başlıkları, gerekli olan tek iki özel HTTP başlığıdır. API-Key başlığı, hesap yönetimindeki API genel anahtarının tam bir kopyasıdır. API-Sign başlığı, base64 kullanılarak kodlanmış HMAC SHA512 özetidir.

Bu hata hakkında daha fazla bilgiyi buradan bulabilirsiniz:https://support.kraken.com/hc/en-us/articles/360001148063Nonce ve Nonce Penceresi hakkında daha fazla bilgiyi buradan bulabilirsiniz:https://support.kraken.com/hc/en-us/articles/360000906023https://support.kraken.com/hc/en-us/articles/360001148023

Geçersiz oturum hataları, WebSocket API aracılığıyla, süresi dolmuş (örneğin) geçerli olmayan bir kimlik doğrulama belirteci kullanılarak kimliği doğrulanmış (özel) bir akışa abone olma girişimi yapıldığında döndürülür.

Çözüm, REST API GetWebSocketsToken uç noktası aracılığıyla yeni bir kimlik doğrulama belirteci istemek ve bu yeni belirteci sonraki tüm kimliği doğrulanmış (özel) abonelik istekleri için kullanmaktır.

Hatalı istek hatası, temel HTTP isteği (sonraki API isteği değil) hakkında yanlış bir şey olduğunu gösterir; örneğin REST/WebSocket arasındaki URL'lerin uyuşmaması veya HTTP POST verilerinin doğru şekilde dahil edilmemesi gibi:

% curl --data "" https://api.kraken.com/0/private/GetWebSocketsToken

{"error":["EAPI:Bad request"]}

Bu hata, çağrılan uç noktanın geçerli bir uç nokta olmaması durumunda döndürülür.

API oran sınırını aştınız.

Emir ekleme ve iptal etme işlemleri standart API sayaç limitlerimize dahil olmasa da, bu işlemlerin kendi emir ekleme ve iptal etme sayaçları vardır. Bu sayaç, emirler emir defterinde ne kadar uzun süre kalırsa, müşterilerin o kadar fazla emir ekleyebilmesi veya iptal edebilmesi şeklinde çalışır.

Geçici kilitlenme hata mesajları, kısa bir süre içinde çok fazla başarısız API çağrısı veya çok fazla geçersiz nonce hatası ya da geçersiz imza olması durumunda ortaya çıkabilir. Bu çağrılar bir hata döndürse bile, bu hata API limitlerinize dahil edilir ve geçici bir kilitlenmeye neden olabilir.

Geçici kilitlenmeler yaklaşık 15 dakika sürer. Geçici kilitlenme hatasını aldıktan sonra, yeni API istekleri göndermeden önce lütfen 15 dakika bekleyin. Birden fazla geçersiz nonce hatası tetikliyorsanız, bu hataların oluşma sıklığını azaltmaya yardımcı olabileceğinden nonce penceresini artırın. Lütfen özel API çağrılarınızın sıklığını da azaltmaya çalışın.

Marjinli yeni spot pozisyon açma, işlem motoru bakımı nedeniyle geçici olarak askıya alınmıştır. Bu özellik yakında geri dönecek ve güncellemeleri status.kraken.com adresinden takip edebilirsiniz.

Diğer bir neden ise, marjinli spot pozisyonların belirli ülkelerde ikamet eden müşteriler için şu anda mevcut olmaması olabilir.

Kraken'da aynı çift için uzun ve kısa pozisyon açamazsınız.

Aynı para birimi için uzun ve kısa pozisyon açmak isterseniz, lütfen taban veya karşıt para birimi olarak aynı para birimine sahip farklı işlem çiftleri seçin. Örn: kısa XBT/USD, uzun XBT/EUR.

Bu hata, mevcut doğrulama seviyeniz için marj izin limitlerini aştığınızda meydana gelir. Her para birimi için marj izin limitleri, mevcut doğrulama seviyenize göre değişir.

Marj uzatmaları için sınırlı fonlarımız bulunmaktadır. "Yetersiz marj" mesajı, ilgili marj havuzunda geçici olarak fonumuz kalmadığını gösterir. Bu durum her an değişebilir. Siparişinizi saniyeler veya dakikalar sonra başarıyla verebilirsiniz, ancak yüksek hacimli siparişler ve yüksek hacimli zamanlarda verilen siparişler daha uzun sürebilir. Yaşanabilecek herhangi bir rahatsızlıktan dolayı özür dileriz.

Bu hata, hesapta yeni bir pozisyon açmak için yetersiz Serbest Marj olduğunda veya mevcut bir pozisyon açma girişiminin hesabın Serbest Marjını %100'ün altına düşürmesi durumunda meydana gelir.

Bu siparişi vermek için yeterli fonunuz bulunmamaktadır. Lütfen fonlarınızı tutan açık pozisyonlarınızı ve siparişlerinizi gözden geçirin.

Bu varlık için minimum sipariş hacmini karşılamadınız.

Hesabınız için mevcut maksimum açık sipariş miktarını aştınız.

Bu limitler doğrulama seviyenize bağlıdır. Lütfen açık siparişlerinizden bazılarını kapatın veya hesabınızı daha yüksek bir seviyeye doğrulayın.

Hesabınız için mevcut maksimum açık pozisyon miktarını aştınız.

Bu limitler doğrulama seviyenize bağlıdır. Lütfen açık pozisyonlarınızın bir kısmını veya tamamını kapatın veya mümkünse hesabınızı daha yüksek bir seviyeye doğrulayın.

Mevcut (açık) bir siparişi düzenleme girişimi yapıldı ancak değişiklikler başarıyla tamamlanamadı. Olası nedenler arasında yeni sipariş için yetersiz fon, bazı kısmi doldurma senaryoları ve bazı kaldıraçlı siparişler bulunmaktadır.

Yeni hacim, zaten gerçekleştirilen/doldurulan hacimden daha azdır.

Emir boyutu, işlem çiftinin marj pozisyonu boyut limitini aştı.

Görüntüleme hacmi minimum emir hacmini karşılamadı.

Görüntüleme hacmi, emrin hacminden az olmalıdır.

Buzdağı emirleri, limit emri dışındaki diğer emir türleriyle uyumlu değildir.

Her kripto para biriminin maksimum 5 yeni (kullanılmamış) yatırma adresi vardır; bundan sonra 6. yeni bir adres oluşturma girişimi bir hata döndürecektir.

Bu hata, fonlama uç noktaları geçersiz veya eksik bir "method" parametresiyle çağrıldığında döndürülür. 

"key" giriş parametresi, hesap yönetiminde (Fonlama -> Çekme yoluyla) ayarlanan adres açıklamasına karşılık gelmiyor.

Para birimine göre minimum çekme miktarları değişir ve minimumun altında yapılan herhangi bir çekme girişimi bu hatayla sonuçlanır.

Bu, bir fonlama talebinin tamamlanamadığını gösteren genel bir hatadır (örneğin, belirli konumlardan gelen müşterilerin zincir üstü staking talepleri yapmaya çalışması bu hataya neden olabilir).

İstenen çekim tamamlanamadı, çünkü hedef adreste gerekli lehtar/alıcı bilgileri eksik (bu durum şu anda yalnızca Kanada hesaplarından yapılan belirli çekimler için geçerlidir).

Yaşadığınız hizmet hataları yalnızca geçici olmalıdır. Başarısız olmaları durumunda isteklerinizi yeniden göndermek isteyebilirsiniz. Sorunları izliyor ve sayfamızı güncelliyor olacağız:

https://status.kraken.com/

API performans düşüşü sorunlarıyla karşılaştığımızda, bunlar Kraken için hizmet kullanılamazlığı mesajları ve site kesintileri şeklinde sorunlara dönüşebilir.

Bu sorun, hesabınızın güvenliğiyle ilgilidir ve hesabınızın güvenliği tehlikeye girmiş olabilir. Lütfen şifrenizi ve İki Faktörlü Kimlik Doğrulamanızı değiştirin ve Destek Merkezimizle iletişime geçin.

Bu hata, bir işaret veya giriş parametresi geçici veya kalıcı olarak devre dışı bırakıldığında oluşur. Hata, iletilen girişlerden birinden kaynaklanmalıdır; lütfen hatayı oluşturan çağrı için kullanılan tüm bilgileri içeren bir günlük göndererek desteğimizle iletişime geçin.

Bu 5xx ve 10xx hataları aslında API hataları değil, Cloudflare'dan kaynaklanan web sunucusu hatalarıdır.

API hataları her zaman “error”:[“HataTipi:HataMesajı”] gibi JSON formatında döndürülür, bu nedenle farklı bir formatta bir hata alındığında (520, 504, 502, 1020 gibi bir HTTP durum kodu gibi), geçici çözüm, API çağrısını kısa bir süre sonra tekrar denemek ve umarız çağrı başarılı olacaktır.