Deze antwoorden behandelen veelvoorkomende technische vragen over integratie met de Currency Data API. Zie de API-documentatie voor elk eindpunt en elke parameter. Zie Hoe werkt de Currency Data API? voor een overzicht van onze wisselkoersen.

In dit artikel

• Welk eindpunt moet ik gebruiken voor elk type wisselkoers?
• Hoe krijg ik de volledige lijst met valuta's?
• Welke valutaparen ondersteunt het bid- en ask-eindpunt?
• Hoe gaat de API om met verouderde valuta's?
• Hoe krijg ik bid- en ask-wisselkoersen van een centrale bank?
• Waarom lijkt een wisselkoers van een centrale bank afkomstig te zijn van de vorige dag?
• Kan ik wisselkoersen uit de API cachen?
• Hoe krijg ik de wisselkoers van een eerdere dag op mijn lock-intijd?
• Hoe vind ik het SSL-certificaat voor de API?
• Waarom krijg ik time-outs of 500-fouten?
• Moet ik IP-adressen op een allowlist zetten?
• Waarom krijg ik 401- of 403-fouten?

Welk eindpunt moet ik gebruiken voor elk type wisselkoers?

Cryptocurrency-wisselkoersen zijn afkomstig van onze mid-market-wisselkoersen. Je vraagt ze dus op via de mid-market-eindpunten. Voeg crypto=true toe aan je aanvraag om ze op te nemen.

Hoe krijg ik de volledige lijst met valuta's?

Gebruik het eindpunt /v2/currencies. Voor elke valuta wordt het volgende weergegeven:

• of het een ISO 4217-code is
• de datum waarop de valuta is ingevoerd en, als deze verouderd is, de datum waarop deze is ingetrokken
• de begin- en einddatum van onze wisselkoersen voor de valuta
• de valuta die deze heeft vervangen en eventuele koppeling

Standaard bevat de lijst actieve en verouderde valuta's. Zo wijzig je dit:

• voeg obsolete=true toe om alleen verouderde valuta's weer te geven waarvoor we historische gegevens hebben
• voeg obsolete=false toe om verouderde valuta's te vervangen door de valuta die deze heeft vervangen

Welke valutaparen ondersteunt het bid- en ask-eindpunt?

Het eindpunt /v1/bid_ask ondersteunt AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK en USD.

Je kunt elk paar in beide richtingen opvragen, behalve de volgende paren met CNH (Chinese yuan offshore):

• CNH is niet beschikbaar met BRL, DKK of PLN, in geen van beide richtingen.
• CNH is alleen beschikbaar als doelvaluta met NOK en SEK. Je kunt bijvoorbeeld from=NOK&to=CNH opvragen, maar niet from=CNH&to=NOK.

Hoe gaat de API om met verouderde valuta's?

Valuta's worden soms hernoemd, geherwaardeerd of ingetrokken. Standaard antwoordt de API met de valuta die vandaag wordt gebruikt. Als je een ingetrokken code opvraagt, krijg je dus wisselkoersen voor de valuta die deze heeft vervangen. Voeg obsolete=true toe aan je aanvraag om wisselkoersen voor de ingetrokken code zelf te krijgen.

We berekenen de wisselkoersen voor een verouderde valuta na de intrekkingsdatum op basis van de vaste koppeling aan de valuta die deze heeft vervangen. Hierdoor blijven lange historische reeksen consistent, maar dit zijn geen marktkoersen.

Zie Historische wisselkoersen en verouderde valuta's in de API-documentatie voor meer informatie, waaronder hoe we gemiddelden en statistieken berekenen rond een valutawijziging.

Hoe krijg ik bid- en ask-wisselkoersen van een centrale bank?

Voeg fields=mid,bid,ask toe aan je aanvraag voor /v1/central_bank_rate. Zonder deze parameter krijg je alleen de mid-wisselkoers.

• Je krijgt alleen bid- en ask-wisselkoersen van centrale banken die deze publiceren. 37 van de 100 centrale banken doen dit, waaronder de Bank of Japan, de Hong Kong Monetary Authority, de Central Bank of Brazil en de Bank of Thailand. De Europese Centrale Bank, de Bank of England en de Federal Reserve Bank of New York publiceren alleen referentiewisselkoersen. In de kolom Bid/Ask in de API-documentatie zie je welke banken deze publiceren.
• Bid- en ask-wisselkoersen zijn alleen beschikbaar voor actuele wisselkoersen. Als je een date aan je aanvraag toevoegt, krijg je alleen mid-wisselkoersen.
• Dit zijn de wisselkoersen die elke centrale bank publiceert. Ze verschillen van Xe's eigen bid- en ask-wisselkoersen uit het eindpunt /v1/bid_ask.

Waarom lijkt een wisselkoers van een centrale bank afkomstig te zijn van de vorige dag?

Als je geen datum opgeeft, retourneert /v1/central_bank_rate een timestamp in UTC. Wanneer je deze naar je lokale tijd omzet, kan het lijken alsof de wisselkoers van de vorige dag afkomstig is.

Voeg use_bank_date=true toe aan je aanvraag om in plaats daarvan de lokale datum van de bank te krijgen. Voor de Europese Centrale Bank krijg je bijvoorbeeld 2026-08-17 in plaats van 2026-08-16T22:00:00Z. Dit werkt voor JSON-, XML- en CSV-antwoorden.

Kan ik wisselkoersen uit de API cachen?

