Zum Hauptinhalt springen
Der Endpunkt exchange-rates liefert ein Bündel aktueller Wechselkurse, mit dem sich Beträge aus beliebigen bekannten Währungen in eine frei wählbare Zielwährung umrechnen lassen. Die Kurse basieren auf den von der Europäischen Zentralbank (EZB) bezogenen Referenzkursen. Intern werden diese Kurse relativ zur Basiswährung EUR gespeichert; der Endpunkt berechnet daraus die Kreuzkurse zur angefragten Zielwährung. Genutzt wird die Schnittstelle unter anderem vom Admin Interface, um Beträge lokal in der gewählten Anzeige-Währung darzustellen, ohne dass für jede Umrechnung eine separate Anfrage nötig ist.
Die Wechselkurse werden täglich von der EZB abgerufen. Der Endpunkt liefert dabei stets den aktuellsten dem Shop bekannten Wechselkurs zurück.
Für die Nutzung dieses Endpunkts ist eine gültige Anmeldung erforderlich (siehe API Basics). Eine servicespezifische Berechtigung wird nicht benötigt.

​
Unterstützte Methoden

Angabe aller unterstützten Methoden.
Befehl/InfoEndpunkteGETPOSTPUTDELETE
Wechselkurseexchange-rates

​
Datenfelder eines Kurseintrags

Jeder Eintrag im Objekt rates beschreibt den Umrechnungskurs einer Währung in die angefragte Zielwährung.
NameTypVerwendung
rateNumberUmrechnungsfaktor in die Zielwährung. Ein Betrag in der jeweiligen Währung wird durch Multiplikation mit rate in die Zielwährung umgerechnet (Betrag_Zielwährung = Betrag_Ausgangswährung × rate). Die Zielwährung selbst hat immer den Wert 1.0.
rateDateStringDatum des zugrunde liegenden EZB-Kurses (Format YYYY-MM-DD). Bei Kreuzkursen wird das ältere der beiden beteiligten Kursdaten (Ausgangs- und Zielwährung) verwendet.
isRecentBooleanGibt an, ob der Kurs den konfigurierten Aktualitätsvorgaben entspricht (true). Bei false konnte kein hinreichend aktueller Kurs ermittelt werden – der Wert wird dennoch zurückgegeben, sollte aber mit Vorsicht verwendet werden.
Die Basiswährung EUR ist immer im Ergebnis enthalten, auch wenn für sie kein eigener Kurssatz in der Datenbank vorliegt. Sie besitzt implizit den Kurs 1.0 mit dem aktuellen Datum.

​
Methoden für Wechselkurse

​
GET exchange-rates

Mit diesem Endpunkt wird ein Bündel von Umrechnungskursen relativ zu einer Zielwährung abgerufen. Die Zielwährung wird über den Pflichtparameter target als dreistelliger ISO-4217-Währungscode (z. B. EUR, USD, GBP) übergeben. Die Antwort enthält für jede im System bekannte Währung einen Kurseintrag sowie zusätzlich die Zielwährung selbst (mit Kurs 1.0).

​
Beispiel

https://<ihr-shop>.de/admin/api/v1/exchange-rates?target=EUR

​
Unterstützte Parameter

ParameterBeschreibung
targetPflichtfeld. Dreistelliger ISO-4217-Code der Zielwährung, in die umgerechnet werden soll. Muss exakt drei Zeichen lang sein.

​
Antwort

{
    "target": "EUR",
    "rates": {
        "EUR": {
            "rate": 1.0,
            "rateDate": "2026-07-02",
            "isRecent": true
        },
        "GBP": {
            "rate": 1.18203,
            "rateDate": "2026-07-01",
            "isRecent": true
        },
        "USD": {
            "rate": 0.91996,
            "rateDate": "2026-07-01",
            "isRecent": true
        }
    }
}
Im Beispiel entspricht 1 USD etwa 0,92 EUR und 1 GBP etwa 1,18 EUR. Um einen Betrag umzurechnen, wird er mit dem rate der Ausgangswährung multipliziert.

​
Fehlercodes

FehlerTypGrund
401 UnauthorizedNicht autorisiert: Sie sind nicht angemeldet.
400 Bad Request”invalidValue”Der Parameter target fehlt, ist leer oder besitzt nicht exakt drei Zeichen.

​
Support

Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: Zum Kundenportal Bitte senden Sie uns eine möglichst detaillierte Beschreibung sowie Screenshots, Requests/Antworten, damit wir Ihre Anfrage zeitnah und zielführend beantworten können.