Edistynyt API UKK

Viimeksi päivitetty: 25.11.2025

Mahdolliset tilan arvot talletus-/nostotapahtumille

Käyttämällä REST-rajapinnan rahoituksen päätepisteitä asiakkaat voivat tallettaa/nostaa varoja Kraken-tililleen ja sieltä pois sekä pyytää talletus-/nostotapahtuman reaaliaikaista tilaa.

Talletukset/nostot käyvät läpi useita vaiheita alkuperäisen pyynnön ja tapahtuman valmistumisen välillä, joten rahoituksen päätepisteet palauttavat eri tilan arvon riippuen siitä, milloin niitä kutsutaan.

Huomaa, että tilan arvot ovat peräisin alun perin Internet Financial Exchange Protocol (IFEX) -asiakirjan sivuilta 16/17, mutta arvoja on muutettu hieman kryptotapahtumiin sopivammiksi (kaikkia mahdollisia tilan arvoja ei esimerkiksi käytetä).

Talletukset

Talletustapahtumien mahdolliset tilan arvot ovat seuraavat:

•
Settled = Talletus on vastaanotettu, mutta se vaatii vielä lisävahvistuksia lohkoketjussa.
•
Success = Talletus on saavuttanut vaaditun määrän vahvistuksia lohkoketjussa.
•
Failure = Talletus epäonnistui (yhdestä tai useammasta eri syystä).

Seuraavassa on joitakin esimerkkejä siitä, miltä yllä olevat tilan arvot näyttäisivät DepositStatus-päätepisteen vastauksissa:

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

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

Nostot

Nostotapahtumien mahdolliset tilan arvot ovat seuraavat:

•
Initial = Nostopyyntö on vastaanotettu ja sen kelvollisuus tarkistetaan (mahdolliset tilin rahoitusrajoitukset jne.).
•
Pending = Nostoa odotetaan käsiteltäväksi rahoitusväylässämme.
•
Settled = Nosto on lähetetty lohkoketjuun (tässä vaiheessa lohkoketjun tapahtumatunnus tulee saataville).
•
Success = Nostotapahtumalla on vähintään 1 vahvistus lohkoketjussa.
•
On hold = Nosto on asetettu pitoon, ja rahoitustiimimme on tarkistettava se manuaalisesti.
•
Failure = Nosto epäonnistui (yhdestä tai useammasta eri syystä).

Seuraavassa on joitakin esimerkkejä siitä, miltä yllä olevat tilan arvot näyttäisivät WithdrawStatus-päätepisteen vastauksissa:

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

Pending-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":"Pending"}]}

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

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

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

Lisätietoja talletuksista/nostoista on saatavilla käteistalletuksia ja kryptotalletuksia koskevilta tukisivuiltamme.

Miten noutaa historialliset aika- ja myyntitiedot (kaupankäyntihistoria) käyttämällä REST API Trades -päätepistettä

REST-rajapinnan OHLC-päätepiste tarjoaa vain rajoitetun määrän historiallista dataa, tarkalleen ottaen 720 datapistettä pyydetyltä aikaväliltä. Esimerkiksi OHLC-datan pyytäminen 1 minuutin välein palauttaa viimeisimmät 720 minuuttia (12 tuntia) dataa.

Sovelluksille, jotka vaativat ylimääräistä OHLC- tai tick-dataa, on mahdollista hakea markkinoidemme koko kaupankäyntihistoria (historiallinen aika ja myynti) REST-rajapinnan Trades-päätepisteen kautta. Minkä tahansa ajanjakson ja minkä tahansa aikavälin OHLC voidaan sitten luoda historiallisesta aika- ja myyntidatasta.

Trades-päätepiste ottaa valinnaisen parametrin nimeltä since, joka määrittää datan alkamisajankohdan. since-arvo on UNIX-aikaleima nanosekunnin tarkkuudella (standardi UNIX-aikaleima sekunteina ja 9 lisänumeroa).

Esimerkiksi kutsu Trades-päätepisteeseen, kuten https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000, palauttaisi XBT/USD:n historiallisen ajan ja myynnin 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"}}

Seuraavien Trades-päätepisteen kutsujen tulisi korvata since-parametrin arvo edellisen kutsun tulosten last-parametrin arvolla, kuten https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Käyttämällä erityistä since-arvoa 0 (nolla) palautettaisiin historiallinen aika ja myynti markkinoiden alusta alkaen (alkaen aivan ensimmäisestä kaupasta).

