---
title: "Документация API"
description: "Полная документация API AllRatesToday для курсов обмена валют. Эндпоинты, аутентификация, примеры кода и руководства по интеграции."
canonical: https://allratestoday.com/ru/docs/
source: AllRatesToday (https://allratestoday.com/) — Markdown mirror of the page above; index of all pages at https://allratestoday.com/llms.txt
generated: 2026-11-16T09:59:58.633Z
---

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

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

## Обзор

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

```
https://allratestoday.com
```

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

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

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

```
Authorization: Bearer YOUR_API_KEY
```

Получите ваш API ключ на [странице профиля](https://allratestoday.com/profile#api-keys) после входа в систему.

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

  **Заголовки квоты приходят только с ответом `429`** Успешные ответы *не* содержат `X-RateLimit-*` или `X-Monthly-*` — не стройте клиент, который читает остаток квоты из ответа `200`. При превышении лимита возвращаются `X-Monthly-Limit`, `X-Monthly-Used` и `X-Monthly-Resets`. Заголовка `Retry-After` нет: используйте поле `resets_at` из тела ответа.

| План | Месячный лимит | Скорость | Аутентификация | Цена |
| --- | --- | --- | --- | --- |
| Free | Бесплатно (**пожизненно**, без сброса) | Без ограничения скорости | API-ключ | Бесплатно |
| Small | 5 000 / месяц | Без ограничения скорости | API-ключ | [См. тарифы](https://allratestoday.com/pricing) |
| Medium | 10 000 / месяц | Без ограничения скорости | API-ключ | [См. тарифы](https://allratestoday.com/pricing) |
| Large | 100 000 / месяц | Без ограничения скорости | API-ключ | [См. тарифы](https://allratestoday.com/pricing) |

Квота бесплатного тарифа **не обновляется** ежемесячно; платные тарифы обновляются 1-го числа каждого месяца в 00:00 UTC. Запрос истории оплачивается по объёму: `period=1y` стоит 12 запросов. Один вызов с `target=EUR,GBP,JPY` — это по-прежнему один запрос. Предупреждение приходит на почту при достижении 90% лимита. Полное описание — в [англоязычной документации](https://allratestoday.com/docs#rate-limits). [Тарифы](https://allratestoday.com/pricing)

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

   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": "mid-market" }
```

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

   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": "mid-market",
  "period": "30d"
}
```

## Курсы центральных банков

Официальные курсы, публикуемые 24 центральными банками (ЕЦБ, ФРС США, Банк Англии, Народный банк Китая, ЦБ Шри-Ланки и другие) — фиксированные, цитируемые курсы для налогов, таможни, аудита и выставления счетов. Подробнее: [обзор и страницы банков](https://allratestoday.com/ru/central-bank-rates-api/), полный справочник в [английской документации](https://allratestoday.com/docs/#central-bank) и [интерактивном API-справочнике](https://allratestoday.com/api-reference/).

- `GET /api/v1/central-banks` — список охваченных банков (все тарифы)
- `GET /api/v1/central-bank/{bank}/latest` — последняя таблица или пара `?source=&target=` (все тарифы)
- `GET /api/v1/central-bank/{bank}/{YYYY-MM-DD}` — таблица на дату, например дату счёта (платные тарифы)
- `GET /api/v1/central-bank/{bank}/history` — ежедневный ряд, до 5 000 строк (платные тарифы)
- `GET /api/v1/central-bank/{bank}/availability` — календарь публикаций банка (все тарифы)

`/latest`, `/history` и `/availability` принимают `?format=csv`. Каждый ответ содержит дату публикации банка (`rate_date`); вычисленные, а не опубликованные пары помечаются `"derived": true`. В выходные и праздники возвращается последняя опубликованная дата.

## Коды ошибок

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

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

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

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

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

Более 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](https://allratestoday.com/openapi.json).

## Примеры кода

### 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 ключ](https://allratestoday.com/login?redirect=/profile)
