Întrebări frecvente despre API avansat

Ultima actualizare: 5 noiembrie 2026

Valori posibile ale stării pentru tranzacțiile de depunere/retragere

Utilizând endpointurile de finanțare ale API REST, clienții pot depune/retrage fonduri în/din Contul tău Kraken și pot solicita în timp real starea unei tranzacții de depunere/retragere.

Depunerile/retragerile trec prin mai multe etape între solicitarea inițială și finalizarea tranzacției; prin urmare, endpointurile de finanțare vor returna o valoare diferită a stării, în funcție de momentul în care sunt apelate.

Reține că valorile stărilor provin inițial de la paginile 16/17 ale documentului Internet Financial Exchange Protocol (IFEX), însă valorile au fost modificate ușor pentru a fi mai potrivite pentru tranzacțiile cripto (de exemplu, nu sunt utilizate toate valorile posibile ale stării).

Depuneri

Valorile posibile ale stării pentru tranzacțiile de depunere sunt următoarele:

•
Decontată = Depunerea a fost primită, dar necesită în continuare confirmări suplimentare pe blockchain.
•
Reușită = Depunerea a atins numărul necesar de confirmări pe blockchain.
•
Eșec = Depunerea a eșuat (din unul sau mai multe motive).

Iată câteva exemple despre cum ar apărea valorile stărilor de mai sus în răspunsurile de la endpointul DepositStatus:

Starea Settled:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Starea Success:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

Retrageri

Valorile posibile ale stării pentru tranzacțiile de retragere sunt următoarele:

•
Inițială = Solicitarea de retragere a fost primită și este verificată pentru validitate (inclusiv eventualele restricții de finanțare ale contului).
•
În curs = Retragerea așteaptă să fie procesată de gateway-ul nostru de finanțare.
•
Decontată = Retragerea a fost trimisă către blockchain (în acest moment, ID-ul tranzacției de pe blockchain devine disponibil).
•
Reușită = Tranzacția de retragere are cel puțin 1 confirmare pe blockchain.
•
În așteptare = Retragerea a fost pusă în așteptare și trebuie verificată manual de echipa noastră de finanțare.
•
Eșec = Retragerea a eșuat (din unul sau mai multe motive).

Mai jos sunt câteva exemple despre cum ar apărea valorile de stare de mai sus în răspunsurile de la endpointul WithdrawStatus:

Stare inițială:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Stare în așteptare:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Stare finalizată:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Stare reușită:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Stare de eșec:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

Informații suplimentare despre depuneri/retrageri sunt disponibile pe paginile noastre de finanțare în numerar și finanțare cripto din secțiunea de suport.

Cum să recuperezi istoricul timpului și al vânzărilor (istoricul tranzacționării) utilizând endpointul Trades al API REST

Endpointul OHLC al API REST oferă doar o cantitate limitată de date istorice, mai exact 720 de puncte de date pentru intervalul solicitat. De exemplu, solicitarea datelor OHLC la intervale de 1 minut va returna cele mai recente 720 de minute (12 ore) de date.

Pentru aplicațiile care necesită date OHLC sau tick suplimentare, este posibilă recuperarea întregului istoric de tranzacționare al piețelor noastre (istoricul timpului și al vânzărilor) prin intermediul endpointului Trades al API REST. Datele OHLC pentru orice interval de timp și orice perioadă pot fi apoi create pe baza datelor istorice privind timpul și vânzările.

Endpointul Trades acceptă un parametru opțional numit since, care specifică data/ora de început a datelor. Valoarea since este un timestamp UNIX cu rezoluție de nanosecunde (un timestamp UNIX standard în secunde, cu 9 cifre suplimentare).

