Genesis Arbitrage

Genesis Arbitrage · · 3 мин чтения

Ошибка 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.