Mesaje de eroare API

Erorile de permisiune refuzată sunt returnate atunci când clientul API încearcă o sarcină pentru care cheia API nu are permisiune. De exemplu, dacă un client API ar încerca să recupereze soldul contului folosind o cheie API care a fost configurată pentru a permite accesul la tranzacționare, dar nu și accesul la gestionarea contului, atunci ar fi returnată eroarea de permisiune refuzată. Puteți revizui cheile API și setările acestora (cum ar fi permisiunile lor) prin fila Setări -> API din gestionarea contului. Ar trebui să vă asigurați că cheile API utilizate de aplicațiile dvs. terțe au toate setările și permisiunile pe care le necesită aplicațiile dvs.

Această eroare este returnată atunci când cheia API utilizată pentru apel este fie expirată, fie dezactivată. Vă rugăm să revizuiți cheia API în fila Setări -> API din gestionarea contului sau să generați una nouă și să vă actualizați aplicația.

Puteți obține lista completă a perechilor noastre de active din apelul public AssetPairs și puteți căuta numele perechii ca intrare în anteturile Json sau după parametrul "altname": https://api.kraken.com/0/public/AssetPairs

Această eroare este returnată atunci când o metodă este apelată fără parametrii necesari. De exemplu, apelarea metodei QueryOrders fără a specifica un parametru valid de ID tranzacție (txid) ar duce la returnarea erorii de argumente invalide. Apelarea unei metode cu parametri inutili nu ar returna totuși eroarea de argumente invalide, deoarece parametrii inutili ar fi pur și simplu ignorați.

Erorile de semnătură invalidă apar dacă fie cheia API, fie secretul API sunt scrise incorect în programul dumneavoastră, fie pentru că datele POST utilizate în autentificare și datele POST trimise către API nu corespund. Pentru referințe suplimentare, următorul este un exemplu de cod Python pentru implementarea algoritmului de semnătură API. Cheia publică API corespunzătoare ar trebui copiată și lipită din gestionarea contului, iar metoda API și datele POST ar trebui actualizate corespunzător. Valoarea de ieșire poate fi utilizată direct ca valoare pentru antetul HTTP API-Sign. #!/usr/bin/env python

# Import required Python libraries
import time
import base64
import hashlib
import hmac

# Decode API private key from base64 format displayed in account management
api_secret = base64.b64decode("nmlrD83t1J+yVWKUBx9vD6j26C5zhC11tFfXpN+Ww+8oOVuGgse5AeADcvl95jYaD+UAi3D5CrVfFr8GfQ7zhA==")

# Variables (API method, nonce, and POST data)
api_path = "/0/private/TradeBalance"
api_nonce = str(int(time.time()*1000))
api_post = "nonce=" + api_nonce + "&asset=xxbt"

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

# Encode signature into base64 format used in API-Sign value
api_signature = base64.b64encode(api_hmac.digest())

# API authentication signature for use in API-Sign HTTP header
print(api_signature)SHA256 este calculat folosind valoarea nonce în sine și datele POST pentru metoda API, iar DATELE POST sunt compuse din perechile nume/valoare pentru nonce (din nou) și parametrii metodei API. Un exemplu de date care ar trebui transmise către SHA256 pentru metoda TradeBalance ar fi următorul:SHA256 = SHA256 of "1541933977000nonce=1541933977000&asset=xxbt"Valoarea șirului care este transmisă către SHA256 nu ar trebui să conțină valori nule suplimentare (\0), iar valoarea șirului nu ar trebui să fie codificată ca base64 sau hex (adică, valoarea șirului ar trebui să fie un șir de text simplu).Calea URI este URL-ul complet al metodei API, cu excepția prefixului "https://api.kraken.com", deci calea URI a metodei TradeBalance (de exemplu) ar fi valoarea șirului "/0/private/TradeBalance" fără valori nule suplimentare.HMAC SHA512 este calculat folosind calea URI și digestul SHA256 calculat anterior, cu cheia privată API decodificată base64 ca cheie HMAC. Un exemplu de date care ar trebui transmise către HMAC ar fi următorul:HMAC SHA512 using base64 decoded private key = HMAC of "/0/private/TradeBalanceSHA256"Anteturile HTTP API-Key și API-Sign sunt singurele două anteturi HTTP personalizate necesare. Antetul API-Key este o duplicare exactă a cheii publice API din gestionarea contului. Antetul API-Sign este digestul HMAC SHA512 codificat folosind base64.

