> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Währungsumrechnung

> Der `convert`-Endpunkt rechnet bestimmte Beträge zwischen Währungen mit Echtzeit-Wechselkursen um — ideal für Finanzberechnungen und Zahlungsabwicklung.

## 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:

<ResponseExample>
  ```json theme={"system"}
  {
      "base": "EUR",
      "target": "USD",
      "base_amount": 1,
      "converted_amount": 1.160968,
      "exchange_rate": 1.160968,
      "last_updated": 1755806612
  }
  ```
</ResponseExample>

### Anfrageparameter

<ParamField query="api_key" type="String" required>
  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.
</ParamField>

<ParamField query="base" type="String" required>
  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.
</ParamField>

<ParamField query="target" type="String" required>
  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.
</ParamField>

<ParamField query="date" type="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.
</ParamField>

<ParamField query="base_amount" type="Float">
  Der Betrag der Basiswährung, der in die Zielwährung umgerechnet werden soll.
</ParamField>

### Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen [JSON-Format](https://www.json.org/json-en.html) zurückgegeben.

<ResponseField name="base" type="String">
  Die Basiswährung, für die die Wechselkurse abgerufen wurden.
</ResponseField>

<ResponseField name="target" type="String">
  Die Zielwährung, in die der `base_amount` umgerechnet wurde.
</ResponseField>

<ResponseField name="date" type="String">
  Das Datum, von dem die Währungskurse gemäß der erfolgreichen Anfrage stammen.
</ResponseField>

<ResponseField name="base_amount" type="Float">
  Der Betrag der Basiswährung aus der Anfrage.
</ResponseField>

<ResponseField name="converted_amount" type="Float">
  Der Betrag in der Zielwährung, in den der `base_amount` umgerechnet wurde.
</ResponseField>

<ResponseField name="exchange_rate" type="Float">
  Der Wechselkurs, mit dem der `base_amount` von der Basiswährung in die Zielwährung umgerechnet wurde.
</ResponseField>