> ## 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-ключі *для кожного з
  API Cleariflow*, тому ключ Exchange Rates API не працюватиме для IP
  Geolocation API, наприклад.
</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>