Latencia
La latencia es el tiempo entre un evento en el mercado y el momento en que los datos sobre él llegan a tu código. Ejemplo hipotético: una operación se registra en un exchange a las 12:00:00 y tu script recibe el nuevo precio a las 12:00:12, una latencia de 12 segundos.
De qué se compone la latencia
| Etapa | Qué añade tiempo |
|---|---|
| Exchange | Publicar una operación o un cambio del libro en su API |
| Recogida | Recibir datos por WebSocket o REST, reconexiones |
| Cálculo | Casar exchanges, recalcular spreads y libros |
| Entrega | El paso de actualización de salida del plan y la red hasta tu servidor |
| Tu código | El intervalo de consulta y el procesamiento de la respuesta |
Algunas de estas etapas se ven en los campos de respuesta de Genesis API. meta.updated_at es el momento en que se construyó la instantánea, y meta.freshness_sec es el retraso de salida de tu plan: 60, 30, 10 o 5 segundos. Los libros de órdenes tienen sus propios marcadores: age_sec es la antigüedad del libro y stale señala un libro de más de 30 segundos; los libros van con 5–20 segundos de retraso respecto al exchange (libro de órdenes del mercado en la documentación).
Precios desfasados en el arbitraje
Ejemplo hipotético: una instantánea tomada hace 15 segundos muestra una moneda a $10,00 en el exchange A y a $10,12 en el exchange B.
| Momento | Precio en A | Precio en B | Spread |
|---|---|---|---|
| En la instantánea | $10,00 | $10,12 | 1,2 % |
| En el exchange ahora | $10,00 | $10,03 | 0,3 % |
Dos operaciones con una comisión de taker del 0,1 % cada una se llevan un 0,2 %, así que, en lugar del 1,2 % de la instantánea, quedan solo un 0,1 %. Cuanto mayor es la latencia, más a menudo un bot ve un spread que ya ha desaparecido del exchange.
Tiempo de respuesta y frescura de los datos
El tiempo de respuesta del servidor y la frescura de los datos, es decir, hace cuánto se construyó la instantánea, son números distintos. Ejemplo hipotético: la respuesta llega en 0,2 segundos, pero la instantánea que contiene tiene 9 segundos. Puedes medir ambos:
import os
import time
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"coin": "BTC"},
timeout=10,
)
r.raise_for_status()
meta = r.json()["meta"]
# tiempo de respuesta: desde enviar la petición hasta analizar los encabezados
print("response time:", round(r.elapsed.total_seconds(), 2), "s")
# antigüedad de los datos: tiempo desde que se construyó la instantánea
print("data age:", round(time.time() - meta["updated_at"]), "s")
La antigüedad de los datos se calcula con el reloj de tu servidor: si el reloj se desvía, el error pasa al resultado, así que mantén la hora sincronizada (NTP).
Véase también: API polling, WebSocket, formato de respuesta, riesgos de la automatización: datos desfasados, errores, claves.
Preguntas y respuestas
¿Cuál es la latencia de Genesis API?
La salida se actualiza cada 60 segundos en Trial, 30 en Start, 10 en Pro y 5 en Max; el valor exacto para tu clave llega en meta.freshness_sec. Tu intervalo de consulta y la red se suman a él.