CurrencyRateAPI

Snabbstartsverktyg

Behöver du testa API:et utan att behöva gräva igenom hela dokumentationen? Gå till kontrollpanelen där du hittar snabbstartsverktyget – ett enkelt sätt att testa alla tillgängliga slutpunkter med ett enda klick.

Klicka på knappen nedan för att registrera dig gratis och börja använda Quick Launch Tool.

Komma igång

Viktiga termer och koncept du behöver för att börja arbeta med Currency Rate API:n:

Definition Beskrivning
Symbol Valutakod med tre bokstäver (t.ex. USD, EUR). Vi stöder ISO 4217 -standardkoder för fiatvalutor och olika koder för kryptovalutor .
Basvaluta Valutan som konverteringen börjar från. Om till exempel 1 USD = X EUR är USD basvalutan. Standardbasvalutan är EUR.
Målvaluta Den valuta som basvalutan konverteras till. Med samma exempel är EUR målvalutan.
Kryptovalutor Förutom traditionella fiatvalutor bearbetar och tillhandahåller vårt API växelkurser för ett brett utbud av populära kryptovalutor.
Bas-URL Rot-URL:en som används för alla API-slutpunkter. Alla förfrågningar skickas till denna bassökväg.

API-svar

Växelkurserna som tillhandahålls av CurrencyRateAPI är som standard i euro. All data returneras i standard JSON-format och kan enkelt analyseras med hjälp av vilket programmeringsspråk som helst.

Exempelsvar:
Nedan hittar du ett exempel på ett API-svar som innehåller en rad vanliga världsvalutor, alla i förhållande till EUR-valutan och med en tidsstämpel då de mottogs.

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Som visas ovan innehåller API-svaret för realtidsväxelkurser flera viktiga fält:

  • success anger om begäran lyckades.
  • base returnerar 3-bokstavskoden för basvalutan som används för denna begäran.
  • date returnerar det faktiska datum för vilket växelkurserna anges (format ÅÅÅÅ-MM-DD).
  • rates innehåller listan över begärda valutor och deras aktuella växelkurser.
  • last_update_unix visar tidsstämpeln (i Unix-format) för den senast tillgängliga informationen i systemet.

Tillgängliga slutpunkter

CurrencyRateAPI innehåller flera API-slutpunkter, som var och en erbjuder specifik funktionalitet. Tillgängligheten av vissa slutpunkter beror på din prenumerationsplan.

  • Slutpunkt för valutalistan. Denna slutpunkt returnerar en fullständig lista över alla valutor som stöds. /api/codes (Alternativ: /api/currencies)
  • Slutpunkt för senaste kurser. Denna slutpunkt returnerar växelkursdata i realtid för alla valutor som stöds. /api/latest
  • Slutpunkt för historiska räntor. Denna slutpunkt returnerar historiska växelkursdata för ett specifikt datum. /api/YYYY-MM-DD (Alternativ: /api/history?date=YYYY-MM-DD). Historiska data finns tillgängliga från och med den 4 januari 1999.

Växelkursmetodik

För att säkerställa datanoggrannhet och konsekvens följer CurrencyRateAPI en strikt metod för att hantera och leverera växelkurser:

  • Medelpris: Som standard returnerar API: mid -kurser. Dessa representerar det aritmetiska medelvärdet mellan marknadens köp- ( bid ) och sälj- ( ask )-priser, eller officiella referenskurser från centralbanker.
  • Slutgiltigt slutförande (EOD): Historiska kurser som tillhandahålls av API är slutgiltiga per dagens slut i UTC (Coordinated Universal Time).
  • Korskursberäkning: För valutapar som inte är direkt tillgängliga från våra källor beräknar systemet automatiskt mycket noggranna korskurser med hjälp av de viktigaste globala valutorna som en brygga (pivot).
  • Smart reservmekanism: Om data för ett begärt datum inte är tillgängliga (t.ex. på grund av marknadsstängningar på helger eller helgdagar) söker systemet automatiskt efter den senaste giltiga kursen inom ett glidande 8-dagarsfönster .
  • Hög precision: För att förhindra avrundningsfel i finansiella beräkningar lagras och bearbetas växelkurser med upp till 18 decimaler .

Slutpunkter

Stödda symboler Slutpunkt

https://currencyrateapi.com/api/codes

Denna slutpunkt returnerar en fullständig lista över alla valutor som stöds. Du kan också använda aliaset /api/currencies.

En läsbar lista över alla valutor som stöds finns också tillgänglig på vår sida om valutor som stöds .

Grundläggande valutor: Som standard returnerar vissa andra slutpunkter (som /latest och /{YYYY-MM-DD}) en begränsad uppsättning större globala valutor för att minimera trafiken. Dessa "grundläggande" valutor är:

USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR

API-svar:

{
    "success": true,
    "currencies": {
        "EUR": {
            "entity": "EUROPEAN UNION",
            "currency": "Euro",
            "alphabetic_code": "EUR",
            "numeric_code": 978,
            "minor_unit": 2,
            "title": "Euro",
            "symbol": "€",
            "data_from": "1999-01-04"
        },
        "BTC": {
            "entity": "CRYPTOCURRENCY",
            "currency": "Bitcoin",
            "alphabetic_code": "BTC",
            "title": "Bitcoin",
            "symbol": "₿",
            "is_crypto": true,
            "data_from": "2024-03-02"
        },
        [...]
    }
}

