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

# Conversión de tipos de cambio

> El endpoint `convert` permite una conversión precisa de divisas transformando importes específicos entre divisas utilizando tipos de cambio en tiempo real, ideal para cálculos financieros y procesamiento de pagos.

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

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

### Parámetros de solicitud

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

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

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

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

<ParamField query="base_amount" type="Float">
  El importe de la divisa base que desea convertir a la divisa de destino.
</ParamField>

### Parámetros de respuesta

La respuesta de la API se devuelve en un [formato JSON](https://www.json.org/json-en.html) universal y ligero.

<ResponseField name="base" type="String">
  La divisa base utilizada para obtener los tipos de cambio.
</ResponseField>

<ResponseField name="target" type="String">
  La divisa de destino a la que se convirtió base\_amount.
</ResponseField>

<ResponseField name="date" type="String">
  La fecha de la que se obtuvieron las divisas, según la solicitud exitosa.
</ResponseField>

<ResponseField name="base_amount" type="Float">
  El importe de la divisa base de la solicitud.
</ResponseField>

<ResponseField name="converted_amount" type="Float">
  El importe de la divisa de destino al que se ha convertido base\_amount.
</ResponseField>

<ResponseField name="exchange_rate" type="Float">
  El tipo de cambio utilizado para convertir base\_amount de la divisa base a la divisa de destino.
</ResponseField>