CurrencyRateAPI

Hurtigstartverktøy

Trenger du å teste API-et uten å måtte grave deg gjennom all dokumentasjonen? Gå til kontrollpanelet, der du finner hurtigstartverktøyet – en enkel måte å teste ut alle tilgjengelige endepunkter med ett enkelt klikk.

Klikk på knappen nedenfor for å registrere deg gratis og begynne å bruke hurtigstartverktøyet.

Komme i gang

Viktige begreper og begreper du trenger for å begynne å jobbe med Currency Rate API:

API-svar

Valutakursene som CurrencyRateAPI oppgir er som standard i euro. Alle data returneres i standard JSON-format og kan enkelt analyseres ved hjelp av et hvilket som helst programmeringsspråk.

Eksempel på svar:
Nedenfor finner du et eksempel på et API-svar som inneholder en rekke vanlige verdensvalutaer, alle i forhold til EUR-valutaen og med et tidsstempel for når de ble mottatt.

{
    "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 inkluderer API-responsen for valutakurser i sanntid flere nøkkelfelt:

• success indikerer om forespørselen var vellykket.
• base returnerer 3-bokstavskoden til basisvalutaen som brukes for denne forespørselen.
• date returnerer den faktiske datoen som valutakursene er oppgitt for (format ÅÅÅÅ-MM-DD).
• rates inneholder listen over forespurte valutaer og deres gjeldende valutakurser.
• last_update_unix viser tidsstempelet (i Unix-format) for de nyeste tilgjengelige dataene i systemet.

Tilgjengelige endepunkter

CurrencyRateAPI inkluderer flere API-endepunkter, som hvert tilbyr spesifikk funksjonalitet. Tilgjengeligheten av bestemte endepunkter avhenger av abonnementet ditt.

• Sluttpunkt for valutalisten. Dette endepunktet returnerer den fullstendige listen over alle støttede valutaer. /api/codes (Alternativ: /api/currencies)
• Sluttpunkt for siste kurser. Dette endepunktet returnerer valutakursdata i sanntid for alle støttede valutaer. /api/latest
• Sluttpunkt for historiske renter. Dette endepunktet returnerer historiske valutakursdata for en bestemt dato. /api/YYYY-MM-DD (Alternativ: /api/history?date=YYYY-MM-DD). Historiske data er tilgjengelige fra 4. januar 1999.

Valutakursmetodikk

For å sikre dataenes nøyaktighet og konsistens følger CurrencyRateAPI en streng metode for å administrere og levere valutakurser:

• Middels markedspriser: Som standard returnerer API-et mid . Disse representerer det aritmetiske gjennomsnittet mellom markedskjøps- ( bid ) og salgs- ( ask ) prisene, eller offisielle referansekurser fra sentralbanker.
• Avslutning av dagen (EOD): Historiske kurser levert av API er endelige per slutten av dagen i UTC (koordinert universell tid).
• Kryssrateberegning: For valutapar som ikke er direkte tilgjengelige fra våre kilder, beregner systemet automatisk svært nøyaktige krysskurser ved å bruke store globale valutaer som en bro (pivot).
• Smart reservemekanisme: Hvis data for en forespurt dato ikke er tilgjengelige (f.eks. på grunn av markedsstengninger i helger eller på helligdager), søker systemet automatisk etter den nyeste gyldige kursen innenfor et glidende 8-dagers vindu .
• Høy presisjon: For å forhindre avrundingsfeil i økonomiske beregninger lagres og behandles valutakurser med opptil 18 desimaler .

Endepunkter

Støttede symboler Endepunkt

https://currencyrateapi.com/api/codes

Dette endepunktet returnerer den fullstendige listen over alle støttede valutaer. Du kan også bruke aliaset /api/currencies.

En lesbar liste over alle støttede valutaer er også tilgjengelig på siden vår om støttede valutaer .

Grunnleggende valutaer: Som standard returnerer noen andre endepunkter (som /latest og /{YYYY-MM-DD}) et begrenset sett med store globale valutaer for å minimere trafikk. Disse «grunnleggende» valutaene 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"
        },
        [...]
    }
}

Responsobjekter:

Siste priser Endepunkt

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

Forespørselsparametere:

API-svar:

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

Responsobjekter:

Endepunkt for historiske renter

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

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

Forespørselsparametere:

API-svar:

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

Responsobjekter:

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

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