CurrencyRateAPI

Snelstarttool

Wil je de API testen zonder de volledige documentatie door te spitten? Ga dan naar het Configuratiescherm, waar je de Snelstarttool vindt — een eenvoudige manier om met één klik alle beschikbare eindpunten uit te proberen.

Klik op de onderstaande knop om u gratis te registreren en de Quick Launch Tool te gaan gebruiken.

Aan de slag

Belangrijke termen en concepten die u nodig hebt om met de Currency Rate API aan de slag te gaan:

API-reactie

De wisselkoersen die CurrencyRateAPI aanbiedt, zijn standaard in euro's. Alle gegevens worden geretourneerd in standaard JSON-formaat en kunnen eenvoudig worden verwerkt met elke programmeertaal.

Voorbeeldantwoord:
Hieronder vindt u een voorbeeld van een API-antwoord met een reeks gangbare wereldvaluta's, allemaal ten opzichte van de euro en met een tijdstempel waarop ze zijn ontvangen.

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

Zoals hierboven weergegeven, bevat het API-antwoord voor realtime wisselkoersen verschillende belangrijke velden:

• success Geeft aan of het verzoek succesvol was.
• base Geeft de 3-lettercode terug van de basisvaluta die voor dit verzoek is gebruikt.
• date Geeft de actuele datum weer waarvoor de wisselkoersen worden verstrekt (formaat JJJJ-MM-DD).
• rates Bevat de lijst met gevraagde valuta's en hun actuele wisselkoersen.
• last_update_unix Toont de tijdstempel (in Unix-formaat) van de laatst beschikbare gegevens in het systeem.

Beschikbare eindpunten

CurrencyRateAPI bevat verschillende API-eindpunten, elk met specifieke functionaliteit. De beschikbaarheid van bepaalde eindpunten is afhankelijk van uw abonnement.

• Eindpunt van de valutalijst. Dit eindpunt retourneert de volledige lijst van alle ondersteunde valuta. /api/codes (Alternatief: /api/currencies)
• Eindpunt van de meest recente tarieven. Dit eindpunt retourneert realtime wisselkoersgegevens voor alle ondersteunde valuta. /api/latest
• Eindpunt van de historische tarieven. Dit eindpunt retourneert historische wisselkoersgegevens voor een specifieke datum. /api/YYYY-MM-DD (Alternatief: /api/history?date=YYYY-MM-DD). Historische gegevens zijn beschikbaar vanaf 4 januari 1999.

Methodologie voor wisselkoersen

Om de nauwkeurigheid en consistentie van gegevens te waarborgen, hanteert CurrencyRateAPI een strikte methodologie voor het beheren en leveren van wisselkoersen:

• Tarieven in het middensegment: Standaard retourneert de API mid -koersen. Deze vertegenwoordigen het rekenkundig gemiddelde van de marktkoopprijs ( bid ) en de marktverkoopprijs ( ask ), of de officiële referentiekoersen van centrale banken.
• Eindafsluiting (EOD): De historische koersen die via de API worden verstrekt, worden vastgesteld aan het einde van de dag in UTC (Coordinated Universal Time).
• Kruislingse tariefberekening: Voor valutaparen die niet rechtstreeks via onze bronnen beschikbaar zijn, berekent het systeem automatisch zeer nauwkeurige kruiswisselkoersen met behulp van belangrijke wereldvaluta's als referentiepunt (pivot).
• Slim terugvalmechanisme: Als er geen gegevens beschikbaar zijn voor een gevraagde datum (bijvoorbeeld vanwege marktsluitingen in het weekend of op feestdagen), zoekt het systeem automatisch naar de meest recente geldige koers binnen een verschuivend venster van 8 dagen .
• Hoge precisie: Om afrondingsfouten in financiële berekeningen te voorkomen, worden wisselkoersen opgeslagen en verwerkt met maximaal 18 decimalen .

Eindpunten

Ondersteunde symbolen eindpunt

https://currencyrateapi.com/api/codes

Dit eindpunt retourneert de volledige lijst van alle ondersteunde valuta. Je kunt ook de alias /api/currencies gebruiken.

Een leesbare lijst van alle ondersteunde valuta's is ook beschikbaar op onze pagina 'Ondersteunde valuta's '.

Basisvaluta's: Standaard retourneren sommige andere eindpunten (zoals /latest en /{YYYY-MM-DD}) een beperkte set belangrijke wereldvaluta's om de verkeersdruk te minimaliseren. Deze "basisvaluta's" zijn:

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-antwoord:

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

Responsobjecten:

Laatste tarieven eindpunt

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

Aanvraagparameters:

API-antwoord:

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

Responsobjecten:

Eindpunt van historische tarieven

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

Alternatieve opmaak: /api/history?date=2025-08-25...

Aanvraagparameters:

API-antwoord:

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

Responsobjecten:

Voorbeeldcode

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

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