All
Filtrer efter:
Hvordan indbetaler jeg kontanter på min konto?
Jeg har brug for hjælp til kontoverificering
Hvorfor kan jeg ikke få adgang til min konto?
Er der gebyrer for kryptoudbetaling?
Jeg har brug for hjælp til at logge ind på min konto
WebSocket API v1 - placering og annullering af ordrer
Sidst opdateret: 1. april 2025
Vores WebSocket API v1 understøtter handel via addOrder- og cancelOrder-endepunkterne. addOrder-endepunktet bruges til at placere nye ordrer, og cancelOrder-endepunktet bruges til at annullere eksisterende (åbne) ordrer.
Både addOrder og cancelOrder er private endepunkter, hvilket betyder, at de kun kan tilgås via en autentificeret WebSocket-forbindelse.
En indledende forbindelse skal oprettes til den autentificerede WebSocket-URL wss://ws-auth.kraken.com/, som derefter kan holdes åben på ubestemt tid, mens ordrer placeres og annulleres. En enkelt WebSocket-forbindelse er designet til at understøtte flere anmodninger, så det er ikke nødvendigt (eller anbefalet) at oprette/afbryde forbindelse for hvert kald til handelsendepunkterne.
WebSocket-autentificering
En WebSocket-autentificeringstoken kan hentes via REST API GetWebSocketsToken-endepunktet.
Når en token er hentet, kan der oprettes forbindelse til den private WebSocket-URL wss://ws-auth.kraken.com/, og addOrder- og cancelOrder-endepunkterne kan derefter bruges på ubestemt tid (tokenet udløber ikke, så længe det bruges til at placere og annullere ordrer).
Bemærk, at den API-nøgle, der bruges til at hente tokenet, skal have både Modify Orders- og Cancel/Close Orders-tilladelser, ellers vil en 'permission denied'-fejl blive modtaget fra WebSocket API'en.
Placering af en ordre
Når en autentificeret WebSocket-forbindelse er etableret, kan en ordre placeres ved at sende en meddelelse som den følgende:
- •
{"event":"addOrder", "token":"nT9n23/7oLdq+bNHNMNJ4VvF1hiHhjTnPOaCMiB1GJ0", "pair":"XBT/USD", "type":"buy", "ordertype":"limit", "price":"9857", "volume":"0.002", "leverage":"5", "userref":"8874657"}
Der vil derefter blive modtaget et svar, der angiver status for anmodningen (om ordren blev accepteret eller afvist). For en ordre, der blev accepteret og placeret med succes, vil svaret angive en status som 'ok' og være lignende det følgende:
- •
{"descr":"buy 0.00200000 XBTUSD @ limit 9857.0 with 5:1 leverage","event":"addOrderStatus","status":"ok","txid":"OPOUJF-BWKCL-FG5DQL"}
For en ordre, der blev afvist og ikke placeret, vil svaret angive en status som 'error' sammen med en fejlmeddelelse, der angiver årsagen til afvisningen (ugyldige argumenter, utilstrækkelige midler osv.), såsom følgende afvisning for en ordre, der ikke opfyldte den mindste ordrestørrelse:
- •
{"errorMessage":"EOrder:Order minimum not met","event":"addOrderStatus","status":"error"}
Annullering af en ordre
Når en autentificeret WebSocket-forbindelse er etableret (eller helst en eksisterende forbindelse genbruges), kan en ordre annulleres ved at sende en meddelelse som den følgende:
- •
{"event":"cancelOrder", "token":"s74Ajl83it0dNNKcF072NJ5wDmLTGIceaCbV96eWbFg", "txid":["OJZ3DI-IU6QC-ME7TVE"]}
Der vil derefter blive modtaget et svar, der angiver status for anmodningen (om annulleringen blev accepteret eller afvist). For en ordre, der blev annulleret med succes, vil svaret angive en status som 'ok' og være lignende det følgende:
- •
{"event":"cancelOrderStatus","status":"ok"}
For en annulleringsanmodning, der blev afvist, vil svaret angive en status som 'error' sammen med en fejlmeddelelse, der angiver årsagen til afvisningen (ugyldigt ordre-ID osv.), såsom følgende afvisning for en anmodning om at annullere en ordre, der allerede var annulleret:
- •
{"errorMessage":"EOrder:Unknown order","event":"cancelOrderStatus","status":"error"}
Bemærk, at i modsætning til REST API CancelOrder-endepunktet er det muligt at angive flere ordre-ID'er i en enkelt WebSocket-annulleringsmeddelelse. De ordre-ID'er, der skal annulleres, skal inkluderes som separate poster i txid-arrayet, som følger:
- •
{"event":"cancelOrder", "token":"c4JjTNHSurKmWDsnrGaCxIuCOa4FurCZK2ppktvT2Yo", "txid":["OLVCRZ-DNKJI-VRTZKY","O67X6E-PBGSR-GU23R5","OECCDC-T2R4V-52CR7T"]}