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

Два вида лимитов

У каждого тарифа есть месячная квота — число тарифицируемых запросов за календарный месяц — и поминутный лимит, который защищает API от всплесков нагрузки. Квоты обнуляются в 00:00 UTC 1-го числа каждого месяца.

Тарифы также различаются интервалом обновления, то есть тем, насколько свежие цены вы получаете. Если опрашивать API чаще этого интервала, вы снова получите те же цены и лишь потратите квоту.

Тарифы вкратце

• Free: 100 запросов в месяц, ежедневное обновление, 10 запросов в минуту
• Lite: 1 000 запросов в месяц, обновление каждые 30 минут, 30 запросов в минуту
• Standard: 10 000 запросов в месяц, обновление каждые 10 минут, 60 запросов в минуту
• Advanced: 50 000 запросов в месяц, обновление каждые 60 секунд, 120 запросов в минуту
• Pro: 100 000 запросов в месяц, обновление каждые 60 секунд, 300 запросов в минуту
• Ultra: 500 000 запросов в месяц, обновление каждые 15 секунд, 600 запросов в минуту
• Business: 500 000 запросов в месяц, обновление каждые 15 секунд, 600 запросов в минуту, а также SLA по времени безотказной работы
• Enterprise: 1 500 000 запросов в месяц, обновление каждые 5 секунд, 1 200 запросов в минуту

Вместе с тарифом расширяются и возможности. Для цен по каратам нужен платный тариф, цены bid/ask доступны начиная со Standard, оповещения через вебхуки — с Advanced, а поток в реальном времени — с Pro. Актуальные цены смотрите на странице тарифов.

Что считается запросом

• Каждый успешный вызов эндпоинта данных считается одним запросом, сколько бы символов он ни возвращал.
• /symbols и /usage бесплатны и никогда не учитываются.
• Запросы, отклонённые с ошибкой 104 (поминутный лимит), 106 (недоступно на вашем тарифе), 107 (источник не разрешён) или с ошибкой сервера (500, 503), не тарифицируются.
• Запросы, завершившиеся ошибкой из-за самого запроса, учитываются. Это ошибки валидации с 201 по 210 и 300 (нет результатов), поэтому проверяйте даты и символы перед отправкой.

Отслеживание использования

Каждый аутентифицированный ответ сообщает состояние квоты в заголовках:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9876
X-RateLimit-Used: 124
X-RateLimit-Reset: 1793491200
X-RateLimit-Reset-Date: 2026-11-01T00:00:00.000Z
X-RateLimit-Plan: Standard
X-RateLimit-Minute-Limit: 60
X-RateLimit-Minute-Remaining: 59

Те же значения есть в объекте rate_limit в теле JSON. reset — метка времени Unix, а reset_date — тот же момент в формате ISO 8601: начало следующего месяца по UTC.

Проверка использования без расхода квоты

Вызывайте /usage из своих дашбордов или систем мониторинга. Это бесплатно:

{
  "success": true,
  "usage": {
    "requests_made": 124,
    "requests_quota": 10000,
    "requests_remaining": 9876,
    "plan": "standard",
    "period_start": "2026-10-01T00:00:00.000Z",
    "period_end": "2026-11-01T00:00:00.000Z"
  },
  "result": { "plan": "Standard", "used": 124, "total": 10000, "remaining": 9876 },
  "rate_limit": {
    "limit": 10000,
    "remaining": 9876,
    "reset": 1793491200,
    "used": 124,
    "plan": "Standard",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Если лимит исчерпан

При превышении любого из лимитов API возвращает HTTP-статус 429 и тело с описанием ошибки:

• 104 too_many_requests: слишком много запросов за текущую минуту. Ответ содержит заголовок Retry-After с числом секунд, которое нужно подождать. Снизьте частоту запросов и повторите попытку.
• 105 quota_exceeded: месячная квота исчерпана. Запросы будут завершаться ошибкой, пока квота не обнулится 1-го числа (UTC). Переход на старший тариф вступает в силу сразу.

{
  "success": false,
  "error": {
    "code": 105,
    "type": "quota_exceeded",
    "info": "User has reached or exceeded his subscription plan's monthly API request allowance"
  }
}

Как уложиться в квоту

• Кешируйте ответы как минимум на время интервала обновления вашего тарифа.
• Запрашивайте все нужные символы одним вызовом, а не отдельным вызовом для каждого символа.
• Опрос каждые 10 минут расходует около 4 500 запросов в месяц, опрос каждую минуту — около 45 000. Выбирайте тариф, соответствующий частоте опроса.
• На тарифе Pro и выше используйте поток в реальном времени вместо опроса, а для реакции на пороговые значения — ценовые оповещения.

Больше советов — в руководстве Лучшие практики.