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 Возвращает трехбуквенный код базовой валюты, использованной для этого запроса.
• 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 (fetch)

 // 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);
    });