Finance : Exchange rates

Aangemaakt: 20-07-2026

Omschrijving

Haal de actuele wisselkoersen op ten opzichte van de basisvaluta (EUR). Voor elke valuta wordt de koers, een omschrijving en het valutasymbool (als HTML-entiteit) teruggegeven, samen met het tijdstip waarop de koers voor het laatst is bijgewerkt.

Endpoint

GET https://api.nextname.nl/v2/finance/exchange_rates

URL parameters

De parameter is optioneel en werkt als zoekwaarde om de lijst te filteren. Bekijk voor de volledige syntax van zoekwaarden, operatoren en paginering de pagina Zoekopdrachten.

Parameter	Datatype	Omschrijving
currency	Array	Zoekwaarde voor de valutacode (ISO 4217), bijvoorbeeld USD of GBP. Zonder deze parameter worden alle beschikbare valuta's teruggegeven.

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
Object: data
base	String	De basisvaluta (ISO 4217) waartegen alle koersen zijn uitgedrukt; altijd EUR
Array: data.rates[] met object:
currency	String	De valutacode (ISO 4217) van deze koers
rate	Decimal	De wisselkoers: het aantal eenheden van deze valuta dat gelijk is aan 1 base (EUR). Voor de basisvaluta zelf is dit 1.
date_last_updated	Datetime	Datum en tijdstip waarop de koers voor het laatst is bijgewerkt, in UTC tijdzone volgens RFC 3339. Voor de basisvaluta is dit null.
description	String	De omschrijving van de valuta (bijvoorbeeld US Dollar)
symbol_html	String	Het valutasymbool als HTML-entiteit(en)
Object: pagination
current_page	Integer	Huidige pagina
per_page	Integer	Aantal resultaten per pagina
total_pages	Integer	Totaal aantal pagina's
total_results	Integer	Totaal aantal resultaten

Beschrijving:
Haal de wisselkoersen van alle beschikbare valuta's op ten opzichte van de basisvaluta (EUR).

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/finance/exchange_rates";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

Opdracht in cURL:

curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.nextname.nl/v2/finance/exchange_rates

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "data": {
    "base": "EUR",
    "rates": [
      {
        "currency": "GBP",
        "rate": 0.85098,
        "date_last_updated": "2026-07-17T16:15:18Z",
        "description": "Pound Sterling",
        "symbol_html": "&pound;"
      },
      {
        "currency": "EUR",
        "rate": 1,
        "date_last_updated": null,
        "description": "Euro",
        "symbol_html": "&euro;"
      },
      {
        "currency": "USD",
        "rate": 1.1435,
        "date_last_updated": "2026-07-17T16:15:18Z",
        "description": "US Dollar",
        "symbol_html": "$"
      }
    ]
  },
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 3
  }
}

Beschrijving:
Haal alleen de koersen van specifieke valuta's op via de zoekwaarde currency. Meerdere valuta's geef je op als array.

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/finance/exchange_rates?currency=USD,GBP";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

Opdracht in cURL:

curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
"https://api-test.nextname.nl/v2/finance/exchange_rates?currency=USD,GBP"

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "data": {
    "base": "EUR",
    "rates": [
      {
        "currency": "GBP",
        "rate": 0.85098,
        "date_last_updated": "2026-07-17T16:15:18Z",
        "description": "Pound Sterling",
        "symbol_html": "&pound;"
      },
      {
        "currency": "USD",
        "rate": 1.1435,
        "date_last_updated": "2026-07-17T16:15:18Z",
        "description": "US Dollar",
        "symbol_html": "$"
      }
    ]
  },
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 2
  }
}