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

# Конвертация валют

> Эндпоинт `convert` конвертирует конкретные суммы между валютами по актуальным обменным курсам — идеально для финансовых расчётов и обработки платежей.

## Начало работы

### Базовый URL

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

### Эндпоинт конвертации

Эндпоинт `convert` требует ваш API-ключ, базовую валюту и параметр target для конвертации валют.

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

Успешный запрос конвертирует 1 EUR в USD по актуальному обменному курсу:

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

### Параметры запроса

<ParamField query="api_key" type="String" required>
  Ваш уникальный API-ключ. У каждого пользователя уникальные ключи *для каждого API Cleariflow*, поэтому ключ API обменных курсов не будет работать, например, с API геолокации IP.
</ParamField>

<ParamField query="base" type="String" required>
  Базовая валюта для получения актуального курса(ов). Используется стандарт ISO 4217 (например, USD для долларов США), как и все валютные параметры в этом API.
</ParamField>

<ParamField query="target" type="String" required>
  Целевая валюта или валюты для получения курса относительно базовой. Как и base, любая валюта следует стандарту ISO 4217. В отличие от других эндпоинтов, `convert` принимает только одну целевую валюту за раз.
</ParamField>

<ParamField query="date" type="String">
  Историческая дата для получения курсов в формате YYYY-MM-DD. Если не указать, используются последние доступные курс(ы).
</ParamField>

<ParamField query="base_amount" type="Float">
  Сумма базовой валюты для конвертации в целевую валюту.
</ParamField>

### Параметры ответа

Ответ API возвращается в универсальном лёгком формате [JSON](https://www.json.org/json-en.html).

<ResponseField name="base" type="String">
  Базовая валюта, использованная для получения обменных курсов.
</ResponseField>

<ResponseField name="target" type="String">
  Целевая валюта, в которую была конвертирована base\_amount.
</ResponseField>

<ResponseField name="date" type="String">
  Дата, за которую были получены валюты, согласно успешному запросу.
</ResponseField>

<ResponseField name="base_amount" type="Float">
  Сумма базовой валюты из запроса.
</ResponseField>

<ResponseField name="converted_amount" type="Float">
  Сумма целевой валюты, в которую была конвертирована base\_amount.
</ResponseField>

<ResponseField name="exchange_rate" type="Float">
  Обменный курс, использованный для конвертации base\_amount из базовой валюты в целевую.
</ResponseField>