Genesis Arbitrage

Genesis Arbitrage · · 3 min de lectura

Frescura de los datos

Frescura de los datos es la edad de la información en el momento en que te llega: cuántos segundos pasaron desde que se construyó hasta que recibiste la respuesta. En arbitraje decide si un spread sigue vivo: un par calculado con cotizaciones de hace un minuto puede haberse cerrado antes de tu petición.

Frescura según el plan de Genesis API

El núcleo de Genesis Arbitrage actualiza los datos cada segundo, y tu plan de Genesis API fija con qué frecuencia se actualiza la salida de la API. Cada respuesta incluye el valor de tu plan en meta.freshness_sec y la hora de construcción de los datos en meta.updated_at (formato de respuesta).

Planfreshness_secConsulta como máximo
Trial60una vez cada 60 s
Start30una vez cada 30 s
Pro10una vez cada 10 s
Max5una vez cada 5 s

Si consultas más rápido que freshness_sec, recibes la misma instantánea. Envía el ETag de la respuesta anterior en If-None-Match: si nada cambió, la API responde 304 sin cuerpo y esa respuesta no gasta cuota (ETag e If-None-Match, polling de API). Mientras se reconstruyen los datos recibes 503 snapshot_not_ready; reintenta tras Retry-After segundos.

Libro de órdenes y edad por plataforma

Los libros de órdenes tienen su propia hora. En /orderbooks/book y /orderbooks/coin/{coin} cada libro trae book_ts (hora del libro), age_sec (su edad en segundos) y stale, que es true cuando el libro tiene más de 30 s. Los libros van entre 5 y 20 segundos por detrás del exchange (libro de órdenes del mercado).

age_sec se calcula al construir la respuesta, así que en el momento de recibirla now − book_ts es más preciso. En los mercados de predicción, /predictions/platforms muestra la frescura por plataforma: quotes_at es la hora de sus últimas cotizaciones y full_scan_at, la de su último escaneo completo.

Comprobación en código

Los libros de órdenes están en los planes Pro y Max, pero la comprobación de meta es la misma para todos los endpoints.

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):  # rate limit o reconstrucción
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()
    raise RuntimeError("data not ready")


params = {"exchange": "Binance", "market": "spot", "coin": "BTC"}
body = get_json(params)
now = time.time()
meta = body["meta"]
print(f"edad de la instantánea {now - meta['updated_at']:.0f} s,"
      f" frescura del plan {meta['freshness_sec']} s")

book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
    print("el libro de órdenes está obsoleto, se omite la señal")

Véase también: límites de Genesis API, cómo consultar una API sin chocar con los límites, riesgos de la automatización, libro de órdenes.

Preguntas y respuestas

¿En qué se diferencia la frescura de la latencia?

La latencia es todo el recorrido desde un evento en el exchange hasta tu código: su publicación por el exchange, la recogida, el cálculo, la entrega y tu intervalo de consulta. La frescura es la parte que ves en la respuesta: hace cuánto se construyó la instantánea. Un servidor puede responder en una fracción de segundo y aun así devolver una instantánea de hace un minuto.