Свежесть данных
Свежесть данных — возраст данных в момент, когда они пришли к вам: сколько секунд прошло с их сборки до получения ответа. В арбитраже от неё зависит, жив ли ещё спред: связка, посчитанная по ценам минутной давности, могла закрыться до вашего запроса.
Свежесть по тарифам Genesis API
Ядро Genesis Arbitrage обновляет данные каждую секунду, а тариф Genesis API задаёт, как часто обновляется отдача. Значение тарифа приходит в каждом ответе в meta.freshness_sec, время сборки данных — в meta.updated_at (формат ответа).
| Тариф | freshness_sec | Опрос не чаще |
|---|---|---|
| Trial | 60 | раза в 60 с |
| Start | 30 | раза в 30 с |
| Pro | 10 | раза в 10 с |
| Max | 5 | раза в 5 с |
Опрос чаще freshness_sec вернёт тот же снимок. Передавайте ETag прошлого ответа в If-None-Match: на неизменённые данные API ответит 304 без тела, и такой ответ не тратит квоту (ETag и If-None-Match, опрос API). Пока данные пересобираются, приходит 503 snapshot_not_ready — повторите запрос через Retry-After секунд.
Возраст стаканов и площадок
У стаканов своё время. В ответах /orderbooks/book и /orderbooks/coin/{coin} у каждой книги есть book_ts — время книги, age_sec — её возраст в секундах и stale — признак устаревания: true, если книга старше 30 с. Книги отстают от биржи на 5–20 секунд (стакан рынка).
age_sec посчитан при сборке ответа, поэтому в момент получения точнее взять сейчас − book_ts. Для рынков предсказаний свежесть видна в /predictions/platforms: quotes_at — время последних котировок площадки, full_scan_at — её полного прохода.
Проверка в коде
Стаканы входят в тарифы Pro и Max, а проверка meta одинакова для любого эндпоинта.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/orderbooks/book"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get_json(params, tries=3):
for _ in range(tries):
r = requests.get(URL, headers=HEADERS, params=params,
timeout=10)
if r.status_code in (429, 503): # лимит или пересборка
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()
raise RuntimeError("данные не готовы")
params = {"exchange": "Binance", "market": "spot", "coin": "BTC"}
body = get_json(params)
now = time.time()
meta = body["meta"]
print(f"снимку {now - meta['updated_at']:.0f} с,"
f" свежесть тарифа {meta['freshness_sec']} с")
book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
print("стакан устарел — сигнал не отправляем")
Смотрите также: лимиты Genesis API, как опрашивать API без лимитов, риски автоматизации, стакан заявок.
Вопросы и ответы
Чем свежесть отличается от задержки?
Задержка — весь путь от события на бирже до вашего кода: публикация биржей, сбор, расчёт, доставка и интервал опроса. Свежесть — та часть, что видна в ответе: сколько прошло со сборки снимка. Ответ сервера может прийти за доли секунды и при этом нести снимок минутной давности.