Перейти к основному содержанию
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 Cleariflow, поэтому ключ API обменных курсов не будет работать, например, с API геолокации IP.
​
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 из базовой валюты в целевую.