Passer au contenu principal
GET
/
v1
/
convert
Conversion de taux de change
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
}

​
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 : 
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
Paramètres de requête

​
api_key
String
requis
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.
​
base
String
requis
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.
​
target
String
requis
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.
​
date
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.
​
base_amount
Float
Le montant de la devise de base que vous souhaitez convertir en devise cible.

​
Paramètres de réponse

La réponse de l’API est renvoyée dans un format JSON universel et léger.
​
base
String
La devise de base utilisée pour obtenir les taux de change.
​
target
String
La devise cible dans laquelle base_amount a été converti.
​
date
String
La date à partir de laquelle les devises ont été extraites, selon la requête réussie.
​
base_amount
Float
Le montant de la devise de base de la requête.
​
converted_amount
Float
Le montant de la devise cible dans lequel base_amount a été converti.
​
exchange_rate
Float
Le taux de change utilisé pour convertir base_amount de la devise de base vers la devise cible.