Genesis Arbitrage

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

Свежесть данных

Свежесть данных — возраст данных в момент, когда они пришли к вам: сколько секунд прошло с их сборки до получения ответа. В арбитраже от неё зависит, жив ли ещё спред: связка, посчитанная по ценам минутной давности, могла закрыться до вашего запроса.

Свежесть по тарифам Genesis API

Ядро Genesis Arbitrage обновляет данные каждую секунду, а тариф Genesis API задаёт, как часто обновляется отдача. Значение тарифа приходит в каждом ответе в meta.freshness_sec, время сборки данных — в meta.updated_at (формат ответа).

Тарифfreshness_secОпрос не чаще
Trial60раза в 60 с
Start30раза в 30 с
Pro10раза в 10 с
Max5раза в 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 без лимитов, риски автоматизации, стакан заявок.

Вопросы и ответы

Чем свежесть отличается от задержки?

Задержка — весь путь от события на бирже до вашего кода: публикация биржей, сбор, расчёт, доставка и интервал опроса. Свежесть — та часть, что видна в ответе: сколько прошло со сборки снимка. Ответ сервера может прийти за доли секунды и при этом нести снимок минутной давности.