Svarsobjekt:

Nyckel Beskrivning
success Returnerar true för en lyckad begäran. Om false kommer ett felobjekt att inkluderas i svaret.
currencies Returnerar alla valutor som stöds med detaljerad information om var och en.
entity Land eller region där valutan används, eller "KRYPTOVALUTA" för digitala tillgångar.
currency Valutans fullständiga officiella namn.
alphabetic_code Standardiserad alfabetisk kod med 3 bokstäver (ISO 4217 för fiatvalutor).
numeric_code ISO 4217 numerisk kod om tillämpligt.
minor_unit Antal decimaler som används för valutan.
withdrawal_date Datumet då valutan togs ur omlopp, om tillämpligt.
title Kort visningstitel för valutan.
symbol Grafisk symbol för valutan (t.ex. $, €, ₿).
is_crypto Flagga ( true ) om valutan är en kryptovaluta.
data_from Det tidigaste datumet för vilket växelkursdata finns tillgänglig för denna valuta.

Senaste priser Slutpunkt

https://currencyrateapi.com/api/latest?
    base=USD&
    quote=GBP,JPY,EUR

Begäranparametrar:

Parameter Beskrivning
base [Frivillig] Ange en ISO-valutakod med tre bokstäver för att ställa in basvalutan för konvertering. Standardvärdet är EUR.
quote [Frivillig] Ange en kommaseparerad lista med valutakoder för att begränsa svaret till specifika valutor. (Alternativ: codes)
extended_list [Frivillig] Om värdet är satt till 1 returnerar API:et en fullständig lista över tillgängliga valutor. Som standard returneras endast en minimal lista för att minska trafiken.
precision [Frivillig] Anger antalet decimaler i utdatahastigheterna (0-18). Standardvärdet returnerar full tillgänglig precision utan vetenskaplig notation.

API-svar:

{
    "success": true,
    "base": "usd",
    "date": "2026-01-22",
    "rates": {
        "gbp": "0.74350935478637",
        "jpy": "158.00358051914",
        "eur": "0.8518613169776"
    },
    "last_update_unix": "1769067006"
}

Svarsobjekt:

Nyckel Beskrivning
success Returnerar true för en lyckad begäran. Om false kommer ett felobjekt att inkluderas i svaret.
base Returnerar basvalutans 3-bokstavskoder.
date Returnerar det faktiska datum för vilket växelkurserna anges.
rates Returnerar växelkursdata för de valutor som anges i begäran.
last_update_unix Returnerar en Unix-tidsstämpel som anger när den returnerade informationen senast uppdaterades.

Slutpunkt för historiska räntor

https://currencyrateapi.com/api/2025-08-25?
    base=EUR&
    quote=USD,GBP,CAD

Alternativt format: /api/history?date=2025-08-25...

Begäranparametrar:

Parameter Beskrivning
date [Nödvändig] Det historiska datum för vilket växelkurser begärs. Format: ÅÅÅÅ-MM-DD. Kan anges i URL-sökvägen (t.ex. /api/2025-08-25) eller som en frågeparameter (t.ex. /api/history?date=2025-08-25).
base [Frivillig] Ange en valutakod med tre bokstäver för att ställa in basvalutan för konverteringen. Standardvärdet är EUR.
quote [Frivillig] Ange en kommaseparerad lista med valutakoder för att begränsa svaret till specifika valutor. (Alternativ: codes)
extended_list [Frivillig] Om värdet är satt till 1 returnerar API:et en fullständig lista över tillgängliga valutor. Som standard returneras endast en minimal lista för att minska trafiken.
precision [Frivillig] Anger antalet decimaler i utdatahastigheterna (0-18). Standardvärdet returnerar full tillgänglig precision utan vetenskaplig notation.

API-svar:

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Svarsobjekt:

Nyckel Beskrivning
success Returnerar true för en lyckad begäran. Om false kommer ett felobjekt att inkluderas i svaret.
base Returnerar basvalutans 3-bokstavskoder.
date Returnerar det faktiska datum för vilket växelkurserna anges.
rates Returnerar växelkursdata för valutorna på det datum som anges i begäran.
last_update_unix Returnerar en Unix-tidsstämpel som anger när den returnerade informationen senast uppdaterades.

Exempelkod

PHP (cURL)

// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';

// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Store the data:
$json = curl_exec($ch);
curl_close($ch);

// Decode JSON response:
$exchangeRates = json_decode($json, true);

// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];

JavaScript (hämta)

 // Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';

// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
    .then(response => {
        return response.json();
    })
    .then(json => {

        // Exchange rate data is stored in json.rates
        console.log(json.rates.GBP);

        // Timestamp can be accessed in json.last_update_unix
        console.log(json.last_update_unix);
    })
    .catch(error => {
        console.error('Fetch error:', error);
    });