Перейти до основного вмісту
GET
/
v1
/
convert
Конвертація валют
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
}

​
Початок роботи

​
Базовий 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 за найактуальнішим обмінним курсом: 
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
Параметри запиту

​
api_key
String
обов'язково
Ваш унікальний API-ключ. Зверніть увагу: у кожного користувача є унікальні API-ключі для кожного з API Cleariflow, тому ключ Exchange Rates API не працюватиме для IP Geolocation API, наприклад.
​
base
String
обов'язково
Базова валюта для отримання актуальних обмінних курсів. Використовує стандарт ISO 4217 (наприклад, USD для доларів США), як і всі параметри валют у цьому API.
​
target
String
обов'язково
Цільова валюта для отримання курсу відносно базової. Як і base, валюта відповідає ISO 4217. На відміну від інших ендпоінтів, convert приймає лише одну цільову валюту за раз.
​
date
String
Історична дата для отримання курсів у форматі YYYY-MM-DD. Якщо не вказано, використовуються найактуальніші доступні курси.
​
base_amount
Float
Сума базової валюти, яку потрібно конвертувати в цільову валюту.

​
Параметри відповіді

Відповідь API повертається у універсальному та легкому форматі JSON.
​
base
String
Базова валюта, використана для отримання обмінних курсів.
​
target
String
Цільова валюта, в яку конвертовано base_amount.
​
date
String
Дата, з якої взято курси валют, згідно з успішним запитом.
​
base_amount
Float
Сума базової валюти з запиту.
​
converted_amount
Float
Сума цільової валюти, в яку конвертовано base_amount.
​
exchange_rate
Float
Обмінний курс, використаний для конвертації base_amount з базової валюти в цільову.