Avansert API FAQ

Sist oppdatert: 25. november 2025

Mulige statusverdier for innskudds-/uttakstransaksjoner

Ved å bruke REST API-finansieringsendepunktene kan klienter sette inn/ta ut midler til/fra Kraken-kontoen sin, og be om sanntidsstatus for en innskudds-/uttakstransaksjon.

Innskudd/uttak går gjennom flere stadier mellom den første forespørselen og transaksjonen er fullført, derfor vil finansieringsendepunktene returnere en annen statusverdi avhengig av når de kalles.

Merk at statusverdiene opprinnelig kom fra sidene 16/17 i dokumentet Internet Financial Exchange Protocol (IFEX), men verdiene er litt modifisert for å være mer egnet for kryptotransaksjoner (for eksempel brukes ikke alle mulige statusverdier).

Innskudd

De mulige statusverdiene for innskuddstransaksjoner er som følger:

•
Avregnet = Innskuddet er mottatt, men trenger fortsatt ytterligere bekreftelser på blokkjeden.
•
Vellykket = Innskuddet har oppnådd det nødvendige antallet bekreftelser på blokkjeden.
•
Mislykket = Innskuddet mislyktes (av en eller flere årsaker).

Følgende er noen eksempler på hvordan statusverdiene ovenfor vil vises i svar fra DepositStatus-endepunktet:

Status Avregnet:{"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"}]}

Status Vellykket:{"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"}]}

Uttak

De mulige statusverdiene for uttakstransaksjoner er som følger:

•
Initial = Uttaksforespørselen er mottatt og kontrolleres for gyldighet (eventuelle finansieringsrestriksjoner på kontoen osv.).
•
Venter = Uttaket venter på å bli behandlet av vår finansieringsgateway.
•
Avregnet = Uttaket er sendt til blokkjeden (på dette tidspunktet vil blokkjedetransaksjons-ID-en bli tilgjengelig).
•
Vellykket = Uttakstransaksjonen har minst 1 bekreftelse på blokkjeden.
•
På vent = Uttaket er satt på vent og må kontrolleres manuelt av vårt finansieringsteam.
•
Mislykket = Uttaket mislyktes (av en eller flere årsaker).

Følgende er noen eksempler på hvordan statusverdiene ovenfor vil vises i svar fra WithdrawStatus-endepunktet:

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

Status Venter:{"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"}]}

Status Avregnet:{"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"}]}

Status Vellykket:{"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"}]}

Status Mislykket:{"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"}]}

Ytterligere informasjon om innskudd/uttak er tilgjengelig via våre støttesider for kontantfinansiering og kryptofinansiering.

Hvordan hente historisk tid og salg (handelshistorikk) ved hjelp av REST API Trades-endepunktet

REST API OHLC-endepunktet gir kun en begrenset mengde historiske data, spesifikt 720 datapunkter for det forespurte intervallet. For eksempel vil en forespørsel om OHLC-data i 1-minutters intervaller returnere de siste 720 minuttene (12 timer) med data.

For applikasjoner som krever ytterligere OHLC- eller tick-data, er det mulig å hente hele handelshistorikken for våre markeder (historisk tid og salg) via REST API Trades-endepunktet. OHLC for enhver tidsramme og ethvert intervall kan deretter opprettes fra historiske tid- og salgsdata.

Trades-endepunktet tar en valgfri parameter kalt since, som spesifiserer startdato/-tid for dataene. since-verdien er et UNIX-tidsstempel med nanosekundoppløsning (et standard UNIX-tidsstempel i sekunder med 9 ekstra sifre).

For eksempel vil et kall til Trades-endepunktet, som https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000, returnere historisk tid og salg for XBT/USD fra 1. juni 2019 kl. 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"}}

Påfølgende kall til Trades-endepunktet bør erstatte verdien av since-parameteren med verdien av last-parameteren fra resultatene av det forrige kallet, for eksempel https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Bruk av den spesielle since-verdien 0 (null) vil returnere historisk tid og salg fra begynnelsen av markedet (startende med den aller første handelen).

Hvordan plassere, vise og kansellere ordrer ved hjelp av en brukerreferanse

En brukerreferanse er en klientlevert ordre-ID som kan brukes i stedet for den faktiske (API-leverte) ordre-ID-en for enkelte ordrehåndteringsoppgaver (spesielt kansellering av ordrer).

Brukerreferanser er implementert for å være så fleksible som mulig, og kan derfor brukes på en rekke forskjellige måter, inkludert:

•
som en unik ID (der hver ordre har en annen brukerreferanse),
•
for å gruppere relaterte ordrer sammen (for eksempel gruppering av ordrer med forskjellige giringnivåer),
•
eller som en reserve-ID i tilfelle den faktiske ordre-ID-en ikke er kjent.

En brukerreferanse må være en numerisk verdi mellom 1 og 2 147 483 647 (i hovedsak et hvilket som helst positivt 32-bits tall), og kan derfor implementeres som en enkel teller, som en tilfeldig signert 32-bits verdi, eller til og med som et tidsstempel i sekunder (selv om dette ville mislykkes etter 19. januar 2038 kl. 03:14:07 UTC).

Plassere ordrer med en brukerreferanse

Ordrer kan plasseres med en vedlagt brukerreferanse ved å kalle AddOrder-endepunktet og inkludere userref-parameteren med brukerreferansen som verdi:

$ ./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"]}}

Vise ordrer som har en brukerreferanse

Ordrer som allerede har en vedlagt brukerreferanse kan vises ved å kalle Open/Closed/QueryOrders-endepunktene og inkludere userref-parameteren med den eksisterende brukerreferansen som verdi (i dette tilfellet fungerer brukerreferansen som et filter, og viser kun de tilknyttede ordrene):

