CurrencyRateAPI

Hurtigstartværktøj

Har du brug for at teste API'en uden at skulle grave dig igennem hele dokumentationen? Gå til Kontrolpanel, hvor du finder Hurtigstartværktøjet – en nem måde at afprøve alle tilgængelige slutpunkter med et enkelt klik.

Klik på knappen nedenfor for at registrere dig gratis og begynde at bruge Quick Launch Tool.

Kom godt i gang

Nøgleord og -begreber, du skal bruge for at begynde at arbejde med Currency Rate API:

Definition Beskrivelse
Symbol Valutakode på tre bogstaver (f.eks. USD, EUR). Vi understøtter ISO 4217 -standardkoder for fiat-valutaer og forskellige koder for kryptovalutaer .
Basisvaluta Den valuta, som konverteringen starter fra. Hvis f.eks. 1 USD = X EUR, er USD basisvalutaen. Standardbasisvalutaen er EUR.
Målvaluta Den valuta, som basisvalutaen omregnes til. I samme eksempel er EUR målvalutaen.
Kryptovalutaer Ud over traditionelle fiat-valutaer behandler og leverer vores API valutakurser for en bred vifte af populære kryptovalutaer.
Basis-URL Rod-URL'en, der bruges til alle API-slutpunkter. Alle anmodninger sendes til denne basissti.

API-svar

Valutakurserne angivet af CurrencyRateAPI er som standard i euro. Alle data returneres i standard JSON-format og kan nemt parses ved hjælp af ethvert programmeringssprog.

Eksempel på svar:
Nedenfor finder du et eksempel på et API-svar, der indeholder en række almindelige verdensvalutaer, alle i forhold til EUR-valutaen og med et tidsstempel, hvor de blev modtaget.

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

Som vist ovenfor indeholder API-svaret for realtidsvalutakurser flere nøglefelter:

  • success angiver, om anmodningen var vellykket.
  • base returnerer den 3-bogstavskode for den basisvaluta, der bruges til denne anmodning.
  • date returnerer den faktiske dato, for hvilken valutakurserne er angivet (format ÅÅÅÅ-MM-DD).
  • rates indeholder listen over ønskede valutaer og deres aktuelle valutakurser.
  • last_update_unix viser tidsstemplet (i Unix-format) for de senest tilgængelige data i systemet.

Tilgængelige slutpunkter

CurrencyRateAPI indeholder adskillige API-slutpunkter, der hver især tilbyder specifik funktionalitet. Tilgængeligheden af bestemte slutpunkter afhænger af dit abonnement.

  • Slutpunkt for valutalisten. Dette slutpunkt returnerer den fulde liste over alle understøttede valutaer. /api/codes (Alternativ: /api/currencies)
  • Slutpunkt for de seneste satser. Dette slutpunkt returnerer valutakursdata i realtid for alle understøttede valutaer. /api/latest
  • Slutpunkt for historiske renter. Dette slutpunkt returnerer historiske valutakursdata for en bestemt dato. /api/YYYY-MM-DD (Alternativ: /api/history?date=YYYY-MM-DD). Historiske data er tilgængelige fra 4. januar 1999.

Valutakursmetodik

For at sikre dataenes nøjagtighed og konsistens følger CurrencyRateAPI en streng metode til styring og levering af valutakurser:

  • Mellemmarkedspriser: Som standard returnerer API'en mid -kurser. Disse repræsenterer det aritmetiske gennemsnit mellem markedskøbs- ( bid ) og salgs- ( ask )-priserne eller officielle referencekurser fra centralbanker.
  • Afslutning af dagen (EOD): Historiske kurser leveret af API'en er endeligt fastsat pr. dagens udgang i UTC (Coordinated Universal Time).
  • Krydskursberegning: For valutapar, der ikke er direkte tilgængelige fra vores kilder, beregner systemet automatisk meget præcise krydskurser ved hjælp af de største globale valutaer som en bro (pivot).
  • Smart reservemekanisme: Hvis data for en ønsket dato ikke er tilgængelige (f.eks. på grund af markedslukninger i weekender eller på helligdage), søger systemet automatisk efter den seneste gyldige kurs inden for et glidende vindue på 8 dage .
  • Høj præcision: For at forhindre afrundingsfejl i økonomiske beregninger gemmes og behandles valutakurser med op til 18 decimaler .

Endepunkter

Understøttede symboler Slutpunkt

https://currencyrateapi.com/api/codes