Miten tehdä, tarkastella ja peruuttaa toimeksiantoja käyttämällä käyttäjäviitettä

Käyttäjäviite on asiakkaan antama toimeksiantotunnus, jota voidaan käyttää varsinaisen (API:n tarjoaman) toimeksiantotunnuksen sijasta joissakin toimeksiantojen hallintatehtävissä (erityisesti toimeksiantojen peruuttamisessa).

Käyttäjäviitteet on toteutettu mahdollisimman joustaviksi, ja niitä voidaan siksi käyttää monilla eri tavoilla, mukaan lukien:

•
yksilöllisenä tunnuksena (jolloin jokaisella toimeksiannolla on eri käyttäjäviite),
•
liittyvien toimeksiantojen ryhmittelemiseen (kuten eri vipuvaikutustasoilla olevien toimeksiantojen ryhmittelyyn),
•
tai varatunnuksena siinä tapauksessa, että varsinaista toimeksiantotunnusta ei tiedetä.

Käyttäjäviitteen on oltava numeerinen arvo välillä 1 ja 2 147 483 647 (periaatteessa mikä tahansa positiivinen 32-bittinen luku), ja se voitaisiin siksi toteuttaa yksinkertaisena laskurina, satunnaisena etumerkillisenä 32-bittisenä arvona tai jopa aikaleimana sekunneissa (vaikka tämä epäonnistuisi 19. tammikuuta 2038 klo 3:14:07 UTC jälkeen).

Toimeksiantojen tekeminen käyttäjäviitteellä

Toimeksiantoja voidaan tehdä liitetyllä käyttäjäviitteellä kutsumalla AddOrder-päätepistettä ja sisällyttämällä userref-parametri, jonka arvona on 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"]}}

Käyttäjäviitteen sisältävien toimeksiantojen tarkastelu

Toimeksiantoja, joihin on jo liitetty käyttäjäviite, voidaan tarkastella kutsumalla Open/Closed/QueryOrders-päätepisteitä ja sisällyttämällä userref-parametri, jonka arvona on olemassa oleva käyttäjäviite (tässä tapauksessa käyttäjäviite toimii suodattimena, joka 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}}

Käyttäjäviitteen sisältävien toimeksiantojen peruuttaminen

Toimeksiannot, joihin on jo liitetty käyttäjäviite, voidaan peruuttaa käyttämällä käyttäjäviitettä kutsumalla CancelOrder-päätepistettä ja käyttämällä käyttäjäviitettä txid-arvona (toimeksiantotunnuksen sijasta):

$ ./krakenapi CancelOrder txid=16764529

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

Huomaa, että kaikki avoimet toimeksiannot, joilla on sama käyttäjäviite, peruutetaan, joten on mahdollista tehdä yksi CancelOrder-kutsu useiden toimeksiantojen peruuttamiseksi samanaikaisesti (kuten seuraavan vastauksen count-arvo 3 osoittaa):

$ ./krakenapi CancelOrder txid=48695624

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

Miksi saan 403-virheen käyttäessäni Kraken API:a?

Tämä ongelma saattaa liittyä Cloudflareen:

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

HUOMAA: Krakenilla on "Browser Integrity Check" käytössä.

Tämä voi tapahtua, jos pyyntösi sisältää epäilyttäviä otsikoita. Esimerkiksi pyynnöstäsi saattaa puuttua user agent tai se käyttää epätavallista user agentia; tarkista siis pyyntösi otsikot.

Jos et pysty luomaan mitään järjestelmämme sallimia vakiopyyntöjä, lähetä meille täydellinen kopio yrittämistäsi pyynnöistä, mukaan lukien IP-osoitteesi ja kaikki otsikot. Näiden tietojen avulla voimme tutkia asiaa tarkemmin.

Tarjoaako Kraken API-testiympäristön?

Futures API

Futures REST- ja WebSocket-rajapintoja (futures.kraken.com) varten tarjoamme täyden testiympäristön, joka käyttää API-URL-osoitetta demo-futures.kraken.com.

REST-, WebSocket- ja FIX-testiympäristöt

Tarjoamme tällä hetkellä testiympäristön päteville asiakkaille spot REST/WebSocket- ja FIX-rajapintoihimme. Pääsy tähän ympäristöön edellyttää käyttöönottoprosessia, joka voidaan aloittaa ottamalla suoraan yhteyttä API-tiimiin.

API:n testaaminen Validate-testausparametrilla

