Întrebări frecvente API avansat

Ultima actualizare: 25 noiembrie 2025

Valori de stare posibile pentru tranzacțiile de depunere/retragere

Folosind endpoint-urile de finanțare REST API, clienții pot depune/retrage fonduri în/din contul lor Kraken și pot solicita starea în timp real a unei tranzacții de depunere/retragere.

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

Rețineți că valorile de stare au provenit inițial de la paginile 16/17 ale documentului Internet Financial Exchange Protocol (IFEX), dar valorile au fost modificate ușor pentru a fi mai potrivite pentru tranzacțiile crypto (nu toate valorile de stare posibile sunt utilizate, de exemplu).

Depuneri

Valorile de stare posibile pentru tranzacțiile de depunere sunt următoarele:

•
Settled = Depunerea a fost primită, dar necesită încă confirmări suplimentare pe blockchain.
•
Success = Depunerea a atins numărul necesar de confirmări pe blockchain.
•
Failure = Depunerea a eșuat (din unul sau mai multe motive).

Următoarele sunt câteva exemple despre cum ar apărea valorile de stare de mai sus în răspunsurile de la endpoint-ul DepositStatus:

Stare 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"}]}

Stare 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 de stare posibile pentru tranzacțiile de retragere sunt următoarele:

•
Initial = Solicitarea de retragere a fost primită și este verificată pentru validitate (eventuale restricții de finanțare în cont etc.).
•
Pending = Retragerea așteaptă să fie procesată de gateway-ul nostru de finanțare.
•
Settled = Retragerea a fost trimisă către blockchain (în acest moment, ID-ul tranzacției blockchain ar deveni disponibil).
•
Success = Tranzacția de retragere are cel puțin 1 confirmare pe blockchain.
•
On hold = Retragerea a fost reținută și trebuie verificată manual de echipa noastră de finanțare.
•
Failure = Retragerea a eșuat (din unul sau mai multe motive).

Următoarele sunt câteva exemple despre cum ar apărea valorile de stare de mai sus în răspunsurile de la endpoint-ul WithdrawStatus:

