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

Всё, что нужно для интеграции: аутентификация, лимиты, эндпоинты и схемы ответов.

ДокументацияТарифы и лимиты

Тарифы и лимиты

Лимиты определяются тарифом. Текущее состояние всегда доступно в /account/usage и в заголовках каждого ответа.

TrialStartProMax
Вызовы в месяц500К2 млн5 млн10 млн
Запросы в секунду12515
Свежесть данных60 с30 с10 с5 с

Эндпоинты, не входящие в ваш тариф, возвращают 403 с кодом plan_restricted. Запросы сверх лимитов не тарифицируются.

Вызовом считается только ответ 200. Ответы 304 (данные не изменились) и ошибки 4xx и 5xx квоту не расходуют, но учитываются в лимите запросов в секунду.

Объём скачивания ограничен: не больше 60 МБ сжатых данных за 10 секунд на ключ. Опрос всех наборов с частотой тарифа укладывается с запасом, ответы меньше 64 КБ не считаются. Сверх лимита — 429 download_limited до конца окна, вызов не списывается. Экономьте трафик с If-None-Match, фильтрами и параметром coin.

Заголовки лимитов

ЗаголовокОписание
X-RateLimit-LimitЛимит запросов в секунду для вашего тарифа
X-RateLimit-RemainingСколько запросов осталось в текущем окне
X-RateLimit-ResetUnix-время сброса окна
X-Quota-LimitКвота вызовов на текущий 30-дневный период
X-Quota-RemainingСколько вызовов осталось в периоде
X-Quota-ResetUnix-время обнуления квоты
Retry-AfterЧерез сколько секунд повторить запрос (при 429 и 503)