Puteți găsi mai multe informații despre această eroare aici:https://support.kraken.com/hc/en-us/articles/360001148063Și mai multe despre Nonce și Nonce Window aici:https://support.kraken.com/hc/en-us/articles/360000906023https://support.kraken.com/hc/en-us/articles/360001148023

Erorile de sesiune invalidă sunt returnate prin API-ul WebSocket, atunci când se încearcă abonarea la un flux autentificat (privat) folosind un token de autentificare care nu mai este valid (a expirat deja, de exemplu).

Soluția este pur și simplu să solicitați un nou token de autentificare prin endpoint-ul REST API GetWebSocketsToken și să utilizați noul token pentru toate solicitările ulterioare de abonare autentificate (private).

O eroare de solicitare incorectă indică faptul că există ceva incorect în legătură cu solicitarea HTTP subiacentă (nu solicitarea API ulterioară), cum ar fi URL-uri nealiniate între REST/WebSocket sau includerea incorectă a datelor HTTP POST:

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

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

Această eroare este returnată atunci când endpoint-ul apelat nu este un endpoint valid.

Ați depășit limita de rată API.

Deși adăugarea și anularea ordinelor nu se iau în considerare la limitele noastre standard de contor API, aceste operațiuni au propriul lor contor de adăugare și anulare a ordinelor. Acest contor funcționează în așa fel încât, cu cât ordinele rămân mai mult timp în registrul de ordine, cu atât clienții pot adăuga sau anula mai multe ordine.

Mesajele de eroare de blocare temporară pot apărea dacă ați avut prea multe apeluri API eșuate sau prea multe erori nonce invalide într-o perioadă scurtă de timp sau semnături invalide. Chiar dacă aceste apeluri returnează o eroare, acea eroare este totuși contorizată în limitele API-ului dumneavoastră și poate duce la o blocare temporară.

Blocările temporare durează aproximativ 15 minute. După ce primiți eroarea de blocare temporară, vă rugăm să așteptați 15 minute înainte de a trimite noi solicitări API. Dacă declanșați mai multe erori nonce invalide, vă rugăm să măriți fereastra nonce, deoarece acest lucru poate contribui la reducerea frecvenței cu care apar aceste erori. De asemenea, vă rugăm să încercați să reduceți frecvența apelurilor dumneavoastră API private.

Deschiderea de noi poziții spot în marjă a fost suspendată temporar pentru mentenanța motorului de tranzacționare. Funcționalitatea va reveni în curând și puteți urmări actualizările pe status.kraken.com.

Un alt motiv poate fi că pozițiile spot în marjă nu sunt disponibile în prezent pentru clienții rezidenți în anumite țări.

Pe Kraken nu puteți deschide o poziție long și short pentru aceeași pereche.

Dacă doriți să deschideți o poziție long și short pentru aceeași monedă, vă rugăm să alegeți perechi de tranzacționare diferite cu aceeași monedă ca monedă de bază sau de cotare. Ex: short XBT/USD, long XBT/EUR.

Această eroare apare atunci când ați depășit limitele alocației de marjă pentru nivelul dumneavoastră actual de verificare. Limitele alocației de marjă pentru fiecare monedă variază în funcție de nivelul dumneavoastră actual de verificare.

Avem fonduri limitate disponibile pentru extinderile de marjă. Mesajul "marjă insuficientă" indică faptul că nu mai avem fonduri în fondul de marjă aplicabil pentru moment. Aceasta se poate schimba în orice moment. Este posibil să puteți plasa cu succes comanda dumneavoastră doar câteva secunde sau minute mai târziu, dar comenzile cu volum mare și comenzile plasate în perioade de volum mare pot dura mai mult. Vă rugăm să acceptați scuzele noastre pentru orice inconvenient.

