CurrencyRateAPI

Інструмент швидкого запуску

Потрібно протестувати API, не переглядаючи повну документацію? Перейдіть до Панелі керування, де ви знайдете Інструмент швидкого запуску — простий спосіб випробувати всі доступні кінцеві точки одним клацанням миші.

Натисніть кнопку нижче, щоб безкоштовно зареєструватися та почати користуватися інструментом швидкого запуску.

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

Ключові терміни та поняття, які вам знадобляться для початку роботи з Currency Rate API:

Відповідь API

Обмінні курси, що надаються CurrencyRateAPI, за замовчуванням вказані в євро. Усі дані повертаються у стандартному форматі JSON і їх можна легко проаналізувати за допомогою будь-якої мови програмування.

Зразок відповіді:
Нижче ви знайдете зразок відповіді API, що містить ряд поширених світових валют, усі відносно євро та з позначкою часу, коли вони були отримані.

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Як показано вище, відповідь API для обмінних курсів у режимі реального часу містить кілька ключових полів:

• success вказує, чи був запит успішним.
• base повертає 3-літерний код базової валюти, що використовується для цього запиту.
• date повертає фактичну дату, для якої надано обмінні курси (формат РРРР-ММ-ДД).
• rates містить список запитуваних валют та їх поточні обмінні курси.
• last_update_unix показує позначку часу (у форматі Unix) останніх доступних даних у системі.

Доступні кінцеві точки

CurrencyRateAPI містить кілька кінцевих точок API, кожна з яких пропонує певний функціонал. Доступність певних кінцевих точок залежить від вашого плану підписки.

• Кінцева точка списку валют. Ця кінцева точка повертає повний список усіх підтримуваних валют. /api/codes (Альтернатива: /api/currencies)
• Кінцева точка останніх ставок. Ця кінцева точка повертає дані про обмінний курс у режимі реального часу для всіх підтримуваних валют. /api/latest
• Кінцева точка історичних ставок. Ця кінцева точка повертає дані про історичні обмінні курси за певну дату. /api/YYYY-MM-DD (Альтернатива: /api/history?date=YYYY-MM-DD). Історичні дані доступні з 4 січня 1999 року.

Методологія обмінного курсу

Щоб забезпечити точність та узгодженість даних, CurrencyRateAPI дотримується суворої методології управління та надання обмінних курсів:

• Середньоринкові тарифи: За замовчуванням API повертає mid ставки. Вони представляють собою середнє арифметичне між ринковими цінами купівлі ( bid ) та продажу ( ask ) або офіційними довідковими курсами центральних банків.
• Фіналізація наприкінці дня (EOD): Історичні тарифи, надані API, остаточно встановлені станом на кінець дня за UTC (всесвітній координований час).
• Розрахунок крос-курсу: Для валютних пар, які недоступні безпосередньо з наших джерел, система автоматично розраховує високоточні крос-курси, використовуючи основні світові валюти як міст (півот).
• Розумний резервний механізм: Якщо дані для запитуваної дати недоступні (наприклад, через закриття ринку у вихідні або свята), система автоматично шукає найновіший дійсний курс протягом 8-денного періоду .
• Висока точність: Щоб запобігти помилкам округлення у фінансових розрахунках, обмінні курси зберігаються та обробляються з точністю до 18 знаків після коми .

Кінцеві точки

Підтримувані символи кінцевої точки

https://currencyrateapi.com/api/codes

Ця кінцева точка повертає повний список усіх підтримуваних валют. Ви також можете використовувати псевдонім /api/currencies.

Список усіх підтримуваних валют у зручному для читання вигляді також доступний на нашій сторінці «Підтримувані валюти» .

Основні валюти: За замовчуванням деякі інші кінцеві точки (наприклад, /latest та /{YYYY-MM-DD}) повертають обмежений набір основних світових валют для мінімізації трафіку. Ці «базові» валюти:

USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR

Відповідь API:

{
    "success": true,
    "currencies": {
        "EUR": {
            "entity": "EUROPEAN UNION",
            "currency": "Euro",
            "alphabetic_code": "EUR",
            "numeric_code": 978,
            "minor_unit": 2,
            "title": "Euro",
            "symbol": "€",
            "data_from": "1999-01-04"
        },
        "BTC": {
            "entity": "CRYPTOCURRENCY",
            "currency": "Bitcoin",
            "alphabetic_code": "BTC",
            "title": "Bitcoin",
            "symbol": "₿",
            "is_crypto": true,
            "data_from": "2024-03-02"
        },
        [...]
    }
}

Об'єкти відповіді:

Кінцева точка останніх тарифів

https://currencyrateapi.com/api/latest?
    base=USD&
    quote=GBP,JPY,EUR

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

Відповідь API:

{
    "success": true,
    "base": "usd",
    "date": "2026-01-22",
    "rates": {
        "gbp": "0.74350935478637",
        "jpy": "158.00358051914",
        "eur": "0.8518613169776"
    },
    "last_update_unix": "1769067006"
}

Об'єкти відповіді:

Кінцева точка історичних ставок

https://currencyrateapi.com/api/2025-08-25?
    base=EUR&
    quote=USD,GBP,CAD

Альтернативний формат: /api/history?date=2025-08-25...

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

Відповідь API:

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Об'єкти відповіді:

Зразок коду

PHP (cURL)

// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';

// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Store the data:
$json = curl_exec($ch);
curl_close($ch);

// Decode JSON response:
$exchangeRates = json_decode($json, true);

// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];

JavaScript (вибірка)

 // Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';

// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
    .then(response => {
        return response.json();
    })
    .then(json => {

        // Exchange rate data is stored in json.rates
        console.log(json.rates.GBP);

        // Timestamp can be accessed in json.last_update_unix
        console.log(json.last_update_unix);
    })
    .catch(error => {
        console.error('Fetch error:', error);
    });