Kraken WebSocket API - Ofte stilte spørsmål

Har Kraken en WebSocket API? Hvordan kan jeg koble til den?

Kraken har både en REST API og en WebSocket API. Vår WebSocket API er tilgjengelig på følgende sikre URL-er:

Offentlige (uautentiserte) markedsdatafeeds: wss://ws.kraken.com/

Private (autentiserte) kontodatafeeds og handelssluttpunkter: wss://ws-auth.kraken.com/

Autentisering er ikke nødvendig for å koble til de offentlige markedsdatafeeds, men en gyldig autentiseringstoken kreves for de private feeds.

Alle meldinger som sendes og mottas via WebSocket API er ren tekst kodet i JSON-format. Detaljene for hver meldingstype er gitt i vår WebSocket API-dokumentasjon.

Har dere WebSocket-biblioteker tilgjengelig?

Vi har en rekke WebSocket API-eksempelkode tilgjengelig, som enten kan brukes direkte, eller som et utgangspunkt for din egen implementasjon:

Vår WebSocket API kan implementeres i hvilket som helst programmeringsspråk du foretrekker, og vårt API-støtteteam hjelper deg gjerne eller gir eksempelkode på flere språk om nødvendig.

Hvilke feeds/endepunkter støttes?

Vår WebSocket API tilbyr en rekke sanntids markedsdatafeeds, kontodatafeeds og handelssluttpunkter. En komplett liste over tilgjengelige feeds/endepunkter, sammen med implementeringsdetaljene for hver feed/endepunkt, finner du i vår WebSocket API-dokumentasjon.

Hvordan vet jeg at jeg er tilkoblet? Hvordan vet jeg at jeg fortsatt er tilkoblet?

Når du abonnerer på en feed, vil en {u'event': u'heartbeat'}-melding mottas med en frekvens på 1 heartbeat per sekund.

Heartbeats vil ikke mottas hvis andre meldinger (markedsdata, kontodata osv.) mottas i stedet. Når og hvorfor markeds- eller kontodata mottas, avhenger av feeden du abonnerer på.

Hvis du abonnerer på feeden til et valutapar med lavt handelsvolum, kan du bare motta heartbeats i lange perioder.

Hvis du avslutter abonnementet på en feed, vil du ikke lenger motta heartbeats eller handelsdata, og etter å ha vært uabonnert på en feed i 1 minutt, vil du bli koblet fra WebSockets-feeden.

Når og hvorfor sender WebSocket oppdaterte data?

Når og hvorfor markedsdata eller kontodata mottas, avhenger av feeden du abonnerer på. For eksempel:

Ticker: Når det er en handel eller et parti handler for et valutapar, publiseres en ticker-melding for det paret. Du vil bare motta denne meldingen hvis du abonnerer på ticker-feeden for dette paret.

Trade: På samme måte, når det er en handel eller et parti handler for et valutapar, publiseres også en trade-melding for det paret. Du vil bare motta denne meldingen hvis du abonnerer på trade-feeden for dette paret.

OHLC: Et oppdatert OHLC-intervall publiseres for hvert intervall når en handel eller et parti handler for et valutapar utføres. Du vil bare motta oppdateringer for intervallene du abonnerer på. Etter å ha krysset en intervallgrense, sendes ingen melding før neste handel finner sted.

Book: Et innledende øyeblikksbilde av ordreboken med den valgte dybden publiseres når du først abonnerer på book-feeden.

Etter hvert som nye ordrer legges til ordreboken eller handler utføres som påvirker ordrebokdybden du abonnerer på, publiseres en melding som inneholder ordrebokoppdateringer for alle berørte prisnivåer og volumer. Disse oppdateringene kan inneholde bare bud, bare spørsmål, eller både bud og spørsmål. Se Hvordan bygge en ordrebok nedenfor for detaljer.

Spread: Når et nytt høyeste bud eller laveste spørsmålsordre plasseres, eller en handel utføres som endrer den beste bud- eller beste spørsmålsprisen, publiseres en spread-melding med de oppdaterte bud- og spørsmålsprisene.

Gir WebSocket-feeds historiske data eller bare nåværende data?

WebSocket markedsdatafeeds gir bare nåværende data, men det er mulig å samtidig koble til WebSocket API for nåværende data og REST API for historiske data.

Bruk av reqid-parameteren.

Abonnementsforespørsler kan inkludere en klientlevert reqid-parameter som deretter kan brukes til å matche den ønskede WebSocket-abonnementsforespørselen med kanal-ID-en for det abonnementet.

Merk at hvis du foretar flere WebSocket-abonnementer samtidig, vil de alle bli tildelt samme reqid-verdi. For å tildele en annen reqid-verdi, må hver feed abonneres på individuelt.