$ ./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}}

Kansellere ordrer som har en brukerreferanse

Ordrer som allerede har en vedlagt brukerreferanse kan kanselleres ved hjelp av brukerreferansen ved å kalle CancelOrder-endepunktet og bruke brukerreferansen som txid-verdi (i stedet for ordre-ID-verdien):

$ ./krakenapi CancelOrder txid=16764529

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

Merk at alle åpne ordrer med samme brukerreferanse vil bli kansellert, derfor er det mulig å foreta et enkelt CancelOrder-kall for å kansellere flere ordrer samtidig (som indikert av count-verdien 3 i følgende svar):

$ ./krakenapi CancelOrder txid=48695624

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

Hvorfor får jeg en 403-feil når jeg bruker Kraken API?

Dette problemet kan være relatert til Cloudflare:

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

MERK: Kraken har aktivert "Browser Integrity Check".

Dette kan oppstå hvis forespørselen din inneholder mistenkelige headere. For eksempel kan forespørselen din mangle en user agent, eller bruke en ikke-standard user agent; så vennligst sjekk forespørselens headere.

Hvis du ikke klarer å opprette standardforespørsler som systemet vårt tillater, send oss en fullstendig kopi av forespørselen(e) du prøver å sende, inkludert din IP-adresse og alle headere. Denne informasjonen vil gjøre det mulig for oss å undersøke saken videre.

Tilbyr Kraken et API-testmiljø?

Futures API

For våre Futures REST og WebSocket API-er (futures.kraken.com) tilbyr vi et komplett testmiljø ved hjelp av API-URL-en demo-futures.kraken.com.

REST, WebSocket og FIX testmiljøer

For vår spot REST/WebSocket API og FIX API tilbyr vi for tiden et testmiljø for kvalifiserte klienter. Tilgang til dette miljøet krever en onboarding-prosess som kan startes ved å kontakte API-teamet direkte.

Testing av vår API ved hjelp av Validate-testparameteret

Når du legger inn en ordre via REST API AddOrder- eller WebSocket API addOrder-endepunktene, kan inputparameteret validate brukes til å simulere ordren.

Å kalle AddOrder/addOrder med validate-parameteret satt til true (validate=1, validate=true, validate=anything, osv.) vil føre til at ordredetaljene sjekkes for feil, men API-svaret vil aldri inkludere en ordre-ID (som alltid ville blitt returnert for en vellykket ordre uten validate-parameteret).

Eksempel på AddOrder-kall med validate-parameteret (merk den manglende ordre-ID-en):

Bash

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

Små reelle ordrer og/eller ordrer med ekstreme priser

For en omfattende API-test ved hjelp av Validate-parameteret, anbefaler vi å plassere svært små markedsordrer (ordrer for minimum ordrestørrelse), eller limitordrer som er priset langt unna gjeldende markedspris (for eksempel å plassere en limitordre for å selge ETH/USD til $800 når markedsprisen er $200).

Testing med live-ordrer lar API-koden din interagere med vår API under virkelige forhold, og dermed vil alle aspekter av testen være nøyaktige (hvordan ordrene dine påvirker ordreboken, osv.).

TLS-oppgradering som kan påvirke API-tilkoblingene dine

Av sikkerhetsgrunner har vi nylig droppet støtte for TLS 1.0 og 1.1. Hvis du støter på SSL/TLS-tilkoblingsfeilmeldinger når du prøver å koble til vår API, skyldes det sannsynligvis bruken av en av disse utdaterte standardene. Du må endre API-klienten din for å tvinge bruk av TLS 1.2/1.3 eller oppgradere din versjon av .NET til 4.6 eller nyere, som bruker TLS 1.2/1.3 som standard.

REST API-autentiseringskalkulator (Google Sheet)

Følgende Google Sheet kan brukes til å beregne REST API-autentiseringssignaturen for enhver kombinasjon av inputdata:

•
API privat (hemmelig) nøkkel
•
API-endepunkt (Balance, TradeBalance, QueryOrders, osv.)
•
Nonce-verdi (se vår hva er en nonce støtteside for mer detaljer)
•
Endepunkt inputparametere (asset=doge, for eksempel)

Kalkulatoren kan brukes til å verifisere at autentiseringsalgoritmen er korrekt implementert, og dermed unngå potensielle problemer (spesielt uventede ugyldig nøkkel-feil) senere i utviklingssyklusen.

Bruksanvisning

1
Åpne REST API-autentiseringskalkulatoren i Chrome (eller en hvilken som helst annen nyere nettleser)
2
Lag en kopi av kalkulatoren til din egen Google Drive via menyen Fil -> Lag en kopi (du må logge på Google-kontoen din for dette trinnet)
3
Rediger feltene API-nøkkel, API-endepunkt, nonce-verdi og inputdata med din egen API-nøkkel og forespørselsdetaljer
4
Sammenlign den beregnede API-autentiseringssignaturen med verdien beregnet av din egen API-kode (de to verdiene må stemme nøyaktig overens)

Av sikkerhetsgrunner anbefaler vi å bruke autentiseringskalkulatoren med en midlertidig API-nøkkel, og deretter slette API-nøkkelen fra kontoen din når implementeringen av autentiseringssignaturen din er vist å være korrekt.

Eksempel

Må jeg bruke en klientbibliotek-wrapper?

Den primære fordelen med å bruke våre klientbibliotek-wrappers er at du ikke trenger å bruke tid/krefter på å finne opp hjulet på nytt for å lage API-signaturer; det er allerede gjort for deg.

Hvis du bare har til hensikt å foreta kall til offentlige metoder, kan du velge å ikke bruke klientbiblioteker, da ingen autentisering er nødvendig.

Listen over tilgjengelige wrappers finner du her.