Zum Hauptinhalt springen
GET
/
v1
/
convert
Währungsumrechnung
curl --request GET \
  --url https://exchange-rates.cleariflow.com/v1/convert
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
Erste Schritte

​
Basis-URL

https://exchange-rates.cleariflow.com/v1/convert

​
Validierungs-Endpunkt

Der convert-Endpunkt benötigt Ihren API-Schlüssel, eine Basiswährung und einen Zielparameter für Währungsumrechnungen. 
https://exchange-rates.cleariflow.com/v1/convert
? api_key = YOUR_UNIQUE_API_KEY
& base = EUR
& target = USD
Diese erfolgreiche Anfrage rechnet 1 EUR in USD mit dem aktuellsten Wechselkurs um: 
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
Anfrageparameter

​
api_key
String
erforderlich
Ihr eindeutiger API-Schlüssel. Beachten Sie, dass jeder Nutzer für jede Cleariflow-API eigene API-Schlüssel hat — Ihr Wechselkurs-API-Schlüssel funktioniert z. B. nicht für die IP-Geolokalisierungs-API.
​
base
String
erforderlich
Die Basiswährung, für die die aktuellen Wechselkurse abgerufen werden sollen. Verwendet den ISO-4217-Währungsstandard (z. B. USD für US-Dollar), wie alle Währungsparameter in dieser API.
​
target
String
erforderlich
Die Zielwährung, für die der Wechselkurs gegenüber der Basiswährung ermittelt werden soll. Wie beim base-Parameter folgen alle hier übergebenen Währungen dem ISO-4217-Standard. Beachten Sie, dass convert im Gegensatz zu den anderen Endpunkten nur eine Zielwährung gleichzeitig akzeptiert.
​
date
String
Das historische Datum, von dem Kurse abgerufen werden sollen, im Format JJJJ-MM-TT. Bleibt der Parameter leer, werden die aktuell verfügbaren Kurse verwendet.
​
base_amount
Float
Der Betrag der Basiswährung, der in die Zielwährung umgerechnet werden soll.

​
Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen JSON-Format zurückgegeben.
​
base
String
Die Basiswährung, für die die Wechselkurse abgerufen wurden.
​
target
String
Die Zielwährung, in die der base_amount umgerechnet wurde.
​
date
String
Das Datum, von dem die Währungskurse gemäß der erfolgreichen Anfrage stammen.
​
base_amount
Float
Der Betrag der Basiswährung aus der Anfrage.
​
converted_amount
Float
Der Betrag in der Zielwährung, in den der base_amount umgerechnet wurde.
​
exchange_rate
Float
Der Wechselkurs, mit dem der base_amount von der Basiswährung in die Zielwährung umgerechnet wurde.