Лимит запросов (rate limit)
Лимит запросов (rate limit) — ограничение того, сколько запросов клиент может отправить к API за единицу времени. Сверх лимита сервер отвечает кодом 429 Too Many Requests из RFC 6585 и может прислать заголовок Retry-After — через сколько секунд повторить (ошибка 429).
Частота и квота
Ограничений обычно два: частота (запросов в секунду или минуту) и квота (вызовов за день или месяц). В Genesis API оба зависят от тарифа:
| Тариф | Запросов в секунду | Вызовов за 30 дней | Квоты хватит на пределе |
|---|---|---|---|
| Trial | 1 | 500 тыс. | 5,8 дня |
| Start | 2 | 2 млн | 11,6 дня |
| Pro | 5 | 5 млн | 11,6 дня |
| Max | 15 | 10 млн | 7,7 дня |
Последняя колонка считает запросы без пауз на пределе лимита и все ответы 200. Для Pro: 5 × 86 400 = 432 000 запросов в сутки, 5 000 000 / 432 000 ≈ 11,6 дня. Лимит в секунду — потолок для всплесков, а средний темп задаёт квота: в 30 днях 2 592 000 секунд, и Pro выдерживает в среднем 5 000 000 / 2 592 000 ≈ 1,93 запроса в секунду.
Квоту расходуют только ответы 200; ответы 304 и ошибки её не тратят, но входят в лимит запросов в секунду. Отдельно ограничен объём скачивания: 60 МБ сжатых данных за 10 секунд на ключ, сверх — 429 download_limited.
Как работать в пределах лимита
Каждый ответ Genesis API показывает состояние лимитов в заголовках:
| Заголовок | Что показывает |
|---|---|
X-RateLimit-Limit | Лимит запросов в секунду на тарифе |
X-RateLimit-Remaining | Сколько запросов осталось в текущем окне |
X-RateLimit-Reset | Unix-время сброса окна |
Retry-After | Через сколько секунд повторить (при 429 и 503) |
Квоту показывают X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset и эндпоинт «Использование» — /account/usage. Код ниже опрашивает три эндпоинта подряд: когда в окне не осталось запросов, он сам ждёт X-RateLimit-Reset, а на 429 и 503 выдерживает паузу Retry-After.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PATHS = ("/arbitrage/spot-spot", "/funding/spread",
"/market/open-interest")
def poll_once():
for path in PATHS:
r = requests.get(BASE + path, headers=HEADERS, timeout=10)
if r.status_code in (429, 503):
# пауза от сервера, путь заберём в следующем проходе
time.sleep(int(r.headers.get("Retry-After", "1")))
continue
r.raise_for_status()
print(path, "строк:", r.json()["meta"]["count"])
if r.headers.get("X-RateLimit-Remaining") == "0":
# окно исчерпано: ждём его сброса, а не ответа 429
reset = int(r.headers.get("X-RateLimit-Reset", "0"))
time.sleep(max(0.0, reset - time.time()))
while True:
poll_once()
time.sleep(10) # свежесть Pro: чаще опрашивать незачем
Смотрите также: опрос API, свежесть данных, Тарифы и лимиты, лимиты Genesis API, как опрашивать API без лимитов.
Вопросы и ответы
Что будет, если кончилась месячная квота?
Деньги за запросы сверх квоты не списываются. Дождитесь сброса — время в X-Quota-Reset — или перейдите на тариф выше: новый тариф действует сразу, квота считается с нуля, остаток прежнего сгорает.
Можно ли обойти лимит вторым ключом?
Нет. У аккаунта один ключ, а несколько аккаунтов или смена IP ради обхода лимита — нарушение правил. Если вызовов не хватает, сократите лишние фильтрами, параметром coin и ETag с If-None-Match или перейдите на тариф выше.