Главная Документация Тарифы Статус API
Регистрация

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

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

Обзор

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

https://allratestoday.com

Мы предлагаем как бесплатный публичный эндпоинт (без аутентификации), так и эндпоинты с аутентификацией с более высокими лимитами запросов.

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

Публичный эндпоинт (/api/public/rates) не требует аутентификации — просто вызовите его.

Для эндпоинтов с аутентификацией передайте ваш API ключ как Bearer токен:

Authorization: Bearer YOUR_API_KEY

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

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

Заголовки лимитов запросов Все ответы содержат заголовки лимитов запросов: X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset.
План Лимит Аутентификация
Публичный (бесплатный) 100 запросов / час на IP Нет
С аутентификацией (бесплатный) 100 запросов / минута на ключ Bearer токен

Публичные курсы

GET /api/public/rates

Бесплатный публичный эндпоинт — аутентификация не требуется. Идеально подходит для AI-чатботов, быстрых интеграций и прототипирования.

ПараметрТипОписание
fromобязательный string Код исходной валюты (например, USD, EUR)
toобязательный string Код целевой валюты (например, GBP, INR)
amountнеобязательный number Сумма для конвертации (по умолчанию: 1)

Пример запроса:

curl "https://allratestoday.com/api/public/rates?from=USD&to=EUR&amount=100"

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

{
  "success": true,
  "from": { "currency": "USD", "amount": 100 },
  "to": { "currency": "EUR", "amount": 92.15 },
  "rate": 0.9215,
  "inverse_rate": 1.0852,
  "timestamp": "2026-04-03T12:00:00Z",
  "source": "AllRatesToday.com",
  "type": "mid-market rate",
  "disclaimer": "This is the mid-market rate. Actual transfer rates may vary.",
  "rateLimit": { "remaining": 99, "limit": 100 }
}
CORS включен Этот эндпоинт поддерживает кросс-доменные запросы — вы можете вызывать его напрямую из браузера.

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

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": "wise" }

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

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"
{
  "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": "wise",
  "period": "30d"
}

Коды ошибок

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

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

Более 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/public/rates?from=USD&to=EUR'
);
const data = await response.json();
console.log(`1 USD = ${data.rate} EUR`);

Python

import requests

response = requests.get(
    'https://allratestoday.com/api/public/rates',
    params={'from': 'USD', 'to': 'EUR'}
)
data = response.json()
print(f"1 USD = {data['rate']} EUR")

PHP

$response = file_get_contents(
    'https://allratestoday.com/api/public/rates?from=USD&to=EUR'
);
$data = json_decode($response, true);
echo "1 USD = " . $data['rate'] . " EUR";

cURL

# Public endpoint (no auth)
curl "https://allratestoday.com/api/public/rates?from=USD&to=EUR&amount=500"

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

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

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

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