All
Suodatusperuste:
Miten voin tallettaa käteistä tililleni?
Tarvitsen apua tilin vahvistamisessa
Miksi en pääse tililleni?
Peritäänkö kryptovaluutan nostoista palvelumaksuja?
Tarvitsen apua tililleni kirjautumisessa
REST API -rahoituksen päätepisteiden avulla asiakkaat voivat tehdä talletuksia Kraken-tililleen ja nostoja sieltä sekä pyytää reaaliaikaisen tilan talletus- tai nostotapahtumalle.
Talletukset ja nostot käyvät läpi useita vaiheita alkuperäisestä pyynnöstä tapahtuman valmistumiseen, joten rahoituksen päätepisteet palauttavat eri tila-arvon sen mukaan, milloin niitä kutsutaan.
Huomaa, että tila-arvot ovat alun perin peräisin Internet Financial Exchange Protocol (IFEX) -asiakirjan sivuilta 16/17, mutta arvoja on hieman muokattu, jotta ne soveltuisivat paremmin kryptotapahtumiin (esimerkiksi kaikkia mahdollisia tila-arvoja ei käytetä).
Talletustapahtumien mahdolliset tila-arvot ovat seuraavat:
Selvitetty = Talletus on vastaanotettu, mutta lohkoketjussa tarvitaan vielä lisävahvistuksia.
Onnistunut = Talletus on saavuttanut lohkoketjussa vaaditun vahvistusmäärän.
Epäonnistunut = Talletus epäonnistui (yhdestä tai useammasta eri syystä).
Seuraavassa on esimerkkejä siitä, miltä edellä mainitut tila-arvot näyttävät DepositStatus-päätepisteen vastauksissa:
Selvitetty-tila:{"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"}]}
Onnistunut-tila:{"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"}]}
Nostotapahtumien mahdolliset tila-arvot ovat seuraavat:
Alustava = Nostopyyntö on vastaanotettu, ja sen kelvollisuus tarkistetaan (esimerkiksi tilin mahdolliset rahoitusrajoitukset).
Odottaa = Nosto odottaa käsittelyä rahoitusyhdyskäytävässämme.
Selvitetty = Nosto on lähetetty lohkoketjuun (tässä vaiheessa lohkoketjutapahtuman tunnus tulee saataville).
Onnistunut = Nostotapahtumalla on vähintään 1 vahvistus lohkoketjussa.
Pidossa = Nosto on asetettu pitoon, ja rahoitustiimimme on tarkistettava se manuaalisesti.
Epäonnistunut = Nosto epäonnistui (yhdestä tai useammasta eri syystä).
Seuraavassa on esimerkkejä siitä, miltä edellä mainitut tilaarvot näyttävät WithdrawStatus-päätepisteen vastauksissa:
Alustava tila:{"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"}]}
Odotustila:{"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"}]}
Selvitetty tila:{"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"}]}
Onnistunut tila:{"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"}]}
Epäonnistunut tila:{"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"}]}
Talletuksia ja nostoja koskevia lisätietoja on saatavilla käteisrahoitusta ja kryptorahoitusta käsitteleviltä tukisivuiltamme.
REST API:n OHLC-päätepiste tarjoaa vain rajallisen määrän historiallista dataa, tarkemmin sanottuna 720 pyydetyn aikavälin datapistettä. Jos esimerkiksi pyydät OHLC-dataa yhden minuutin välein, saat viimeisimmän 720 minuutin (12 tunnin) datan.
Sovelluksissa, jotka tarvitsevat lisää OHLC- tai tick-dataa, on mahdollista noutaa markkinoidemme koko kaupankäyntihistoria (historialliset aika- ja kauppatiedot) REST API:n Trades-päätepisteen kautta. Minkä tahansa aikavälin OHLC voidaan tämän jälkeen muodostaa historiallisista aika- ja kauppatiedoista.
Trades-päätepiste hyväksyy valinnaisen since-nimisen parametrin, joka määrittää datan aloituspäivän ja -ajan. since-arvo on UNIX-aikaleima nanosekunnin tarkkuudella (tavallinen sekunteina ilmoitettu UNIX-aikaleima, johon on lisätty 9 numeroa).
Esimerkiksi Trades-päätepisteelle tehty kutsu, kuten https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000, palauttaisi XBT/USD:n historialliset aika- ja kauppatiedot 1. kesäkuuta 2019 klo 00.00.00 UTC alkaen:
{"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"}}
Trades-päätepisteelle tehtävissä seuraavissa kutsuissa since-parametrin arvo tulee korvata edellisen kutsun tuloksista saatavalla last-parametrin arvolla esimerkiksi https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.
Erityisen since-arvon 0 (nolla) käyttäminen palauttaisi historialliset aika- ja kauppatiedot markkinan alusta alkaen (ensimmäisestä kaupasta lähtien).
Käyttäjäviite on asiakkaan antama toimeksiantotunnus, jota voidaan käyttää varsinaisen (APIn antaman) toimeksiantotunnuksen sijasta joissakin toimeksiantojen hallintatehtävissä, erityisesti toimeksiantojen peruuttamisessa.
Käyttäjäviitteet on suunniteltu mahdollisimman joustaviksi, joten niitä voidaan käyttää monin eri tavoin, esimerkiksi:
yksilöllisenä tunnuksena (jolloin jokaisella toimeksiannolla on eri käyttäjäviite),
toisiinsa liittyvien toimeksiantojen ryhmittelemiseen (esimerkiksi eri vivutustasoilla olevien toimeksiantojen ryhmittelemiseen),
tai varatunnuksena tilanteessa, jossa varsinainen toimeksiantotunnus ei ole tiedossa.
Käyttäjäviitteen on oltava numeerinen arvo välillä 1–2 147 483 647 (käytännössä mikä tahansa positiivinen 32-bittinen luku), joten se voidaan toteuttaa yksinkertaisena laskurina, satunnaisena etumerkillisenä 32-bittisenä arvona tai jopa sekunteina ilmoitettuna aikaleimana (vaikka tämä lakkaisi toimimasta 19. tammikuuta 2038 klo 3.14.07 UTC).
Toimeksiantoihin voidaan liittää käyttäjäviite kutsumalla AddOrder-päätepistettä ja lisäämällä userref-parametri, jonka arvoksi asetetaan käyttäjäviite:
$ ./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"]}}
Toimeksiannot, joihin on jo liitetty käyttäjäviite, voidaan nähdä kutsumalla Open/Closed/QueryOrders-päätepisteitä ja sisällyttämällä userref-parametriin olemassa oleva käyttäjäviite arvoksi (tässä tapauksessa käyttäjäviite toimii suodattimena ja näyttää vain siihen liittyvät toimeksiannot):
$ ./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}}
Toimeksiannot, joihin on jo liitetty käyttäjäviite, voidaan peruuttaa käyttäjäviitteen avulla kutsumalla CancelOrder-päätepistettä ja käyttämällä käyttäjäviitettä txid-arvona (toimeksiannon tunnisteen sijaan):
$ ./krakenapi CancelOrder txid=16764529
{"error":[],"result":{"count":1}}
Huomaa, että kaikki samaa käyttäjäviitettä käyttävät avoimet toimeksiannot peruutetaan. Siksi yhdellä CancelOrder-kutsulla voidaan peruuttaa useita toimeksiantoja samanaikaisesti (kuten seuraavan vastauksen count-arvo 3 osoittaa):
$ ./krakenapi CancelOrder txid=48695624
{"error":[],"result":{"count":3}}
Tämä ongelma saattaa liittyä Cloudflareen:
https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-
HUOMAUTUS: Krakenissa on "Browser Integrity Check" käytössä.
Ongelma voi ilmetä, jos pyyntösi sisältää epäilyttäviä otsakkeita. Pyynnöstäsi saattaa esimerkiksi puuttua user agent tai siinä saatetaan käyttää epästandardia user agentia. Tarkista siis pyyntösi otsakkeet.
Jos et pysty luomaan järjestelmämme sallimia vakiomuotoisia pyyntöjä, lähetä meille täydellinen kopio yrittämistäsi pyynnöistä, mukaan lukien IP-osoitteesi ja kaikki otsakkeet. Näiden tietojen avulla voimme tutkia asiaa tarkemmin.
Tarjoamme tällä hetkellä hyväksytyille asiakkaille testiympäristön spot-REST/WebSocket APIamme ja FIX APIamme sekä johdannaisten REST/WebSocket APIamme ja FIX APIamme varten. Testiympäristön käyttö edellyttää perehdytysprosessia, jonka voi aloittaa ottamalla yhteyttä API-tiimiin.
Kun toimeksianto lisätään REST API AddOrder- tai WebSocket API addOrder -päätepisteen kautta, validate-syöteparametrilla voidaan simuloida toimeksianto.
AddOrder/addOrder-kutsun suorittaminen siten, että validate-parametrin arvoksi on asetettu true (validate=1, validate=true, validate=anything jne.), tarkistaa toimeksiannon tiedot virheiden varalta, mutta API-vastaus ei koskaan sisällä toimeksiannon tunnistetta (joka palautettaisiin aina onnistuneen toimeksiannon yhteydessä, jos validate-parametria ei käytetä).
Esimerkki AddOrder-kutsusta, jossa käytetään validate-parametria (huomaa puuttuva toimeksiannon tunniste):
Bash
$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}Pienet oikeat toimeksiannot ja/tai toimeksiannot poikkeavilla hinnoilla
Suosittelemme kattavaa API-testiä Validate Parameter -toiminnolla käyttämällä hyvin pieniä markkinatoimeksiantoja (toimeksiantoja, jotka koskevat toimeksiannon vähimmäiskokoa) tai rajahintatoimeksiantoja, joiden hinta poikkeaa huomattavasti nykyisestä markkinahinnasta (esimerkiksi rajahintatoimeksianto, jolla myydään ETH/USD:tä 800 $:n hinnalla, kun markkinahinta on 200 $).
Oikeilla toimeksiannoilla testaaminen mahdollistaa API-koodisi vuorovaikutuksen API:mme kanssa todellisissa olosuhteissa, joten testin kaikki osa-alueet ovat tarkkoja (esimerkiksi se, miten toimeksiantosi vaikuttavat tarjouskirjaan).
Olemme äskettäin lopettaneet TLS 1.0:n ja 1.1:n tuen turvallisuussyistä. Jos saat SSL/TLS-yhteysvirheilmoituksia yrittäessäsi muodostaa yhteyttä API:imme, syynä on todennäköisesti jommankumman vanhentuneen standardin käyttö. Sinun on muokattava API-asiakasohjelmaasi niin, että se käyttää pakotetusti TLS 1.2:ta/1.3:a, tai päivitettävä .NET-versiosi vähintään versioon 4.6, joka käyttää TLS 1.2:ta/1.3:a oletusarvoisesti.
Seuraavan Google Sheets -taulukon avulla voit laskea REST API -todennusallekirjoituksen millä tahansa syötetietojen yhdistelmällä:
API:n yksityinen (salainen) avain
API:n päätepiste (Balance, TradeBalance, QueryOrders jne.)
Nonce-arvo (lisätietoja saat nonce-arvoa käsittelevältä tukisivultamme)
Päätepisteen syöteparametrit (esimerkiksi asset=doge)
Laskinta voidaan käyttää sen varmistamiseen, että todennusalgoritmi on toteutettu oikein. Näin voidaan välttää mahdolliset ongelmat (erityisesti odottamattomat virheellisen avaimen virheet) myöhemmin kehitystyön aikana.
Avaa REST API -todennuslaskin Chromessa (tai millä tahansa muulla uudehkolla verkkoselaimella)
Tee laskimesta kopio omaan Google Driveesi File -> Make a copy -valikon kautta (sinun on kirjauduttava Google-tilillesi tätä varten)
Muokkaa API key-, API endpoint-, nonce value- ja input data -kenttiin oma API-avaimesi ja pyyntösi tiedot
Vertaa laskettua API-todennusallekirjoitusta oman API-koodisi laskemaan arvoon (arvojen on vastattava toisiaan täsmälleen)
Turvallisuussyistä suosittelemme käyttämään todennuslaskinta väliaikaisen API-avaimen kanssa ja poistamaan API-avaimen tililtäsi, kun todennusallekirjoituksen toteutuksen on osoitettu toimivan oikein.

Asiakasohjelmakirjastojemme wrapperien tärkein hyöty on, ettei sinun tarvitse käyttää aikaa ja vaivaa API-allekirjoitusten luomiseen alusta alkaen, sillä se on jo tehty puolestasi.
Jos aiot käyttää vain julkisia metodeja, voit halutessasi olla käyttämättä asiakasohjelmakirjastoja, koska todennusta ei tarvita.
Luettelon saatavilla olevista wrappereista löydät täältä.