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

# Live-Wechselkurse

> Der `live`-Endpunkt liefert Echtzeit-Wechselkursdaten und ermöglicht sofortigen Zugriff auf aktuelle Marktkurse für Finanzoperationen und dynamisches Kursmonitoring.

## Erste Schritte

### Basis-URL

```
https://exchange-rates.cleariflow.com/v1/live
```

### Validierungs-Endpunkt

Wenn keine Zielwährungen angegeben werden, liefert der Endpunkt Kurse für alle verfügbaren Währungen. Die vollständige Liste unterstützter Währungen finden Sie [hier](getting-started).

```
https://exchange-rates.cleariflow.com/v1/live
? api_key = YOUR_UNIQUE_API_KEY
& base = USD
```

Diese erfolgreiche Anfrage liefert Wechselkurse für alle verfügbaren Währungen relativ zur Basiswährung:

<ResponseExample>
  ```json theme={"system"}
  {
      "base": "EUR",
      "last_updated": 1755806612,
      "exchange_rates": {
          "AED": 4.26365,
          "AFN": 79.371761,
          "ALL": 96.766559,
          "AMD": 444.303396,
          "ANG": 2.07788,
          "AOA": 1064.607378,
          "ARS": 1526.092012,
          "AUD": 1.806504,
          "AWG": 2.091193,
          "AZN": 1.972485,
          "BAM": 1.94832,
          "BBD": 2.337356,
          "BDT": 141.197895,
          "BGN": 1.955876,
          "BHD": 0.437742,
          "BIF": 3441.108157,
          "BMD": 1.160968,
          "BND": 1.493687,
          "BOB": 8.019865,
          "BRL": 6.358386,
          "BSD": 1.160489,
          "BTC": 0.000010310136,
          "BTN": 101.21369,
          "BWP": 15.615325,
          "BYN": 3.908315,
          "BYR": 22754.966223,
          "BZD": 2.328351,
          "CAD": 1.613524,
          "CDF": 3326.172282,
          "CHF": 0.939106,
          "CLF": 0.028737,
          "CLP": 1127.358136,
          "CNH": 8.340287,
          "CNY": 8.336214,
          "COP": 4685.375252,
          "CRC": 585.59961,
          "CUC": 1.160968,
          "CUP": 30.765643,
          "CVE": 110.675173,
          "CZK": 24.576564,
          "DJF": 206.327505,
          "DKK": 7.464964,
          "DOP": 72.415347,
          "DZD": 150.838676,
          "EGP": 56.298231,
          "ERN": 17.414515,
          "ETB": 164.622148,
          "FJD": 2.639866,
          "FKP": 0.863167,
          "GBP": 0.865164,
          "GEL": 3.128807,
          "GGP": 0.863167,
          "GHS": 12.776446,
          "GIP": 0.863167,
          "GMD": 83.589605,
          "GNF": 10075.458774,
          "GTQ": 8.898796,
          "GYD": 242.80765,
          "HKD": 9.071975,
          "HNL": 30.525752,
          "HRK": 7.533057,
          "HTG": 151.846358,
          "HUF": 396.377133,
          "IDR": 18982.924233,
          "ILS": 3.959365,
          "IMP": 0.863167,
          "INR": 101.308333,
          "IQD": 1520.86764,
          "IRR": 48818.690683,
          "ISK": 143.390958,
          "JEP": 0.863167,
          "JMD": 186.50395,
          "JOD": 0.823108,
          "JPY": 172.202267,
          "KES": 150.348297,
          "KGS": 101.524282,
          "KHR": 4649.676029,
          "KMF": 490.514729,
          "KPW": 1044.880197,
          "KRW": 1626.556298,
          "KWD": 0.355128,
          "KYD": 0.967166,
          "KZT": 623.825974,
          "LAK": 25076.901249,
          "LBP": 103970.458898,
          "LKR": 350.343584,
          "LRD": 234.370341,
          "LSL": 20.51426,
          "LTL": 3.428035,
          "LVL": 0.702258,
          "LYD": 6.298234,
          "MAD": 10.472154,
          "MDL": 19.538584,
          "MGA": 5148.891487,
          "MKD": 61.564837,
          "MMK": 2436.793158,
          "MNT": 4174.925262,
          "MOP": 9.340105,
          "MRU": 46.403613,
          "MUR": 53.102389,
          "MVR": 17.890252,
          "MWK": 2016.019751,
          "MXN": 21.783335,
          "MYR": 4.904511,
          "MZN": 74.189833,
          "NAD": 20.51403,
          "NGN": 1784.279885,
          "NIO": 42.724297,
          "NOK": 11.816444,
          "NPR": 161.941505,
          "NZD": 1.994252,
          "OMR": 0.446385,
          "PAB": 1.160539,
          "PEN": 4.074746,
          "PGK": 4.810464,
          "PHP": 66.382391,
          "PKR": 327.334442,
          "PLN": 4.256788,
          "PYG": 8385.912082,
          "QAR": 4.226793,
          "RON": 5.053583,
          "RSD": 117.178773,
          "RUB": 93.545406,
          "RWF": 1677.598275,
          "SAR": 4.356784,
          "SBD": 9.543586,
          "SCR": 17.083033,
          "SDG": 697.172079,
          "SEK": 11.169246,
          "SGD": 1.496253,
          "SHP": 0.912338,
          "SLE": 27.052052,
          "SLL": 24344.909083,
          "SOS": 663.494948,
          "SRD": 44.093416,
          "STD": 24029.68667,
          "STN": 24.78666,
          "SVC": 10.15419,
          "SYP": 15094.850487,
          "SZL": 20.51423,
          "THB": 37.921835,
          "TJS": 10.909308,
          "TMT": 4.063387,
          "TND": 3.356326,
          "TOP": 2.719101,
          "TRY": 47.525837,
          "TTD": 7.864449,
          "TWD": 35.421552,
          "TZS": 2891.836946,
          "UAH": 47.809567,
          "UGX": 4137.187253,
          "USD": 1.160968,
          "UYU": 46.661654,
          "UZS": 14512.095553,
          "VES": 160.163499,
          "VND": 30687.277791,
          "VUV": 139.211829,
          "WST": 3.1432,
          "XAF": 653.501468,
          "XAG": 0.030479,
          "XAU": 0.000348,
          "XCD": 3.137573,
          "XCG": 2.091641,
          "XDR": 0.812147,
          "XOF": 652.464211,
          "XPF": 119.331742,
          "YER": 278.86379,
          "ZAR": 20.58816,
          "ZMK": 10450.103649,
          "ZMW": 26.838156,
          "ZWL": 373.831114
      }
  }
  ```
</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">
  Die Zielwährung oder -währungen, 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. Bei mehreren Zielwährungen durch Kommas trennen (z. B. `&target=EUR,CAD,AUD`).
</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="last_updated" type="Integer">
  Der Unix-Zeitstempel der letzten Aktualisierung der zurückgegebenen Daten.
</ResponseField>

<ResponseField name="exchange_rates" type="Object">
  Ein JSON-Objekt, in dem jede Zielwährung als Schlüssel und der Wechselkurs zur Basiswährung als Wert steht.
</ResponseField>