De exemplu, un apel către endpointul Trades, precum https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000, ar returna istoricul timpului și al vânzărilor pentru XBT/USD începând cu 01/06/2019, ora 00:00:00 UTC:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Apelurile ulterioare către endpointul Trades ar trebui să înlocuiască valoarea parametrului since cu valoarea parametrului last din rezultatele apelului anterior, precum https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Utilizarea valorii speciale since de 0 (zero) ar returna istoricul timpului și al vânzărilor de la începutul pieței (începând cu prima tranzacție).

Cum să plasezi, să vizualizezi și să anulezi ordine folosind o referință de utilizator

O referință a utilizatorului este un ID de ordin furnizat de client, care poate fi utilizat în locul ID-ului efectiv al ordinului (furnizat de API) pentru anumite operațiuni de gestionare a ordinelor, în special pentru anularea ordinelor.

Referințele utilizatorului sunt implementate pentru a fi cât mai flexibile posibil și, prin urmare, pot fi utilizate în mai multe moduri, inclusiv:

•
ca ID unic (fiecare ordin având o referință diferită a utilizatorului),
•
pentru a grupa ordine asociate (de exemplu, ordine cu niveluri diferite de levier),
•
sau ca ID de rezervă în cazul în care ID-ul efectiv al ordinului nu este cunoscut.

O referință a utilizatorului trebuie să fie o valoare numerică între 1 și 2.147.483.647 (practic, orice număr pozitiv pe 32 de biți) și, prin urmare, poate fi implementată ca un contor simplu, ca o valoare aleatorie semnată pe 32 de biți sau chiar ca un timestamp exprimat în secunde (deși această variantă ar înceta să funcționeze după 19/01/2038, la 03:14:07 UTC).

Plasarea ordinelor cu o referință a utilizatorului

Ordinele pot fi plasate cu o referință atașată a utilizatorului prin apelarea endpointului AddOrder și includerea parametrului userref, cu referința utilizatorului drept valoare:

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

Vizualizarea ordinelor care au o referință de utilizator

Ordinele care au deja atașată o referință de utilizator pot fi vizualizate apelând endpointurile Open/Closed/QueryOrders și incluzând parametrul userref cu referința de utilizator existentă drept valoare (în acest caz, referința de utilizator acționează ca filtru, afișând doar ordinele asociate):

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

Anularea ordinelor care au o referință de utilizator

Ordinele care au deja atașată o referință de utilizator pot fi anulate folosind referința de utilizator, apelând endpointul CancelOrder și utilizând referința de utilizator ca valoare txid (în locul valorii ID-ului ordinului):

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

Reține că toate ordinele deschise cu aceeași referință de utilizator vor fi anulate, prin urmare este posibil să efectuezi un singur apel CancelOrder pentru a anula simultan mai multe ordine (după cum indică valoarea count de 3 din următorul răspuns):

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

De ce primesc o eroare 403 când utilizez API-ul Kraken?

Această problemă poate avea legătură cu Cloudflare:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

NOTĂ: Kraken are activată opțiunea "Browser Integrity Check".

Acest lucru se poate întâmpla dacă solicitarea ta conține antete suspecte. De exemplu, este posibil ca solicitarea ta să nu conțină un user agent sau să utilizeze un user agent care nu este standard; verifică, prin urmare, antetele solicitării.

Dacă nu poți crea solicitări standard acceptate de sistemul nostru, trimite-ne o copie completă a solicitării sau solicitărilor pe care încerci să le trimiți, inclusiv adresa ta IP și toate antetele. Aceste informații ne-ar permite să investigăm mai detaliat.

Oferă Kraken un mediu pentru testarea API-ului?

Medii de testare REST, WebSocket și FIX

Pentru API-ul nostru REST/WebSocket spot și API-ul FIX, precum și pentru API-ul nostru REST/WebSocket pentru instrumente derivate și API-ul FIX, oferim în prezent un mediu de testare clienților eligibili. Pentru a accesa acest mediu este necesară parcurgerea unui proces de onboarding, care poate începe prin contactarea echipei API.

Testarea API-ului nostru utilizând parametrul de testare Validate