Această eroare apare atunci când există o Marjă Liberă insuficientă pentru a deschide o nouă poziție în cont sau dacă încercarea curentă de a deschide o poziție ar duce la scăderea Marjei Libere a contului sub 100%.

Nu aveți fondurile disponibile pentru a plasa această comandă. Vă rugăm să revizuiți pozițiile și comenzile dumneavoastră deschise pentru elemente care ar putea reține fondurile dumneavoastră.

Nu ați atins volumul minim de comandă pentru acest activ.

Ați depășit numărul maxim de ordine deschise disponibile pentru contul dumneavoastră.

Aceste limite se bazează pe nivelul dumneavoastră de verificare. Vă rugăm să închideți unele dintre ordinele dumneavoastră deschise sau să vă verificați contul la un nivel superior.

Ați depășit numărul maxim de poziții deschise disponibile pentru contul dumneavoastră.

Aceste limite se bazează pe nivelul dumneavoastră de verificare. Vă rugăm să închideți sau să decontați unele sau toate pozițiile dumneavoastră deschise sau să vă verificați contul la un nivel superior, dacă este posibil.

S-a încercat editarea unei comenzi existente (deschise), dar modificările nu au putut fi finalizate cu succes. Motivele posibile includ fonduri insuficiente pentru noua comandă, unele scenarii de umplere parțială și unele comenzi cu efect de levier.

Volumul nou este mai mic decât volumul deja executat/umplut.

Dimensiunea comenzii a depășit limita de dimensiune a poziției în marjă a perechii de tranzacționare.

Volumul afișat nu a atins volumul minim de comandă.

Volumul afișat trebuie să fie mai mic decât volumul comenzii.

Ordinele Iceberg nu sunt compatibile cu niciun alt tip de ordine în afară de un ordin limită.

Fiecare criptomonedă are un maxim de 5 adrese de depunere noi (neutilizate), după care orice încercare de a crea o a 6-a adresă nouă va returna o eroare.

Această eroare este returnată ori de câte ori endpoint-urile de finanțare sunt apelate cu un parametru „method” invalid sau lipsă. 

Parametrul de intrare „key” nu corespunde descrierii adresei setate în gestionarea contului (prin Funding -> Withdraw).

Sumele minime de retragere variază în funcție de monedă, iar orice încercare de retragere sub minim ar duce la această eroare.

Aceasta este o eroare generică ce indică faptul că o solicitare de finanțare nu a putut fi finalizată (de exemplu, clienții din anumite locații care încearcă să facă solicitări de staking on-chain ar cauza această eroare).

Retragerea solicitată nu a putut fi finalizată, deoarece adresa de destinație nu are informațiile necesare despre beneficiar/destinatar (rețineți că acest lucru se aplică în prezent doar anumitor retrageri din conturile canadiene).

Erorile de serviciu pe care le întâmpinați ar trebui să fie doar temporare. Puteți dori să retrimiteți solicitările dacă acestea au eșuat. Vom monitoriza problemele și vom actualiza pagina noastră:

https://status.kraken.com/

Atunci când ne confruntăm cu probleme de degradare a API-ului, acestea se pot traduce în probleme pentru Kraken sub formă de mesaje de serviciu indisponibil și întreruperi ale site-ului.

Această problemă are legătură cu securitatea contului dumneavoastră, care ar fi putut fi compromisă. Vă rugăm să vă schimbați parola și autentificarea cu doi factori și să contactați Centrul nostru de asistență.

Această eroare apare atunci când un indicator sau un parametru de intrare este dezactivat temporar sau permanent. Eroarea ar trebui să provină de la una dintre intrările transmise; vă rugăm să contactați asistența noastră trimițând un jurnal cu informațiile complete utilizate pentru apelul care a generat eroarea.

Aceste erori 5xx și 10xx nu sunt de fapt erori API, ci mai degrabă erori de server web de la Cloudflare.

Erorile API sunt întotdeauna returnate în format JSON, cum ar fi „error”:[„ErrorType:ErrorMessage”], așa că ori de câte ori este primită o eroare într-un format diferit (cum ar fi un cod de stare HTTP de 520, 504, 502, 1020 etc.), soluția intermediară este să încercați din nou apelul API la scurt timp după aceea și, sperăm, apelul va avea succes.