Jeg ønsker flere detaljer, hvor finner jeg dem?

Den komplette WebSocket API-spesifikasjonen er tilgjengelig i WebSocket API-dokumentasjonen.

Forskjeller mellom valutaparsymboler i REST og WebSocket API-er.

WebSocket API aksepterer bare valutaparsymboler i ISO 4217-A3-formatet, for eksempel XBT/USD.

REST API AssetPairs-endepunktet kan brukes til å oversette symboler mellom REST API-versjonene (som XBTUSD eller XXBTZUSD) og WebSocket API-versjonen (som XBT/USD).

https://api.kraken.com/0/public/AssetPairs

wsname-feltet gir WebSocket API-symbolet.

Hvordan bygge en ordrebok

WebSocket API book-feeden er den mest komplekse av alle WebSocket-feeds, men så lenge book-feed-meldingene tolkes riktig, er det mulig å opprettholde en lokal kopi av en ordrebok med bare noen få kodelinjer.

Våre WebSocket API-støttesider gir detaljerte instruksjoner for tolkning av book-feed-meldingene, sammen med et eksempel på book-feed-transkripsjon, og eksempelkode (i Python) for å opprettholde en gyldig lokal kopi av en ordrebok.

Hva er tilkoblingsgrensene for WebSocket API?

WebSocket API begrenser maksimalt antall samtidige tilkoblinger for å gi beskyttelse mot misbruk (som for eksempel DDoS-angrep). Hvis din WebSocket-klient foretar for mange tilkoblinger samtidig, vil følgende feilmelding mottas:

{“error”: {“message”: “You have reached maximum capacity for WebSocket connections. Please reach out to Kraken support team for any questions.“, “hint”: “Your code may be reconnecting too often or when it has no need to.“, “name”: “WebSocket connection rate error”}}

WebSocket API tillater flere feed-abonnementer via en enkelt WebSocket-tilkobling (som å abonnere på alle tilgjengelige markedsdata for valutaparet XBT/USD via en enkelt tilkobling), så det er mulig å strømme alle tilgjengelige markedsdata for alle valutapar uten å nå tilkoblingsgrensene for WebSocket.

Hva er rate-grensene for WebSocket API?

De samme rate-grensene for handel gjelder på tvers av alle grensesnitt for ordreinnlegging (nettsted, Kraken Terminal, REST og WebSocket API-er), og er forklart i detalj på vår støtteside for rate-grenser.

Meldingsrate-grensen for en enkelt WebSocket API-tilkobling vil variere avhengig av systembelastningen. WebSocket API-klienter vil motta feilmeldingen {"Error": "Exceeded msg rate"} når meldingsrate-grensen overskrides.

Handel (plassering/kansellering av ordrer) via WebSocket API.

Handel via WebSocket API er tilgjengelig via addOrder- og cancelOrder-endepunktene, som brukes til å plassere nye ordrer og kansellere eksisterende (åpne) ordrer henholdsvis.

WebSocket-handelsendepunktene er tilgjengelige via den samme private WebSocket-tilkoblingen (wss://ws-auth.kraken.com/) som de private kontoadministrasjonsfeeds (openOrders og ownTrades).

Fullstendige detaljer angående handelsendepunktene er tilgjengelige via WebSocket API-dokumentasjonen, og våre WebSocket API-støttesider gir ytterligere informasjon og eksempler for bruk av handelsendepunktene i din egen kode.

Hvorfor mottar jeg en 403-feil når jeg kobler til WebSocket API?

WebSocket API-tilkoblinger formidles via Cloudflare, og derfor kan eventuelle sikkerhetsinnstillinger implementert av Cloudflare påvirke tilkoblinger til både de offentlige (wss://ws.kraken.com) og private (wss://ws-auth.kraken.com) URL-ene.

Cloudflare krever at Server Name Indication (SNI) brukes for alle TLS-tilkoblinger, ellers vil WebSocket-tilkoblingen mislykkes, og en HTTP 403 Forbidden-feil vil returneres i stedet. Cloudflares støttesider gir ytterligere detaljer angående deres TLS SNI-krav.

Vårt offisielle Python WebSocket API-bibliotek er oppdatert for å støtte TLS SNI, men noen tredjeparts WebSocket API-biblioteker kan fortsatt være berørt. Ta kontakt med vårt API-støtteteam hvis du trenger hjelp til å oppdatere din WebSocket API-kode for å støtte TLS SNI.

WebSocket API-assistanse.

Ta kontakt med vårt API-støtteteam hvis du trenger hjelp til å implementere din WebSocket API-klient.