Când plasezi un ordin prin endpointurile AddOrder ale API-ului REST sau addOrder ale API-ului WebSocket, parametrul de intrare validate poate fi utilizat pentru a simula ordinul.

Apelarea AddOrder/addOrder cu parametrul validate setat la true (validate=1, validate=true, validate=anything etc.) va determina verificarea detaliilor ordinului pentru depistarea erorilor, însă răspunsul API nu va include niciodată un ID de ordin (care ar fi returnat întotdeauna pentru un ordin plasat cu succes fără parametrul validate).

Exemplu de apel AddOrder cu parametrul validate (observă lipsa ID-ului ordinului):

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

Ordine reale de valoare mică și/sau ordine cu prețuri extreme

Pentru un test API complet, folosind funcția Validate Parameter, recomandăm plasarea unor ordine market de valoare foarte mică (ordine pentru dimensiunea minimă a ordinului) sau a unor ordine limită cu prețuri mult îndepărtate de prețul actual al pieței (de exemplu, plasarea unui ordin limită de vânzare ETH/USD la 800 $, când prețul pieței este de 200 $).

Testarea folosind ordine live permite codului tău API să interacționeze cu API-ul nostru în condiții reale, astfel încât fiecare aspect al testului va fi exact (modul în care ordinele tale afectează registrul de ordine etc.).

Actualizarea TLS care ar putea afecta conexiunile API

Din motive de securitate, am renunțat recent la suportul pentru TLS 1.0 și 1.1. Dacă întâmpini mesaje de eroare privind conexiunea SSL/TLS atunci când încerci să te conectezi la API-ul nostru, cauza este probabil utilizarea unuia dintre aceste standarde depreciate. Va trebui să modifici clientul API pentru a forța utilizarea TLS 1.2/1.3 sau să actualizezi versiunea .NET la 4.6 sau o versiune ulterioară, care utilizează TLS 1.2/1.3 în mod standard.

Calculator pentru autentificarea API REST (foaie Google)

Următoarea foaie Google poate fi utilizată pentru a calcula semnătura de autentificare API pentru orice combinație de date de intrare:

•
Cheie API privată (secretă)
•
endpoint API (Balance, TradeBalance, QueryOrders etc.)
•
Valoarea nonce (consultă pagina noastră de asistență despre ce este un nonce pentru mai multe detalii)
•
Parametri de intrare ai endpointului (asset=doge, de exemplu)

Calculatorul poate fi utilizat pentru a verifica dacă algoritmul de autentificare a fost implementat corect, evitând astfel eventualele probleme (în special erori neașteptate de tip cheie nevalidă) mai târziu în ciclul de dezvoltare.

Instrucțiuni de utilizare

1
Deschide calculatorul pentru autentificarea API REST în Chrome (sau în orice alt browser web recent)
2
Fă o copie a calculatorului în propriul Google Drive din meniul File -> Make a copy (pentru acest pas va trebui să te conectezi la contul tău Google)
3
Completează câmpurile API key, API endpoint, nonce value și input data cu propria cheie API și detaliile solicitării
4
Compară semnătura de autentificare API calculată cu valoarea calculată de propriul cod API (cele două valori trebuie să coincidă exact)

Din motive de securitate, recomandăm utilizarea calculatorului pentru autentificare cu o cheie API temporară, apoi ștergerea cheii API din contul tău după ce se confirmă că implementarea semnăturii de autentificare este corectă.

Exemplu

Trebuie să utilizez un wrapper pentru biblioteca client?

Principalul beneficiu al utilizării wrapperelor pentru biblioteca noastră client este că nu trebuie să aloci timp și efort pentru a reinventa roata la crearea semnăturilor API — acestea sunt deja create pentru tine.

Dacă intenționezi să apelezi doar metode publice, poți alege să nu utilizezi bibliotecile client, deoarece nu este necesară autentificarea.

Lista wrapperelor disponibile o poți găsi aici.