Опрос API (polling)
Опрос API (polling) — получение свежих данных повторными запросами по расписанию: клиент раз в N секунд сам спрашивает сервер, что изменилось. Так боты и дашборды работают с REST API, который сам ничего не присылает: каждый опрос — обычный HTTP GET.
Интервал и свежесть данных
Опрашивать чаще, чем обновляются данные, бесполезно: сервер вернёт тот же снимок. В Genesis API свежесть данных зависит от тарифа: отдача обновляется раз в 60 секунд на Trial, 30 на Start, 10 на Pro и 5 на Max, и это значение приходит в поле meta.freshness_sec. Время сборки снимка — в meta.updated_at: одинаковое значение в двух ответах подряд значит, что второй запрос был лишним.
Условный пример: на Trial бот опрашивает эндпоинт раз в 10 секунд. Из шести запросов в минуту новые данные несёт один, остальные пять повторяют снимок и списывают квоту, если не присылать If-None-Match.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
while True:
r = requests.get(URL, headers=HEADERS,
params={"min_spread": 1}, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
meta = r.json()["meta"]
print("связок:", meta["count"], "снимок:", meta["updated_at"])
# чаще шага обновления отдачи опрашивать незачем
time.sleep(meta["freshness_sec"])
Сколько вызовов съест опрос
Опрос одного эндпоинта раз в 10 секунд: 2 592 000 ÷ 10 = 259 200 вызовов за 30 дней. Квота Genesis API тоже считается за 30 дней.
| Тариф и квота | Интервал = свежесть | Вызовов на эндпоинт | Эндпоинтов в квоту |
|---|---|---|---|
| Trial, 500 тыс. | 60 с | 43 200 | 11 |
| Start, 2 млн | 30 с | 86 400 | 23 |
| Pro, 5 млн | 10 с | 259 200 | 19 |
| Max, 10 млн | 5 с | 518 400 | 19 |
Расчёт без учёта ответов 304. На Pro 19 эндпоинтов раз в 10 секунд дают в среднем 1,9 запроса в секунду при лимите 5. Разнесите запросы во времени: 19 запросов разом превысят лимит, и сервер ответит ошибкой 429.
Опрос, WebSocket и вебхуки
| Способ | Кто начинает передачу | Когда подходит |
|---|---|---|
| Опрос | Клиент, по расписанию | Данные обновляются с известным шагом, нужен только HTTP-клиент |
| WebSocket | Сервер, по открытому соединению | Непрерывный поток изменений: стаканы и сделки бирж |
| Вебхук | Сервер, запросом на ваш адрес | Редкие события, есть свой публичный HTTPS-адрес |
У Genesis API нет WebSocket и вебхуков: данные отдаются по REST, а свежесть задаёт тариф. Опрос с интервалом meta.freshness_sec — основной способ работы с ним; как сократить трафик и вызовы — в статье «Как опрашивать API без лимитов».
Смотрите также: лимит запросов, тарифы и лимиты в документации, формат ответа, лимиты Genesis API.
Вопросы и ответы
Как часто опрашивать Genesis API?
Не чаще meta.freshness_sec вашего тарифа: раз в 60 секунд на Trial, 30 на Start, 10 на Pro и 5 на Max. Чаще придут те же данные.