API для разработчиков

Получайте курсы валют в реальном времени и исторические данные через наш REST API. Простая интеграция, надежные данные.

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

Все API запросы требуют аутентификации с помощью Bearer токена в заголовке Authorization:

Authorization: Bearer YOUR_API_KEY

Ограничение запросов

API запросы ограничены до 100 запросов в минуту на IP адрес. Заголовки с информацией о лимитах включены во все ответы:

X-RateLimit-Limit - Максимум запросов в минуту
X-RateLimit-Remaining - Оставшиеся запросы в текущем окне
X-RateLimit-Reset - Unix timestamp сброса лимита

Эндпоинты

GET /api/v1/rates

Получить курсы обмена. Возвращает все курсы без параметров или конкретную пару с source/target.

Параметры запроса

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

Пример ответа

[
  {
    "rate": 1.0856,
    "source": "USD",
    "target": "EUR",
    "time": "2026-01-09T12:00:00Z"
  }
]

Ответы с ошибками

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

Начало работы

1. Получите API ключ

Зарегистрируйтесь или войдите для получения API ключа.

Запросить API ключ

2. Сделайте первый запрос

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

3. Обработайте ответ

[
  {
    "rate": 1.0856,
    "source": "USD",
    "target": "EUR",
    "time": "2026-01-09T12:00:00Z"
  }
]

Готовы начать?

Запросите API ключ сегодня и начните интеграцию курсов валют в реальном времени.

Запросить API ключ

JavaScript / Node.js

const response = await fetch(
  'https://allratestoday.com/api/v1/rates?source=USD&target=EUR',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const rates = await response.json();
console.log(`1 USD = ${rates[0].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'}
)

rates = response.json()
print(f"1 USD = {rates[0]['rate']} EUR")

PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,
    'https://allratestoday.com/api/v1/rates?source=USD&target=EUR');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$rates = json_decode($response, true);
echo "1 USD = " . $rates[0]['rate'] . " EUR";

Пример исторических данных

// Получить историю курса USD/EUR за последнюю неделю
const response = await fetch(
  'https://allratestoday.com/api/v1/rates?' + new URLSearchParams({
    source: 'USD',
    target: 'EUR',
    from: '2026-01-02',
    to: '2026-01-09',
    group: 'day'
  }),
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const history = await response.json();
// Возвращает массив дневных курсов