Diese Antworten behandeln häufige technische Fragen zur Integration mit der Currency Data API. Informationen zu jedem Endpunkt und Parameter finden Sie in der API-Dokumentation. Einen Überblick über unsere Kurse finden Sie unter Wie funktioniert die Currency Data API?
In diesem Artikel
- Welchen Endpunkt sollte ich für die jeweilige Kursart verwenden?
- Wie erhalte ich die vollständige Liste der Währungen?
- Welche Währungspaare deckt der Bid- und Ask-Endpunkt ab?
- Wie verarbeitet die API veraltete Währungen?
- Wie erhalte ich Bid- und Ask-Kurse von einer Zentralbank?
- Warum sieht ein Zentralbankkurs so aus, als stamme er vom Vortag?
- Kann ich Kurse aus der API zwischenspeichern?
- Wie erhalte ich den Kurs eines vergangenen Tages zu meiner Festschreibungszeit?
- Wie finde ich das SSL-Zertifikat für die API?
- Warum erhalte ich Zeitüberschreitungen oder 500-Fehler?
- Muss ich IP-Adressen auf eine Allowlist setzen?
- Warum erhalte ich 401- oder 403-Fehler?
Welchen Endpunkt sollte ich für die jeweilige Kursart verwenden?
| Kursart | Endpunkte |
|---|---|
| Spot-Mittelkurs |
/v1/convert_from, /v1/convert_to
|
| Historische Mittelkurs |
/v1/historic_rate, /v1/historic_rate/period, /v1/monthly_average, /v1/stats
|
| Spot-Bid- und Ask-Kurse (Beta) | /v1/bid_ask |
| Zentralbankkurse | /v1/central_bank_rate |
| Kurse aus alternativen Quellen | /v1/alternative_source_rate |
Kryptowährungskurse stammen aus unseren Mittelkursen. Sie fordern sie daher über die Mittelkurs-Endpunkte an. Fügen Sie Ihrer Anfrage crypto=true hinzu, um sie einzubeziehen.
Wie erhalte ich die vollständige Liste der Währungen?
Verwenden Sie den Endpunkt /v2/currencies. Für jede Währung werden folgende Informationen angezeigt:
- ob es sich um einen ISO-4217-Code handelt
- das Datum ihrer Einführung und, falls sie veraltet ist, das Datum ihrer Zurückziehung
- die Zeiträume, für die unsere Kurse für sie beginnen und enden
- die Währung, die sie ersetzt hat, sowie eine etwaige Bindung
Standardmäßig enthält die Liste aktive und veraltete Währungen. So ändern Sie dies:
- Fügen Sie
obsolete=truehinzu, um nur veraltete Währungen anzuzeigen, für die historische Daten vorliegen. - Fügen Sie
obsolete=falsehinzu, um veraltete Währungen durch die Währung zu ersetzen, die sie ersetzt hat.
Welche Währungspaare deckt der Bid- und Ask-Endpunkt ab?
Der Endpunkt /v1/bid_ask deckt AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK und USD ab.
Sie können jedes Paar in beide Richtungen anfordern, mit Ausnahme der folgenden Paare mit CNH (chinesischer Yuan offshore):
- CNH ist weder in Kombination mit BRL noch mit DKK oder PLN verfügbar.
- CNH ist mit NOK und SEK nur als Zielwährung verfügbar. Sie können beispielsweise
from=NOK&to=CNHanfordern, nicht jedochfrom=CNH&to=NOK.
Wie verarbeitet die API veraltete Währungen?
Währungen werden manchmal umbenannt, redenominiert oder zurückgezogen. Standardmäßig antwortet die API mit der heute verwendeten Währung. Wenn Sie also einen zurückgezogenen Code anfordern, erhalten Sie Kurse für die Währung, die ihn ersetzt hat. Um Kurse für den zurückgezogenen Code selbst zu erhalten, fügen Sie Ihrer Anfrage obsolete=true hinzu.
Wir berechnen nach dem Zurückziehungsdatum Kurse für eine veraltete Währung anhand ihrer festen Bindung an die Währung, die sie ersetzt hat. Dadurch bleiben lange Zeitreihen konsistent, es handelt sich dabei jedoch nicht um Marktkurse.
Weitere Informationen, einschließlich der Berechnung von Durchschnitten und Statistiken über einen Währungswechsel hinweg, finden Sie unter Historische Kurse und veraltete Währungen in der API-Dokumentation.
Wie erhalte ich Bid- und Ask-Kurse von einer Zentralbank?
Fügen Sie Ihrer Anfrage an /v1/central_bank_rate fields=mid,bid,ask hinzu. Ohne diesen Parameter erhalten Sie nur den Mittelkurs.
- Sie erhalten Bid- und Ask-Kurse nur von Zentralbanken, die diese veröffentlichen. Dies trifft auf 37 der 100 Zentralbanken zu, darunter die Bank of Japan, die Hong Kong Monetary Authority, die Zentralbank von Brasilien und die Bank of Thailand. Die Europäische Zentralbank, die Bank of England und die Federal Reserve Bank of New York veröffentlichen ausschließlich Referenzkurse. Die Spalte Bid/Ask in der API-Dokumentation zeigt, welche Banken diese Kurse veröffentlichen.
- Bid- und Ask-Kurse sind nur für aktuelle Kurse verfügbar. Wenn Sie Ihrer Anfrage ein
datehinzufügen, erhalten Sie nur Mittelkurs. - Dies sind die von den jeweiligen Zentralbanken veröffentlichten Kurse. Sie unterscheiden sich von den eigenen Bid- und Ask-Kursen von Xe aus dem Endpunkt
/v1/bid_ask.
Warum sieht ein Zentralbankkurs so aus, als stamme er vom Vortag?
Wenn Sie kein Datum angeben, gibt /v1/central_bank_rate einen timestamp in UTC zurück. Wenn Sie diesen in Ihre lokale Zeit umrechnen, kann der Kurs so aussehen, als stamme er vom Vortag.
Um stattdessen das lokale Datum der Bank zu erhalten, fügen Sie Ihrer Anfrage use_bank_date=true hinzu. Für die Europäische Zentralbank würden Sie beispielsweise 2026-08-17 statt 2026-08-16T22:00:00Z erhalten. Dies funktioniert für JSON-, XML- und CSV-Antworten.
Kann ich Kurse aus der API zwischenspeichern?
Ja, für eine begrenzte Zeit. Durch das Zwischenspeichern läuft Ihre Integration schneller und die Anzahl der von Ihnen gesendeten Anfragen wird reduziert. Entfernen Sie zwischengespeicherte Kurse, sobald sie veraltet sind. Zwischenspeichern bedeutet, Kurse vorübergehend aufzubewahren. Es bedeutet nicht, sie dauerhaft zu speichern.
Wie erhalte ich den Kurs eines vergangenen Tages zu meiner Festschreibungszeit?
Rufen Sie /v1/historic_rate mit date=YYYY-MM-DD und use_lock_in_time=true auf. Sie erhalten den Kurs, der an diesem Tag zur täglichen Festschreibungszeit Ihres Kontos galt. Sie können dies beispielsweise verwenden, um während der folgenden Woche den Kurs vom Freitag abzurufen.
Ihre Festschreibungszeit hat keinen Einfluss auf Zentralbankkurse. Diese richten sich nach dem jeweiligen Veröffentlichungszeitplan der Bank.
Wie finde ich das SSL-Zertifikat für die API?
Sie können das Zertifikat mit Chrome oder Edge aus Ihrem Browser herunterladen.
In Chrome
- Öffnen Sie Chrome und rufen Sie https://dfs.xe.com/dfs oder https://xecdapi.xe.com/v1 auf.
-
Wählen Sie links neben der Adressleiste das Symbol für Websiteinformationen aus.
-
Wählen Sie Verbindung ist sicher und anschließend Zertifikat ist gültig aus.
-
Öffnen Sie im Fenster mit den Zertifikatsdetails die Registerkarte Details.
-
Wählen Sie Exportieren, um das Zertifikat auf Ihr System herunterzuladen.
In Edge
- Rufen Sie https://dfs.xe.com/dfs oder https://xecdapi.xe.com/v1 auf.
-
Wählen Sie das Schlosssymbol in der Adressleiste aus.
- Wählen Sie Verbindung ist sicher aus.
- Wählen Sie oben rechts im Pop-up das Zertifikatsymbol aus.
-
Öffnen Sie im Zertifikatsfenster die Registerkarte Details.
- Wählen Sie Exportieren, um das Zertifikat herunterzuladen.
Warum erhalte ich Zeitüberschreitungen oder 500-Fehler?
Die meisten sporadischen Zeitüberschreitungen und 5xx-Fehler entstehen im Netzwerk oder Gateway zwischen Ihrem System und unserem System. Prüfen Sie vor der Kontaktaufnahme mit uns Folgendes:
- Gateways und Middleware: Wenn Sie die API über eine Integrationsplattform oder ein API-Gateway aufrufen, prüfen Sie zunächst deren Protokolle. Von diesen Systemen selbst erzeugte Fehler können wie Fehler unserer API aussehen.
-
DNS: Hinterlegen oder speichern Sie unsere IP-Adresse nicht fest zwischen. Lösen Sie
xecdapi.xe.comnormal auf und beachten Sie die DNS-TTLs, da sich die dahinterliegende IP-Adresse ändern kann. - Zeitüberschreitungen und Verbindungspools: Stellen Sie sicher, dass die Einstellungen Ihres Clients das Anfragevolumen zulassen. Verteilen Sie große Batches, anstatt sie alle auf einmal zu senden.
-
TLS: Ihr Client muss TLS 1.2 oder höher mit modernen (GCM-)Verschlüsselungssammlungen unterstützen. Ältere Stacks wie Java 7 oder älteres .NET bieten möglicherweise nur CBC-Verschlüsselungen an, die wir auslaufen lassen. Sie können Ihren Client unter
https://xecd-rates-api-test.xe.com/testen. Dieser Endpunkt akzeptiert nur TLS 1.3 sowie TLS 1.2 mit GCM.
Wenn die Fehler weiterhin auftreten, schreiben Sie uns an data@xe.com. Geben Sie dabei Ihre Konto-ID, den Endpunkt und die Parameter, die UTC-Zeitpunkte der Fehler sowie die vollständige Fehlerantwort an.
Muss ich IP-Adressen auf eine Allowlist setzen?
Nein. Die Currency Data API beschränkt Aufrufer nicht anhand ihrer IP-Adresse. Sie können https://xecdapi.xe.com von jeder öffentlichen IP-Adresse aus aufrufen und müssen Ihre IP-Adresse nicht bei uns registrieren.
Wenn Ihre Firewall ausgehenden Datenverkehr nur zu festen IP-Adressen zulässt, verwenden Sie unseren Endpunkt mit statischer IP-Adresse, xecd-proxy.xe.com, und fügen Sie dessen IP-Adresse Ihrer Allowlist hinzu, um die aktuelle IP-Adresse zu erhalten. Wir informieren alle Nutzer dieses Endpunkts per E-Mail, bevor sich die IP-Adresse ändert und bevor geplante Wartungsarbeiten stattfinden.
- Verwenden Sie
xecd-proxy.xe.comnur, wenn Sie eine feste IP-Adresse benötigen. Rufen Sie andernfallsxecdapi.xe.comdirekt auf. - Wenn Anfragen nach einer Netzwerkänderung auf Ihrer Seite fehlschlagen, prüfen Sie, ob die Allowlist Ihrer Firewall weiterhin unsere statische IP-Adresse enthält.
Wenn Sie den alten Datafeed (DFS) verwenden
DFS akzeptiert nur Anfragen von IP-Adressen auf der Allowlist. Wenn sich die IP-Adressen Ihres Büros oder Servers ändern, senden Sie uns die neuen Adressen. Wenn Sie zur API wechseln, müssen Sie keine IP-Adressen auf eine Allowlist setzen.
Warum erhalte ich 401- oder 403-Fehler?
- 401 Ungültige Anmeldedaten: Prüfen Sie die Konto-ID und den API-Schlüssel, die Ihre Integration sendet. Bei beiden wird zwischen Groß- und Kleinschreibung unterschieden.
- 403 „maximale Anzahl von Zugriffsversuchen überschritten“: Nach drei fehlgeschlagenen Authentifizierungsversuchen sperren wir das Konto für bis zu 5 Minuten. Die Sperre gilt für jede Integration des Kontos, auch für solche, die die korrekten Anmeldedaten verwenden. Dies bedeutet normalerweise, dass ein anderes System, beispielsweise ein alter Server oder ein Testskript, weiterhin einen veralteten Schlüssel sendet.
So beheben Sie einen 403-Fehler:
- Ermitteln Sie das System, das den alten Schlüssel sendet, und aktualisieren Sie es oder schalten Sie es aus.
- Warten Sie 5 Minuten und versuchen Sie es anschließend erneut.