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

# Conversion de taux de change

> L'endpoint `convert` permet une conversion précise de devises en transformant des montants spécifiques entre devises à l'aide de taux de change en temps réel, idéal pour les calculs financiers et le traitement des paiements.

## Premiers pas

### URL de base

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

### Endpoint de validation

L'endpoint `convert` requiert votre clé API, une devise de base et un paramètre target pour effectuer des conversions de devises.

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

Cette requête réussie convertit 1 EUR en USD en utilisant le taux de change le plus récent :

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

### Paramètres de requête

<ParamField query="api_key" type="String" required>
  Votre clé API unique. Notez que chaque utilisateur possède des clés API uniques *pour chacune des
  API Cleariflow* ; votre clé de l'API de taux de change ne fonctionnera pas pour votre API de
  géolocalisation IP, par exemple.
</ParamField>

<ParamField query="base" type="String" required>
  La devise de base utilisée pour obtenir le(s) dernier(s) taux de change. Utilise la norme de devise ISO 4217 (par ex., USD pour les dollars américains), comme tous les paramètres de devise de cette API.
</ParamField>

<ParamField query="target" type="String" required>
  La devise cible pour obtenir le taux de change par rapport à la devise de base. Comme les paramètres de base, toute devise passée ici suit la norme ISO 4217. Notez que contrairement aux autres endpoints, `convert` n'accepte qu'une seule devise cible à la fois.
</ParamField>

<ParamField query="date" type="String">
  La date historique à partir de laquelle vous souhaitez obtenir les taux, au format AAAA-MM-JJ. Si vous laissez ce champ vide, les derniers taux disponibles seront utilisés.
</ParamField>

<ParamField query="base_amount" type="Float">
  Le montant de la devise de base que vous souhaitez convertir en devise cible.
</ParamField>

### Paramètres de réponse

La réponse de l'API est renvoyée dans un [format JSON](https://www.json.org/json-en.html) universel et léger.

<ResponseField name="base" type="String">
  La devise de base utilisée pour obtenir les taux de change.
</ResponseField>

<ResponseField name="target" type="String">
  La devise cible dans laquelle base\_amount a été converti.
</ResponseField>

<ResponseField name="date" type="String">
  La date à partir de laquelle les devises ont été extraites, selon la requête réussie.
</ResponseField>

<ResponseField name="base_amount" type="Float">
  Le montant de la devise de base de la requête.
</ResponseField>

<ResponseField name="converted_amount" type="Float">
  Le montant de la devise cible dans lequel base\_amount a été converti.
</ResponseField>

<ResponseField name="exchange_rate" type="Float">
  Le taux de change utilisé pour convertir base\_amount de la devise de base vers la devise cible.
</ResponseField>
