Документация Genesis API
Всё, что нужно для интеграции: аутентификация, лимиты, эндпоинты и схемы ответов.
Тарифы и лимиты
Лимиты определяются тарифом. Текущее состояние всегда доступно в /account/usage и в заголовках каждого ответа.
| Trial | Start | Pro | Max | |
|---|---|---|---|---|
| Вызовы в месяц | 500К | 2 млн | 5 млн | 10 млн |
| Запросы в секунду | 1 | 2 | 5 | 15 |
| Свежесть данных | 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-Reset | Unix-время сброса окна | |
X-Quota-Limit | Квота вызовов на текущий 30-дневный период | |
X-Quota-Remaining | Сколько вызовов осталось в периоде | |
X-Quota-Reset | Unix-время обнуления квоты | |
Retry-After | Через сколько секунд повторить запрос (при 429 и 503) |