Ja, voor een beperkte periode. Cachen zorgt ervoor dat je integratie sneller werkt en vermindert het aantal aanvragen dat je doet. Verwijder gecachte wisselkoersen zodra deze verouderd zijn. Cachen betekent dat je wisselkoersen tijdelijk bewaart. Het betekent niet dat je ze permanent opslaat.

Hoe krijg ik de wisselkoers van een eerdere dag op mijn lock-intijd?

Roep /v1/historic_rate aan met date=YYYY-MM-DD en use_lock_in_time=true. Je krijgt de wisselkoers zoals deze op die dag was op de dagelijkse lock-intijd van je account. Je kunt dit bijvoorbeeld gebruiken om de wisselkoers van vrijdag in de daaropvolgende week op te vragen.

Je lock-intijd heeft geen invloed op wisselkoersen van centrale banken. Deze volgen het eigen publicatieschema van elke bank.

Hoe vind ik het SSL-certificaat voor de API?

Je kunt het certificaat downloaden vanuit je browser, met Chrome of Edge.

In Chrome

1. Open Chrome en ga naar https://dfs.xe.com/dfs of https://xecdapi.xe.com/v1.

2. Selecteer het pictogram met sitegegevens links van de adresbalk.

   

3. Selecteer Verbinding is beveiligd en selecteer vervolgens Certificaat is geldig.

   

4. Ga in het venster met certificaatgegevens naar het tabblad Details.

   

5. Selecteer Exporteren om het certificaat naar je systeem te downloaden.

   

In Edge

1. Ga naar https://dfs.xe.com/dfs of https://xecdapi.xe.com/v1.

2. Selecteer het hangslotpictogram in de adresbalk.

   

3. Selecteer Verbinding is beveiligd.
4. Selecteer het certificaatpictogram rechtsboven in de pop-up.

5. Open in het certificaatvenster het tabblad Details.

   

6. Selecteer Exporteren om het certificaat te downloaden.
   
   

Waarom krijg ik time-outs of 500-fouten?

De meeste incidentele time-outs en 5xx-fouten ontstaan in het netwerk of de gateway tussen jouw systeem en dat van ons. Controleer het volgende voordat je contact met ons opneemt:

• Gateways en middleware: als je de API aanroept via een integratieplatform of API-gateway, controleer dan eerst de logboeken daarvan. Fouten die daar zelf ontstaan, kunnen eruitzien als fouten van onze API.
• DNS: leg ons IP-adres niet hard vast en cache het niet. Los xecdapi.xe.com normaal op en respecteer de DNS-TTL's, omdat het IP-adres erachter kan veranderen.
• Time-outs en verbindingspools: zorg ervoor dat de instellingen van je client je aanvraagvolume aankunnen. Spreid grote batches uit in plaats van ze allemaal tegelijk te verzenden.
• TLS: je client moet TLS 1.2 of hoger met moderne (GCM-)ciphersuites ondersteunen. Oudere stacks, zoals Java 7 of verouderde .NET-versies, bieden mogelijk alleen CBC-ciphers, waarmee we stoppen. Je kunt je client testen met https://xecd-rates-api-test.xe.com/, dat alleen TLS 1.3 en TLS 1.2 met GCM accepteert.

Als de fouten aanhouden, e-mail ons dan via data@xe.com met je account-ID, het eindpunt en de parameters, de UTC-tijdstippen van de fouten en het volledige foutantwoord.

Moet ik IP-adressen op een allowlist zetten?

Nee. De Currency Data API beperkt aanroepers niet op basis van hun IP-adres. Je kunt https://xecdapi.xe.com vanaf elk openbaar IP-adres aanroepen en je hoeft jouw IP-adres niet bij ons te registreren.

Als je firewall uitgaand verkeer alleen naar vaste IP-adressen toestaat, gebruik dan ons statische IP-eindpunt, xecd-proxy.xe.com, en voeg het IP-adres ervan toe aan je allowlist. Controleer het huidige IP-adres. We e-mailen iedereen die dit eindpunt gebruikt voordat het IP-adres verandert en vóór gepland onderhoud.

• Gebruik xecd-proxy.xe.com alleen als je een vast IP-adres nodig hebt. Roep anders rechtstreeks xecdapi.xe.com aan.
• Als aanvragen na een netwerkwijziging aan jouw kant mislukken, controleer dan of het statische IP-adres van ons nog op de allowlist van je firewall staat.

Als je de verouderde Datafeed (DFS) gebruikt

DFS accepteert alleen aanvragen vanaf IP-adressen die op de allowlist staan. Als de IP-adressen van je kantoor of server veranderen, stuur ons dan de nieuwe adressen. Als je overstapt naar de API, hoef je geen IP-adressen op een allowlist te zetten.

Waarom krijg ik 401- of 403-fouten?

• 401 Ongeldige inloggegevens: controleer de account-ID en API-sleutel die je integratie verzendt. Beide zijn hoofdlettergevoelig.
• 403 'maximaal aantal toegangspogingen overschreden': na 3 mislukte authenticatiepogingen blokkeren we het account maximaal 5 minuten. De blokkering geldt voor elke integratie op het account, ook voor integraties die de juiste inloggegevens gebruiken. Dit betekent meestal dat een ander systeem, zoals een oude server of een testscript, nog steeds een verouderde sleutel verzendt.

Een 403-fout oplossen:

1. Zoek het systeem dat de oude sleutel verzendt en werk dit bij of schakel het uit.
2. Wacht 5 minuten en probeer het vervolgens opnieuw.