Genesis Arbitrage

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

Лимит запросов (rate limit)

Лимит запросов (rate limit) — ограничение того, сколько запросов клиент может отправить к API за единицу времени. Сверх лимита сервер отвечает кодом 429 Too Many Requests из RFC 6585 и может прислать заголовок Retry-After — через сколько секунд повторить (ошибка 429).

Частота и квота

Ограничений обычно два: частота (запросов в секунду или минуту) и квота (вызовов за день или месяц). В Genesis API оба зависят от тарифа:

ТарифЗапросов в секундуВызовов за 30 днейКвоты хватит на пределе
Trial1500 тыс.5,8 дня
Start22 млн11,6 дня
Pro55 млн11,6 дня
Max1510 млн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-ResetUnix-время сброса окна
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 или перейдите на тариф выше.