Skip to main content
GET
Конвертація валют

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

Базовий URL

Ендпоінт перевірки

Ендпоінт convert потребує API-ключа, базової валюти та параметра target для конвертації валют.
Цей успішний запит конвертує 1 EUR у USD за найактуальнішим обмінним курсом:

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

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

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

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