Документация API

Все, что вам нужно для интеграции курсов обмена валют в реальном времени в ваше приложение.

Обзор

API AllRatesToday предоставляет курсы обмена валют в реальном времени и исторические данные через простой REST-интерфейс. Все ответы возвращаются в формате JSON. Базовый URL:

https://allratestoday.com

Зарегистрируйтесь бесплатно и получите API ключ для доступа к эндпоинтам с аутентификацией. Доступен бесплатный тариф.

Аутентификация

Передайте ваш API ключ как Bearer токен:

Authorization: Bearer YOUR_API_KEY

Получите ваш API ключ на странице профиля после входа в систему.

Лимиты запросов

Заголовки лимитов запросов Все ответы содержат заголовки лимитов: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-Monthly-Limit, X-Monthly-Used, X-Monthly-Resets.

План	Месячный лимит	Скорость	Аутентификация	Цена
Публичный	10 / час на IP	10 / час	Нет	Бесплатно

Лимиты зависят от тарифа. При превышении месячного лимита API возвращает 429. Предупреждение отправляется на почту при достижении 90%. Тарифы

Курсы с аутентификацией

GET /api/v1/rates

Эндпоинт с аутентификацией и более высокими лимитами запросов. Требуется Bearer токен.

Параметр	Тип	Описание
sourceнеобязательный	string	Код исходной валюты (например, USD)
targetнеобязательный	string	Код целевой валюты (например, EUR)
timeнеобязательный	ISO 8601	Курс на определенный момент времени
fromнеобязательный	YYYY-MM-DD	Дата начала исторического диапазона
toнеобязательный	YYYY-MM-DD	Дата окончания исторического диапазона
groupнеобязательный	string	Группировка по: day, hour, minute

Пример:

curl "https://allratestoday.com/api/v1/rates?source=USD&target=EUR" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ответ:

[
  {
    "rate": 0.9215,
    "source": "USD",
    "target": "EUR",
    "time": "2026-04-03T12:00:00Z"
  }
]

Простой курс

GET /api/rate

Легковесный эндпоинт для получения курса одной валютной пары.

Параметр	Тип	Описание
sourceобязательный	string	Код исходной валюты
targetобязательный	string	Код целевой валюты

curl "https://allratestoday.com/api/rate?source=GBP&target=USD"

{ "rate": 1.2634, "source": "refinitiv" }

Исторические курсы

GET /api/historical-rates

Получение исторических данных о курсах обмена для построения графиков и анализа.

Параметр	Тип	Описание
sourceобязательный	string	Код исходной валюты
targetобязательный	string	Код целевой валюты
periodнеобязательный	string	1d, 7d, 30d или 1y (по умолчанию: 7d)

curl "https://allratestoday.com/api/historical-rates?source=USD&target=EUR&period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "source": "USD",
  "target": "EUR",
  "data": [
    { "date": "2026-03-04", "rate": 0.9198, "timestamp": 1741046400000 },
    { "date": "2026-03-05", "rate": 0.9210, "timestamp": 1741132800000 }
  ],
  "source_api": "refinitiv",
  "period": "30d"
}

Коды ошибок

Статус	Значение
`400`	Неверный запрос — отсутствуют или недопустимые параметры
`401`	Не авторизован — отсутствует или недействительный API ключ
`429`	Превышен лимит запросов — проверьте заголовок `Retry-After`
`500`	Внутренняя ошибка сервера
`503`	Сервис временно недоступен

Актуальность данных

AllRatesToday предоставляет курсы валют в реальном времени. В отличие от других провайдеров, которые обновляют данные раз в 60 минут, наши курсы получаются в режиме реального времени от Reuters (Refinitiv) и межбанковских рыночных данных при каждом запросе, гарантируя самые актуальные среднерыночные курсы.

Обновление в реальном времени Курсы получаются в режиме реального времени от Reuters (Refinitiv) и межбанковских рыночных данных — без задержек и пакетных обновлений.

Поддерживаемые валюты

Более 45 валют, включая:

Основные валюты USD, EUR, GBP, JPY, CHF, CAD, AUD, NZD

Популярные валюты INR, CNY, BRL, MXN, RUB, TRY, ZAR, SGD, HKD, KRW, THB, PHP, PKR, BDT, LKR, NGN, GHS, KES, AED, SAR, EGP и другие

Полный список доступен через спецификацию OpenAPI.

Примеры кода

JavaScript / Node.js

const response = await fetch(
  'https://allratestoday.com/api/v1/rates?source=USD&target=EUR',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const data = await response.json();
console.log(`1 USD = ${data.rate} EUR`);

Python

import requests

response = requests.get(
    'https://allratestoday.com/api/v1/rates',
    params={'source': 'USD', 'target': 'EUR'},
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"1 USD = {data['rate']} EUR")

PHP

$opts = {'http' => {'header' => 'Authorization: Bearer YOUR_API_KEY'}};
$context = stream_context_create($opts);
$response = file_get_contents(
    'https://allratestoday.com/api/v1/rates?source=USD&target=EUR',
    false, $context
);
$data = json_decode($response, true);
echo "1 USD = " . $data['rate'] . " EUR";

cURL

curl "https://allratestoday.com/api/v1/rates?source=USD&target=EUR" \
  -H "Authorization: Bearer YOUR_API_KEY"

Готовы к интеграции?

Получите бесплатный API ключ и начните делать запросы за считанные секунды.

Получить бесплатный API ключ