Saltar al contenido principal
GET
/
v1
/
convert
Conversión de tipos de cambio
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
}

​
Primeros pasos

​
URL base

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

​
Endpoint de validación

El endpoint convert requiere su clave API, una divisa base y un parámetro target para realizar conversiones de divisas. 
https://exchange-rates.cleariflow.com/v1/convert
? api_key = YOUR_UNIQUE_API_KEY
& base = EUR
& target = USD
Esta solicitud exitosa convierte 1 EUR a USD utilizando el tipo de cambio más actual: 
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
Parámetros de solicitud

​
api_key
String
requerido
Su clave API única. Tenga en cuenta que cada usuario tiene claves API únicas para cada una de las APIs de Cleariflow, por lo que su clave de la API de tipos de cambio no funcionará para su API de geolocalización IP, por ejemplo.
​
base
String
requerido
La divisa base utilizada para obtener el o los tipos de cambio más recientes. Utiliza el estándar de divisas ISO 4217 (p. ej., USD para dólares estadounidenses), como todos los parámetros de divisa en esta API.
​
target
String
requerido
La divisa o divisas de destino para obtener el tipo de cambio respecto a la divisa base. Al igual que el parámetro base, cualquier divisa enviada aquí sigue el estándar ISO 4217. Tenga en cuenta que, a diferencia de los otros endpoints, convert solo acepta una divisa de destino a la vez.
​
date
String
La fecha histórica de la que desea obtener los tipos, en formato YYYY-MM-DD. Si deja este campo en blanco, se utilizarán los tipos más recientes disponibles.
​
base_amount
Float
El importe de la divisa base que desea convertir a la divisa de destino.

​
Parámetros de respuesta

La respuesta de la API se devuelve en un formato JSON universal y ligero.
​
base
String
La divisa base utilizada para obtener los tipos de cambio.
​
target
String
La divisa de destino a la que se convirtió base_amount.
​
date
String
La fecha de la que se obtuvieron las divisas, según la solicitud exitosa.
​
base_amount
Float
El importe de la divisa base de la solicitud.
​
converted_amount
Float
El importe de la divisa de destino al que se ha convertido base_amount.
​
exchange_rate
Float
El tipo de cambio utilizado para convertir base_amount de la divisa base a la divisa de destino.