⏱️ Лимиты и тарификация

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

60 запросов в минуту на аккаунт. Лимит общий для всех методов /api и /api/v1: и создание проверок, и опрос результатов расходуют один и тот же бюджет.

При превышении возвращается 429 Too Many Requests с заголовками:

📦 Как проверять пачку адресов

При старте интеграции или подключении нового кошелька легко упереться в лимит: 50 адресов — это 50 запросов на создание, почти всё минутное окно.

• Разносите создание проверок во времени: не более ~50 запросов в минуту, с запасом на опрос результатов.
• Опрашивайте результаты списком, а не по одной проверке: GET /api/fast-check?limit=50&updated_from=… — это один запрос вместо пятидесяти.
• Уважайте Retry-After: при 429 подождите указанное число секунд, а не повторяйте запрос сразу.

⌛ Время выполнения проверки

Проверки выполняются асинхронно и в порядке очереди, одна за другой. Одна проверка занимает от нескольких секунд до пары минут. При постановке 50 адресов сразу последний результат может появиться через несколько минут — закладывайте таймаут ожидания около 10 минут, а не секунды.

Подробности про статусы и признак готовности — в разделе Жизненный цикл проверки и статусы.

💳 Тарификация

Стоимость одной проверки возвращается в поле price (по умолчанию 1, либо цена вашего тарифного плана), остаток — в поле balance и в GET /api/user/balance. Единственное исключение — бесплатные суточные проверки мобильного приложения, они действуют до первого пополнения и к интеграциям по API-ключу не относятся.

Если баланса не хватает, метод возвращает 402 и проверка не ставится в очередь:

{
  "status": false,
  "message": "Недостаточно баланса"
}

Для отслеживаемых адресов нехватка баланса означает, что суточный прогон по адресу в этот день будет пропущен — следите за остатком через GET /api/user/balance.