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