Genesis Arbitrage

Genesis Arbitrage · · 3 min de lectura

API polling

El API polling es obtener datos recientes mediante peticiones repetidas según un horario: cada N segundos el cliente pregunta al servidor qué ha cambiado. Así trabajan los bots y paneles con una API REST, que nunca envía nada por iniciativa propia: cada consulta es un simple HTTP GET.

Intervalo y frescura de los datos

Consultar más rápido de lo que se actualizan los datos no aporta nada: el servidor devuelve la misma instantánea. En Genesis API, la frescura de los datos depende del plan: la salida se actualiza cada 60 segundos en Trial, 30 en Start, 10 en Pro y 5 en Max, y ese valor llega en el campo meta.freshness_sec. La hora de construcción de la instantánea está en meta.updated_at; el mismo valor en dos respuestas seguidas significa que la segunda petición fue inútil.

Ejemplo hipotético: en Trial un bot consulta un endpoint cada 10 segundos. De las seis peticiones por minuto solo una trae datos nuevos; las otras cinco repiten la instantánea y consumen cuota igualmente, salvo que el bot envíe 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("pairs:", meta["count"], "snapshot:", meta["updated_at"])
    # consultar más rápido que el paso de actualización del plan no sirve de nada
    time.sleep(meta["freshness_sec"])

Cuántas llamadas consume el polling

Consultar un endpoint cada 10 segundos: 2 592 000 ÷ 10 = 259 200 llamadas en 30 días. La cuota de Genesis API también abarca 30 días.

Plan y cuotaIntervalo = frescuraLlamadas por endpointEndpoints dentro de la cuota
Trial, 500K60 s43 20011
Start, 2M30 s86 40023
Pro, 5M10 s259 20019
Max, 10M5 s518 40019

El cálculo ignora las respuestas 304. En Pro, 19 endpoints cada 10 segundos suponen de media 1,9 peticiones por segundo frente a un límite de 5. Reparte las peticiones: 19 peticiones a la vez superarían el límite y el servidor respondería con HTTP 429.

Polling, WebSocket y webhooks

MétodoQuién inicia la transferenciaÚtil para
PollingEl cliente, según un horarioDatos que se actualizan con un paso conocido; sirve cualquier cliente HTTP
WebSocketEl servidor, por una conexión abiertaUn flujo continuo de cambios: libros de órdenes y operaciones de un exchange
WebhookEl servidor, con una petición a tu URLEventos poco frecuentes, si tienes un endpoint HTTPS público

Genesis API no tiene WebSocket ni webhooks: los datos se sirven por REST y el plan fija la frescura. Consultar a meta.freshness_sec es la forma estándar de trabajar con ella; las formas de reducir tráfico y llamadas están en Cómo consultar una API sin chocar con los límites.

Véase también: rate limit, planes y límites en la documentación, formato de respuesta, límites de Genesis API.

Preguntas y respuestas

¿Con qué frecuencia debo consultar Genesis API?

No más a menudo que el meta.freshness_sec de tu plan: cada 60 segundos en Trial, 30 en Start, 10 en Pro y 5 en Max. Consultar más rápido devuelve los mismos datos.