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