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 cuota | Intervalo = frescura | Llamadas por endpoint | Endpoints dentro de la cuota |
|---|---|---|---|
| Trial, 500K | 60 s | 43 200 | 11 |
| Start, 2M | 30 s | 86 400 | 23 |
| Pro, 5M | 10 s | 259 200 | 19 |
| Max, 10M | 5 s | 518 400 | 19 |
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étodo | Quién inicia la transferencia | Útil para |
|---|---|---|
| Polling | El cliente, según un horario | Datos que se actualizan con un paso conocido; sirve cualquier cliente HTTP |
| WebSocket | El servidor, por una conexión abierta | Un flujo continuo de cambios: libros de órdenes y operaciones de un exchange |
| Webhook | El servidor, con una petición a tu URL | Eventos 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.