Stare Initial:{"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 Pending:{"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 Settled:{"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 Success:{"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 Failure:{"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 privind depunerile/retragerile sunt disponibile prin paginile noastre de asistență pentru finanțare în numerar și finanțare cu criptomonede.

Cum să recuperați timpul istoric și vânzările (istoricul tranzacțiilor) folosind endpoint-ul REST API Trades

Endpoint-ul REST API OHLC oferă doar o cantitate limitată de date istorice, în special 720 de puncte de date ale intervalului solicitat. De exemplu, solicitarea de date 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 să se recupereze întregul istoric de tranzacționare al piețelor noastre (timpul istoric și vânzările) prin endpoint-ul REST API Trades. OHLC pentru orice interval de timp și orice interval poate fi apoi creat din datele istorice de timp și vânzări.

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

De exemplu, un apel către endpoint-ul Trades, cum ar fi https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 ar returna timpul istoric și vânzările pentru XBT/USD de la 1 iunie 2019 la 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 endpoint-ul Trades ar trebui să înlocuiască valoarea parametrului since cu valoarea parametrului last din rezultatele apelului anterior, cum ar fi https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

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

Cum să plasați, vizualizați și anulați comenzi folosind o referință de utilizator

O referință de utilizator este un ID de comandă furnizat de client care poate fi utilizat în locul ID-ului real de comandă (furnizat de API) pentru anumite sarcini de gestionare a comenzilor (în special anularea comenzilor).

Referințele de utilizator sunt implementate pentru a fi cât mai flexibile posibil și, prin urmare, pot fi utilizate într-o varietate de moduri diferite, inclusiv:

•
ca un ID unic (unde fiecare comandă are o referință de utilizator diferită),
•
pentru a grupa comenzile înrudite (cum ar fi gruparea comenzilor cu niveluri diferite de levier),
•
sau ca un ID de rezervă în cazul în care ID-ul real al comenzii nu este cunoscut.

O referință de utilizator trebuie să fie o valoare numerică între 1 și 2.147.483.647 (în esență, orice număr pozitiv pe 32 de biți) și, prin urmare, ar putea fi implementată ca un simplu contor, ca o valoare aleatorie pe 32 de biți cu semn, sau chiar ca un timestamp în secunde (deși acest lucru ar eșua după 19 ianuarie 2038 la 3:14:07 UTC).

Plasarea comenzilor cu o referință de utilizator

Comenzile pot fi plasate cu o referință de utilizator atașată apelând endpoint-ul AddOrder și incluzând parametrul userref cu referința de utilizator ca 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 comenzilor care au o referință de utilizator

Comenzile care au deja o referință de utilizator atașată pot fi vizualizate apelând endpoint-urile Open/Closed/QueryOrders și incluzând parametrul userref cu referința de utilizator existentă ca valoare (în acest caz, referința de utilizator acționează ca un filtru, afișând doar comenzile 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 comenzilor care au o referință de utilizator

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

$ ./krakenapi CancelOrder txid=16764529

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

Rețineți că toate comenzile deschise cu aceeași referință de utilizator ar fi anulate, prin urmare este posibil să se efectueze un singur apel CancelOrder pentru a anula mai multe comenzi simultan (așa cum este indicat de valoarea count de 3 în răspunsul următor):

$ ./krakenapi CancelOrder txid=48695624

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

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

Această problemă poate fi legată de Cloudflare:

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

NOTĂ: Kraken are activată „Verificarea integrității browserului” (Browser Integrity Check).

Acest lucru se poate întâmpla dacă solicitarea dumneavoastră conține anteturi suspecte. De exemplu, solicitarea dumneavoastră poate să nu aibă un agent de utilizator sau să utilizeze un agent de utilizator non-standard; prin urmare, vă rugăm să verificați anteturile solicitării dumneavoastră.

Dacă nu puteți crea nicio solicitare standard pe care sistemul nostru o permite, trimiteți-ne o copie completă a solicitării(lor) pe care o(le) încercați, inclusiv adresa IP și toate anteturile. Aceste informații ne-ar permite să investigăm mai departe.

Oferă Kraken un mediu de testare API?

API Futures

Pentru API-urile noastre Futures REST și WebSocket (futures.kraken.com) oferim un mediu de testare complet folosind URL-ul API demo-futures.kraken.com.

Medii de testare REST, WebSocket și FIX

Pentru API-ul nostru spot REST/WebSocket și FIX API, oferim în prezent un mediu de testare pentru clienții calificați. Accesarea acestui mediu necesită un proces de integrare care poate fi inițiat prin contactarea directă a echipei API.

Testarea API-ului nostru folosind parametrul de testare Validate

Când plasați o comandă prin punctele finale REST API AddOrder sau WebSocket API addOrder, parametrul de intrare validate poate fi utilizat pentru a simula comanda.

Apelarea AddOrder/addOrder cu parametrul validate setat la true (validate=1, validate=true, validate=anything, etc.) va determina verificarea detaliilor comenzii pentru erori, dar răspunsul API nu va include niciodată un ID de comandă (care ar fi întotdeauna returnat pentru o comandă reușită fără parametrul validate).

Exemplu de apel AddOrder cu parametrul validate (rețineți ID-ul de comandă lipsă):

Bash

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

Comenzi reale mici și/sau comenzi cu prețuri extreme

Pentru un test API cuprinzător folosind parametrul Validate, recomandăm plasarea de ordine de piață foarte mici (ordine pentru dimensiunea minimă a comenzii), sau ordine limită care sunt prețuite mult sub prețul actual al pieței (plasarea unei ordine limită de vânzare ETH/USD la 800 $ când prețul pieței este 200 $, de exemplu).

Testarea folosind ordine live permite codului dumneavoastră API să interacționeze cu API-ul nostru în condiții reale, prin urmare fiecare aspect al testului va fi precis (cum afectează ordinele dumneavoastră registrul de ordine, etc.).

Actualizare TLS care ar putea afecta conexiunile dumneavoastră API

Din motive de securitate, am renunțat recent la suportul pentru TLS 1.0 și 1.1. Dacă întâmpinați mesaje de eroare de conexiune SSL/TLS în timp ce încercați să vă conectați la API-ul nostru, este probabil din cauza utilizării unuia dintre aceste standarde depreciate. Va trebui să modificați clientul API pentru a forța utilizarea TLS 1.2/1.3 sau să actualizați versiunea dumneavoastră de .NET la 4.6 sau o versiune superioară, care utilizează TLS 1.2/1.3 ca standard.

Calculator de autentificare REST API (Foaie Google)

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

•
Cheie privată (secretă) API
•
Punct final API (Balance, TradeBalance, QueryOrders, etc.)
•
Valoare nonce (consultați pagina noastră de asistență ce este un nonce pentru mai multe detalii)
•
Parametri de intrare punct final (de exemplu, asset=doge)

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

Instrucțiuni de utilizare

1
Deschideți calculatorul de autentificare REST API în Chrome (sau orice alt browser web recent)
2
Creați o copie a calculatorului în propriul dumneavoastră Google Drive prin meniul Fișier -> Creați o copie (va trebui să vă conectați la contul dumneavoastră Google pentru acest pas)
3
Editați câmpurile cheie API, punct final API, valoare nonce și date de intrare cu propria dumneavoastră cheie API și detaliile solicitării
4
Comparați semnătura de autentificare API calculată cu valoarea calculată de propriul dumneavoastră cod API (cele două valori trebuie să se potrivească exact)

Din motive de securitate, recomandăm utilizarea calculatorului de autentificare cu o cheie API temporară, și apoi ștergerea cheii API din contul dumneavoastră odată ce implementarea semnăturii de autentificare se dovedește a fi corectă.

Exemplu

Trebuie să utilizez un wrapper de bibliotecă client?

Principalul beneficiu al utilizării wrapperelor noastre de biblioteci client este că nu trebuie să depuneți timp/efort pentru a reinventa roata pentru crearea semnăturilor API, este deja făcut pentru dumneavoastră.

Dacă intenționați să efectuați apeluri doar către metode publice, atunci puteți alege să renunțați la bibliotecile client, deoarece nu este necesară autentificarea.

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