Dette slutpunkt returnerer den fulde liste over alle understøttede valutaer. Du kan også bruge aliasset /api/currencies.

En læsbar liste over alle understøttede valutaer er også tilgængelig på vores side Understøttede valutaer .

Grundlæggende valutaer: Som standard returnerer nogle andre slutpunkter (som /latest og /{YYYY-MM-DD}) et begrænset sæt af større globale valutaer for at minimere trafikken. Disse "grundlæggende" valutaer er:

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"
        },
        [...]
    }
}

Svarobjekter:

Nøgle Beskrivelse
success Returnerer true for en vellykket anmodning. Hvis false, vil et fejlobjekt blive inkluderet i svaret.
currencies Returnerer alle understøttede valutaer med detaljerede oplysninger om hver enkelt.
entity Land eller region, hvor valutaen bruges, eller "KRYPTOVALUTA" for digitale aktiver.
currency Valutaens fulde officielle navn.
alphabetic_code Standard alfabetisk kode på 3 bogstaver (ISO 4217 for fiat-valutaer).
numeric_code ISO 4217 numerisk kode, hvis relevant.
minor_unit Antal decimaler brugt til valutaen.
withdrawal_date Datoen, hvor valutaen blev taget ud af omløb, hvis relevant.
title Kort visningstitel for valutaen.
symbol Grafisk symbol for valutaen (f.eks. $, €, ₿).
is_crypto Marker ( true ), hvis valutaen er en kryptovaluta.
data_from Den tidligste dato, hvor valutakursdata er tilgængelige for denne valuta.

Seneste priser Slutpunkt

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

Anmodningsparametre:

Parameter Beskrivelse
base [Valgfri] Indtast en ISO-valutakode på 3 bogstaver for at indstille basisvalutaen for omregning. Standardværdien er EUR.
quote [Valgfri] Indtast en kommasepareret liste over valutakoder for at begrænse svaret til specifikke valutaer. (Alternativ: codes)
extended_list [Valgfri] Hvis den er indstillet til 1, returnerer API'en den fulde liste over tilgængelige valutaer. Som standard returneres kun en minimal liste for at reducere trafikken.
precision [Valgfri] Angiver antallet af decimaler i outputhastighederne (0-18). Standardværdien returnerer fuld tilgængelig præcision uden videnskabelig 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"
}

Svarobjekter:

Nøgle Beskrivelse
success Returnerer true for en vellykket anmodning. Hvis false, vil et fejlobjekt blive inkluderet i svaret.
base Returnerer 3-bogstavskoden for basisvalutaen.
date Returnerer den faktiske dato, som valutakurserne er angivet for.
rates Returnerer valutakursdata for de valutaer, der er angivet i anmodningen.
last_update_unix Returnerer et Unix-tidsstempel, der angiver, hvornår de returnerede data sidst blev opdateret.

Slutpunkt for historiske satser

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

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

Anmodningsparametre:

Parameter Beskrivelse
date [Påkrævet] Den historiske dato, som der anmodes om valutakurser for. Format: ÅÅÅÅ-MM-DD. Kan angives i URL-stien (f.eks. /api/2025-08-25) eller som en forespørgselsparameter (f.eks. /api/history?date=2025-08-25).
base [Valgfri] Indtast en valutakode på 3 bogstaver for at indstille basisvalutaen for omregningen. Standardværdien er EUR.
quote [Valgfri] Indtast en kommasepareret liste over valutakoder for at begrænse svaret til specifikke valutaer. (Alternativ: codes)
extended_list [Valgfri] Hvis den er indstillet til 1, returnerer API'en den fulde liste over tilgængelige valutaer. Som standard returneres kun en minimal liste for at reducere trafikken.
precision [Valgfri] Angiver antallet af decimaler i outputhastighederne (0-18). Standardværdien returnerer fuld tilgængelig præcision uden videnskabelig 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"
}

Svarobjekter:

Nøgle Beskrivelse
success Returnerer true for en vellykket anmodning. Hvis false, vil et fejlobjekt blive inkluderet i svaret.
base Returnerer 3-bogstavskoden for basisvalutaen.
date Returnerer den faktiske dato, som valutakurserne er angivet for.
rates Returnerer valutakursdata for valutaerne på den dato, der er angivet i anmodningen.
last_update_unix Returnerer et Unix-tidsstempel, der angiver, hvornår de returnerede data sidst blev opdateret.

Eksempelkode

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 (hentning)

 // 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);
    });