Frågor och svar om API:et för räntor och valutakurser

Jag har endast en integration mot det gamla SOAP API:et, vad gör jag då?

Du behöver utveckla en ny integration mot det nya REST API:et för att automatiserat fortsatt kunna hämta räntor och valutakurser via API från Riksbanken. SOAP API:et har stängts ner och därmed slutat att fungera från och med den 27 maj 2024. Läs mer: Gamla API:et för räntor och valutakurser har stängts (2024-05-27)

Hur gör jag för att sätta upp en integration mot det nya REST API:et?

Läs mer under frågor och svar på den här sidan. Teknisk dokumentation för utvecklare samt möjlighet till registrering av användare finns vidare i Riksbankens API-portal.

Finns det några begränsningar att anropa det nya API:et?

Vi har en begränsning på antalet anrop från samma ip-adress inom ett visst tidsspann (5 anrop per minut och maximalt 1000 anrop per dygn). Vid större behov finns möjlighet att registrera sig i API-portalen för att hämta ut en personlig API-nyckel som tillåter fler anrop.

Hur registrerar jag mig i API-portalen?

Välj Sign Up uppe till höger och registrera dina uppgifter. När du är inloggad går du till fliken Products och skapar en subscription. Därefter kommer dina API-nycklar synas under fliken Profile som Primary och Secondary key. Det är dina API-nycklar och du kan använda vilken som.

Hur många anrop kan jag göra efter att jag har registrerat mig?

Som registrerad användare i API-portalen kan du anropa vårt API 200 gånger per minut med ett tak på 30 000 anrop per vecka genom att använda den API-nyckel som finns under din profil (endera Primary key eller Secondary key).

Hur använder jag API-nyckeln i anrop?

Du lägger nyckeln i en http header som heter Ocp-Apim-Subscription-Key. Man kan också direkt i ett REST-anrop i webläsaren lägga till ?subscription-key=<dinApiNyckel> efter anropet. Observera att det är olika nycklar för testmiljön (developer.api-test.riksbank.se) och produktionsmiljön (developer.api.riksbank.se). Du måste registrera dig för varje miljö du vill använda.

Hur ska jag använda det nya API:et?

För att på bästa sätt utnyttja API:et kan det vara till hjälp med en kort beskrivning av den terminologi som används. Alla räntor och valutor ligger i serier som är organiserade i grupper. Serien SEKISKPMI (Isländsk valuta) ingår t.ex. i grupp-id 130 som heter ”Valutor mot svenska kronor”. Du kan se vilka serier som finns på denna sida Serier för API:et.

Varje enskild notering kallas för en observation. För att hämta en observation anger man från vilken serie den ska hämtas och ett datum. Det går i API:et att hämta alla grupper och serier som finns. När man vet vilka serier man är intresserad av kan man hämta observationer för dessa inom givna datumintervall. API:et har också stöd för att hämta crosskurser, det vill säga valutakursen mellan två utländska valutor beräknade med hjälp av kurser mot svenska kronan. Du kan också hämta ut aggregerade data (vecka, månad, kvartal, år).

För att t.ex. hämta den senaste kursen för SEKNOKPMI (Norsk krona) anropar man:

https://api.riksbank.se/swea/v1/Observations/Latest/seknokpmi

Det går att hämta de senaste publiceringarna inom ett visst gruppid. T.ex. för att hämta de senast publicerade valutakurserna så anropar man:

https://api.riksbank.se/swea/v1/Observations/Latest/ByGroup/130

För att hämta t.ex. crosskurser mellan USD och EUR från och med ett visst datum använder man:

https://api.riksbank.se/swea/v1/CrossRates/sekusdpmi/sekeurpmi/2024-01-23

Alla serier kan hämtas med:

https://api.riksbank.se/swea/v1/Series

Alla grupper som serierna är grupperade i hämtas med:

https://api.riksbank.se/swea/v1/Groups

Hur får jag ut inverterade kurser?

En observation på t.ex. US dollar visar hur många SEK som krävs för en enhet. Vill du invertera kursen dividerar du 1 med värdet du får ut. Då får du reda på hur 1 SEK förhåller sig till den andra valutan. Du kan också anropa vår hjälpserie SEKETT som hanterar detta åt dig. 

Vilken enhet presenteras valutorna i?

Kursen för alla valutorna anges som 1 svensk krona mot 1 enhet av den utländska valutan från och med 27 november 2023. (Tidigare angavs kursen i svenska kronor mot 100 enheter av den utländska valutan för vissa valutor).

Varför visar min sökning inte noteringar på alla valda serier?

Om någon serie exkluderas i resultatet beror det sannolikt på att den uteslutna seriens giltighetstid ligger utanför vald tidsperiod. Kontrollera seriens giltighetstid. Datumet angivet inom parentes efter serienamnet anger under vilken period det finns noteringar för denna serie.

Hur många decimaler har ränte- och valutanoteringarna?

I de flesta fall publiceras ränte- och valutakursnoteringarna med 5 decimalers precision, enligt principen 1,23456. Antalet decimaler kan dock variera. Det kan vara färre decimaler, om de sista siffrorna är 0 visas de inte. Det kan också visas fler decimaler för vissa valutor med lågt värde. Tal mindre än 1 visas med 1 till 4 värdesiffror, dock högst 6 decimaler, t.ex. 0,000012. 

Måste man ange källa när man sprider statistik om räntor och valutakurser vidare?

Ja, du måste alltid ange att Sveriges riksbank är källan ("Källa: Sveriges riksbank").
Valutakurserna som Riksbanken publicerar från och med 27 november 2023 är fastställda av ECB (Europeiska centralbanken), men omräknade av Riksbanken till kurser mot svenska kronor. Tidigare publicerade Riksbanken valutakurser fastställda av Nasdaq.  

Om man själv har bearbetat statistiken om räntor och valutakurser , ska man ange källa då också?

Nej, i sådana fall får man inte ange Sveriges riksbank som källa.

Får jag använda API:et i kommersiellt syfte?

Riksbankens API är fritt tillgängligt utan avgift och datat får fritt bearbetas och vidareutnyttjas utan att något särskilt medgivande eller avtal krävs. Valutakurserna är dock endast indikativa och publiceras av Riksbanken i informationssyfte. De bör därför inte användas för transaktionsändamål.

Är det något jag inte får göra med API:et?

Du får inte använda API:t för att sprida skadlig kod. Du får inte heller presentera den tjänst som du utvecklat som ett "officiellt samarbete" eller "partnerskap" med Riksbanken.

Hur får jag meddelanden om nya versioner av API:et?

Nya versioner aviseras på Riksbankens webbplats eller i API-portalen.

Frågor?

För mer information om API:et mejla till: API@riksbank.se