Kun teet toimeksiannon REST API AddOrder- tai WebSocket API addOrder -päätepisteiden kautta, validate-syöteparametria voidaan käyttää toimeksiannon simulointiin.

AddOrder/addOrder-kutsu, jossa validate-parametri on asetettu todeksi (validate=1, validate=true, validate=anything jne.), tarkistaa toimeksiantotiedot virheiden varalta, mutta API-vastaus ei koskaan sisällä toimeksiantotunnusta (order ID), joka palautettaisiin aina onnistuneesta toimeksiannosta ilman validate-parametria.

Esimerkki AddOrder-kutsusta validate-parametrilla (huomaa puuttuva toimeksiantotunnus):

Bash

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

Pienet todelliset toimeksiannot ja/tai toimeksiannot poikkeuksellisilla hinnoilla

Kattavaa API-testiä varten Validate-parametrilla suosittelemme tekemään erittäin pieniä markkinatoimeksiantoja (vähimmäistoimeksiantokoon mukaisia toimeksiantoja) tai rajahintatoimeksiantoja, joiden hinta on kaukana nykyisestä markkinahinnasta (esimerkiksi ETH/USD-myyntitoimeksianto hintaan 800 $, kun markkinahinta on 200 $).

Testaus live-toimeksiannoilla antaa API-koodisi olla vuorovaikutuksessa rajapintamme kanssa todellisissa olosuhteissa, jolloin testin jokainen osa-alue on tarkka (miten toimeksiantosi vaikuttavat toimeksiantokirjaan jne.).

TLS-päivitys, joka saattaa vaikuttaa API-yhteyksiisi

Tietoturvasyistä olemme hiljattain lopettaneet tuen TLS 1.0- ja 1.1-versioille. Jos kohtaat SSL/TLS-yhteysvirheilmoituksia yrittäessäsi muodostaa yhteyttä rajapintaamme, se johtuu todennäköisesti jonkin näistä vanhentuneista standardeista käytöstä. Sinun on muokattava API-asiakasohjelmaasi pakottamaan TLS 1.2/1.3 -käyttö tai päivitettävä .NET-versiosi versioon 4.6 tai uudempaan, joka käyttää TLS 1.2/1.3 -standardia.

REST API -todennuslaskuri (Google Sheet)

Seuraavaa Google Sheets -taulukkoa voidaan käyttää REST API -todennusallekirjoituksen laskemiseen mille tahansa syötetietojen yhdistelmälle:

•
API:n yksityinen (salainen) avain
•
API-päätepiste (Balance, TradeBalance, QueryOrders jne.)
•
Nonce-arvo (katso lisätietoja tukisivultamme mikä on nonce)
•
Päätepisteen syöteparametrit (esimerkiksi asset=doge)

Laskinta voidaan käyttää varmistamaan, että todennusalgoritmi on toteutettu oikein, jolloin vältetään mahdolliset ongelmat (erityisesti odottamattomat invalid key -virheet) myöhemmin kehityssyklin aikana.

Käyttöohjeet

1
Avaa REST API -todennuslaskin Chromessa (tai missä tahansa muussa nykyaikaisessa verkkoselaimessa)
2
Tee laskimesta kopio omaan Google Driveesi Tiedosto -> Tee kopio -valikon kautta (sinun on kirjauduttava sisään Google-tilillesi tätä vaihetta varten)
3
Muokkaa kenttiä API key, API endpoint, nonce value ja input data omalla API-avaimellasi ja pyynnön tiedoilla
4
Vertaa laskettua API-todennusallekirjoitusta oman API-koodisi laskemaan arvoon (näiden kahden arvon on vastattava toisiaan täsmälleen)

Turvallisuussyistä suosittelemme käyttämään todennuslaskuria tilapäisellä API-avaimella ja poistamaan API-avaimen tililtäsi, kun todennusallekirjoituksen toteutus on todettu oikeaksi.

Esimerkki

Täytyykö minun käyttää asiakaskirjastoa?

Asiakaskirjastojen (client library wrappers) käytön ensisijainen etu on se, ettei sinun tarvitse käyttää aikaa tai vaivaa pyörän keksimiseen uudelleen API-allekirjoitusten luomiseksi; se on jo tehty puolestasi.

Jos aiot tehdä kutsuja vain julkisiin metodeihin, voit jättää asiakaskirjastot käyttämättä, sillä todennusta ei tarvita.

Luettelo saatavilla olevista kääreistä löytyy täältä.