Ошибка 429 Too Many Requests
Ошибка 429 Too Many Requests — код ответа HTTP: клиент отправил слишком много запросов за отрезок времени и упёрся в лимит запросов. Код введён в RFC 6585 в 2012 году. Как считать запросы — по ключу, IP-адресу или ресурсу, за секунду или за час, — стандарт не задаёт: каждый сервис решает сам.
Как обработать 429
Функция запрашивает спред фандинга и повторяет запрос после ответов 429 и 503:
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get_with_retry(params, attempts=5):
delay = 1
for _ in range(attempts):
r = requests.get(URL, headers=HEADERS,
params=params, timeout=10)
if r.status_code not in (429, 503):
r.raise_for_status()
return r.json()["data"]
wait = r.headers.get("Retry-After", "")
# пауза от сервера, иначе 1, 2, 4… секунд
time.sleep(int(wait) if wait.isdigit() else delay)
delay = min(delay * 2, 60)
raise RuntimeError("лимит не отпускает: опрашивайте реже")
rows = get_with_retry({"min_spread": 0.05})
print("монет со спредом фандинга от 0,05 %:", len(rows))
Удвоение паузы называют экспоненциальной задержкой (exponential backoff). Повтор без паузы почти наверняка снова получит 429. Если запросы шлют несколько копий бота, добавьте к паузе случайную долю секунды, чтобы их повторы не приходили одновременно.
429 в Genesis API
Genesis API отвечает 429 с одним из двух кодов в теле ответа и с заголовком Retry-After:
| Код | Когда | Что сделать |
|---|---|---|
rate_limited | Превышен лимит запросов в секунду: от 1 на Trial до 15 на Max | Подождать Retry-After, разнести запросы во времени |
download_limited | Больше 60 МБ сжатых данных за 10 секунд на ключ | Подождать конца окна, сузить выборку фильтрами и coin |
{
"success": false,
"error": {
"code": "rate_limited",
"message": "Requests per second limit exceeded."
}
}
Запросы сверх лимитов не тарифицируются: вызовом считается только ответ 200, а 429, как и другие ошибки, квоту не тратит. Но ошибки учитываются в лимите запросов в секунду, поэтому частые повторы сами вызывают новые 429. Остаток лимита в текущем окне показывает заголовок X-RateLimit-Remaining, остаток квоты — X-Quota-Remaining.
Смотрите также: опрос API, ETag и If-None-Match, ошибки в документации Genesis API, лимиты Genesis API.
Вопросы и ответы
Чем 429 отличается от 503?
429 значит, что вы спрашиваете слишком часто. 503 с кодом snapshot_not_ready в Genesis API значит, что данные пересобираются или их источник перезапускается: повторите запрос через Retry-After секунд.
Почему 429 приходит, если бот шлёт мало запросов?
Лимит считается на ключ: два скрипта с одним ключом делят его. Ещё одна причина — частые полные выгрузки без фильтров, которые упираются в лимит объёма download_limited.