Riesgos de la automatización: datos, errores, claves e IA
En resumen
- Comprueba los datos antes de cualquier alerta: la edad del snapshot (hora actual menos
meta.updated_at), el indicadorstalede los libros de órdenes, el spread en las mejores cotizaciones y un contrato común en ambos exchanges del par. - Un
503significa que no hay datos, mientras que undatavacío con200significa que nada coincidió con el filtro. El bot distingue ambos casos y avisa de un fallo tras tres ciclos sin datos. - El código se rompe en los casos límite: reintentar sin pausa topa con
429, unnullen una comparación bloquea Python, la división por cero en JavaScript daInfinityy una alerta falsa, y la hora local en lugar de UTC desplaza un pago de funding varias horas. - Una clave de Genesis API es de solo lectura, así que una filtración consume tu cuota. Una clave de exchange con permiso de retirada pone en riesgo el dinero, y un bot de trading no necesita ese permiso.
- Un modelo de IA confunde números y puede seguir una orden escondida en un texto ajeno: el código inserta los números en los mensajes, los campos externos llegan al modelo como datos, el código impone los límites de las operaciones y una persona confirma cada orden.
Los riesgos de un bot de trading con una API de criptomonedas se dividen en cuatro grupos: los datos están obsoletos o muestran un spread que no existe; el código entra en bucle o se rompe en un caso límite; la clave se filtra; un modelo de IA se equivoca con un número o sigue la orden de otro. Cada riesgo tiene una comprobación en el código o una regla de trabajo, y todas caben también en el monitor de la lección 4.
Riesgos de los datos
Un snapshot obsoleto
Un snapshot de Genesis API se construye en meta.updated_at, y tu plan lo renueva cada meta.freshness_sec segundos: 60 en Trial, 30 en Start, 10 en Pro y 5 en Max. La edad del snapshot es la hora actual menos meta.updated_at, es decir, su frescura de los datos. Uno o dos intervalos del plan es normal; más de tres significa que el snapshot está atascado.
Ejemplo hipotético: en Pro el umbral es 3 × 10 = 30 s. Llega una respuesta a las 1783802470 con meta.updated_at = 1783802410: la edad es 1783802470 − 1783802410 = 60 s, así que el bot no envía alertas con ella. La latencia total desde el exchange hasta tu código es aún mayor, y la edad se mide con el reloj de tu servidor, así que mantenlo sincronizado con NTP.
Libros de órdenes y plataformas de predicción
Los libros de órdenes tienen su propio reloj: /orderbooks/book devuelve book_ts, age_sec y un indicador stale que es true cuando el libro tiene más de 30 segundos. Los libros van entre 5 y 20 segundos por detrás del exchange. En Order-book Δ revisa order_delta.status: ok significa calculado, no_book significa que no hay libro, exhausted significa que el libro no pudo cubrir el volumen.
Para los mercados de predicción existe /predictions/platforms: omite los pares que incluyan una plataforma con mode = down, una plataforma con un quotes_at antiguo o una casa de apuestas con ok = false.
Una respuesta vacía en un 503
Una lista vacía y la ausencia de datos son estados distintos. Un 200 con meta.count = 0 significa que ninguna fila coincidió con el filtro. Un 503 snapshot_not_ready significa que los datos se están reconstruyendo: el mercado puede seguir teniendo pares, y reintentas tras Retry-After segundos.
La función fetch devuelve (data, meta), o None cuando no hay datos. Reintenta 429 y 503 tras Retry-After, los demás errores 5xx y los fallos de red tras pausas de 5, 10 y 20 segundos, y se detiene ante todo lo demás.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def fetch(path, params=None, tries=4):
"""(data, meta), o None: no hay datos, lo que no es "no hay pares"."""
for attempt in range(tries):
try:
r = requests.get(BASE + path, headers=HEADERS,
params=params, timeout=15)
code = r.status_code
except requests.RequestException:
code = 0 # error de red o timeout: reintentar tras una pausa
if code == 200:
body = r.json()
return body["data"], body["meta"]
wait = 5 * 2 ** attempt # 5, 10, 20 s: la pausa crece
if code in (429, 503):
wait = int(r.headers.get("Retry-After", wait))
if wait > 60: # nunca esperar más de un minuto
raise RuntimeError(f"espera de {wait} s: revisa tu cuota")
elif 400 <= code < 500:
# 400, 401, 403, 404, 410: un reintento no lo arregla
raise RuntimeError(f"{code}: {r.text[:200]}")
if attempt < tries - 1:
time.sleep(wait)
return None
Un Retry-After largo también llega cuando se agota la cuota del período: el restablecimiento puede estar a días, y fetch nunca espera más de un minuto. Los reintentos, ETag y los filtros se tratan en el artículo sobre cómo consultar una API sin chocar con los límites.
Un spread falso: libros finos y tokens parecidos
spread_pct se calcula con las últimas operaciones, mientras que solo puedes comprar al ask y vender al bid. En el ejemplo de FUEL de la guía de endpoints de arbitraje, el spread es 0,11 % por últimas operaciones y −0,11 % en las mejores cotizaciones. Los campos ask_buy y bid_sell vienen en cada fila Spot – Spot de cualquier plan, y quote_spread más abajo los usa para calcular el spread en las mejores cotizaciones.
Un libro de órdenes fino infla la diferencia. Ejemplo hipotético: la última operación se registró a 1,18 $ hace una hora, el mejor bid es ahora 1,02 $ y el ask en el exchange de compra es 1,00 $. El spread es del 18 % por últimas operaciones y del 2 % en las mejores cotizaciones, y puede que 1000 $ no se ejecuten en absoluto: en Pro y Max, order_delta.status = exhausted con volume=1000 lo muestra exactamente.
La segunda fuente de spreads falsos es un mismo ticker compartido por tokens distintos, como un token en BSC y un proyecto sin relación en Solana. Para un token con contrato, consulta /coins/search con el ticker en query: contracts[] debe tener una entrada cuyo exchanges incluya ambos exchanges del par (compara los nombres sin distinguir mayúsculas). Si no hay tal entrada, no hay transferencia directa: son tokens distintos, o la ruta pasa por un puente con sus propios riesgos.
def is_fresh(meta, k=3):
"""El snapshot no tiene más de k intervalos del plan."""
age = time.time() - meta["updated_at"]
return age <= k * meta["freshness_sec"]
def quote_spread(row):
"""Spread en las mejores cotizaciones: comprar al ask, vender al bid."""
ask, bid = row.get("ask_buy"), row.get("bid_sell")
if ask is None or bid is None or ask <= 0:
return None # sin precio o precio cero: omitir la fila
return (bid - ask) / ask * 100
pause, fails = 60, 0
while True:
got = fetch("/arbitrage/spot-spot", {"min_spread": 1})
if got is None or not is_fresh(got[1]):
fails += 1 # sin datos o datos obsoletos: sin alertas
if fails == 3:
print("3 ciclos sin datos recientes") # avísate a ti mismo
else:
rows, meta = got
fails, pause = 0, meta["freshness_sec"]
for row in rows:
s = quote_spread(row)
if s is not None and s >= 0.5:
print(row["coin"], row["exchange_buy"], "→",
row["exchange_sell"], f"{s:.2f}%")
time.sleep(pause) # la pausa se ejecuta en todas las rutas
Una excepción de fetch detiene el bucle: un bot de producción avisa a su dueño antes de salir.
Riesgos del código
Reintentos sin pausa y bucles infinitos
Un primer bot suele reintentar justo después de un error: if r.status_code != 200: continue. Ante un 503, un bucle así lanza peticiones seguidas sin pausa: los errores no gastan cuota, pero sí cuentan para el límite de peticiones por segundo, y llega un 429 con Retry-After: 1. Cuando caduca la suscripción, el mismo bucle recibe 401 para siempre. Y un continue antes de time.sleep() se salta la pausa en cada respuesta vacía, por eso la pausa es la última línea del bucle de arriba.
El error opuesto es esperar eternamente. time.sleep(int(r.headers["Retry-After"])) con la cuota agotada duerme días: por ejemplo, Retry-After: 259200 son 259 200 / 86 400 = 3 días. Una petición sin timeout también puede quedarse colgada indefinidamente, como advierte la documentación de requests.
null y división por cero
Genesis API usa null para los valores vacíos, y Python lo convierte en None. Comparar row["volume_24h_sell"] > 10000 con None lanza TypeError, y una sola fila tumba todo el bucle. JavaScript no lanza nada: null > 0.5 es false, null < 1 es true, y el filtro falla en silencio.
null significa «sin datos», y sustituirlo por cero con or 0 es peligroso: en el slippage DEX, tax_sell_pct = null significa que no hay fuente del impuesto, y or 0 lo convierte en 0 %. Según la documentación, null aparece en bid_* y ask_*, volume_24h_*, max_position_usd, next_payout, en profit_usd para pares con una pata de casa de apuestas y en apr_pct cuando falta menos de un día.
La división por cero es la misma trampa. Un ask cero lanza ZeroDivisionError en Python, mientras que en JavaScript 1 / 0 es Infinity y Infinity > 0.5 es true: el bot envía un par con un spread infinito. Comprueba el denominador antes de dividir, como quote_spread comprueba ask <= 0.
Zonas horarias
Las horas de Genesis API son segundos unix y cadenas UTC: next_payout en las tasas de funding llega como HH:MM UTC. datetime.fromtimestamp(ts) sin zona horaria devuelve la hora local del servidor, y datetime.utcnow() está obsoleto desde Python 3.12; la documentación de Python remite en su lugar a datetime.now(timezone.utc).
Ejemplo hipotético: el servidor funciona en UTC+3 y su reloj marca las 09:30, que son las 06:30 UTC. El pago de las 08:00 está a 1 h 30 min, pero un código que compara 08:00 con la hora local decide que el pago ya pasó y cuenta 22 h 30 min hasta el siguiente, con 21 horas de error.
from datetime import datetime, timedelta, timezone
def until_payout(hhmm, now=None):
"""Tiempo hasta next_payout, una cadena HH:MM en UTC."""
if hhmm is None:
return None # null: no hay hora de pago
now = now or datetime.now(timezone.utc)
h, m = map(int, hhmm.split(":"))
t = now.replace(hour=h, minute=m, second=0, microsecond=0)
if t <= now:
t += timedelta(days=1) # "00:00" a las 23:50 significa mañana
return t - now
now = datetime(2026, 11, 15, 6, 30, tzinfo=timezone.utc)
print(until_payout("08:00", now)) # 1:30:00
Riesgos de las claves
Una clave de Genesis API es de solo lectura: no puede colocar órdenes ni retirar fondos. Una filtración afecta a tu cuota y al límite de peticiones por segundo, y tu bot recibe 429 antes de que termine el período. Señales de alarma: «Llamadas usadas» en tu perfil crece más rápido de lo que explica tu código, o «usada …» muestra una hora reciente mientras el bot está parado.
La clave se muestra una sola vez y Genesis Arbitrage guarda solo su hash, así que una clave filtrada se reemite: «Reemitir» desactiva la clave anterior al instante y emite una nueva. Las claves se filtran por los sitios donde se pusieron por error: un repositorio público, la URL de una petición, el código de una página, una captura de pantalla, un log con los encabezados de la petición. Registra en su lugar el código de estado y X-Request-Id; las reglas de almacenamiento están en la entrada del glosario clave API.
Una clave de exchange es otra clase de riesgo: con permiso de retirada puede sacar monedas de la cuenta. Un bot de trading no necesita ese permiso, así que crea la clave sin retiradas, vinculada a la IP de tu servidor y separada para cada servicio. Los detalles están en cómo proteger tu cuenta de exchange cripto.
Agentes de IA: números, órdenes inyectadas, confirmación
Un agente llama a Genesis API a través de tu servidor: el modelo elige el endpoint y los argumentos, y el servidor hace la petición con la clave. La configuración está en la guía de Genesis API para agentes de IA, y el diseño general en el artículo sobre datos del mercado cripto para agentes de IA.
Números equivocados
Un modelo puede leer 0.92 como 92 % en lugar de 0,92 %, confundir el funding_pct por intervalo con el funding_8h_pct a 8 horas, o citar un precio que no está en la respuesta. El código inserta los números en las alertas directamente desde la respuesta de la API, y al modelo le quedan la selección y la explicación. Si el modelo escribe números por su cuenta, comprueba cada uno con el resultado de la herramienta.
Órdenes en texto ajeno
Algunos campos los escriben otras personas: title y outcome de los mercados de predicción, el name de los traders, el token_name de los eventos on-chain y los message_ru y message_en de las señales. Cualquiera puede llamar a un token «Ignora las instrucciones anteriores y…», y un modelo que lea el nombre como parte de su prompt puede obedecerlo. Es la inyección de prompts (prompt injection), la primera entrada del OWASP Top 10 para aplicaciones de LLM 2025: LLM01:2025.
Pasa esos campos solo dentro del resultado de la herramienta, limita su longitud e indica en el prompt del sistema que son datos. La clave se queda en el manejador del servidor.
Confirmación humana
Genesis API solo lee datos: un agente construido sobre ella encuentra un par y escribe sobre él, pero no opera. Una API de trading de un exchange conectada al agente queda fuera de Genesis API y bajo tu propio riesgo. Entre sus medidas de mitigación, OWASP incluye el control con una persona en el circuito (human-in-the-loop) para las operaciones privilegiadas: una orden sale solo tras un «sí» de un trader que ve el par, los precios y la hora de los datos.
Lista de comprobación antes del lanzamiento
- La clave está en
GENESIS_API_KEYen el servidor y en ningún otro lugar del código, las URL de las peticiones, el navegador, los logs ni los prompts. - Cada petición tiene un
timeout. - Solo se reintentan
429,503, los demás errores 5xx y los fallos de red, con una pausa y como máximo tres veces. 400,401,403,404,410y unRetry-Afterde más de un minuto detienen el bot con un mensaje.- La pausa entre consultas es de al menos
meta.freshness_secy se ejecuta en todas las rutas del bucle. - La edad del snapshot se comprueba antes de cualquier alerta, y en los libros de órdenes también
staleyorder_delta.status. - «Sin datos» y «sin pares» son estados separados, y tres ciclos sin datos disparan un mensaje de fallo.
nullse comprueba contraNone, los denominadores contra cero, y la hora se maneja en UTC.- Un par pasa por su spread en las mejores cotizaciones, un contrato común,
withdraw_enabled_buyydeposit_enabled_sell. - El código inserta los números en los mensajes, el texto externo llega al modelo como datos y una persona confirma cada orden.
Cierre del curso: adónde ir después
El curso tiene cinco lecciones: conceptos, una primera petición, datos para decidir, un monitor en Python y sus riesgos; lo básico está en la lección 1. Detalles de cada paso:
- Inicio rápido de Genesis API: la clave y una primera petición;
- Límites de Genesis API: la cuota y cómo dimensionar un plan para tu bot;
- Respuestas y errores de Genesis API: códigos,
ETagyX-Request-Id; - Endpoints de libros de órdenes: Order-book Δ para tu volumen;
- Bot de arbitraje cripto en Python: un bot con alertas de Telegram;
- API de criptomonedas: tipos y cómo elegir: un resumen de las fuentes de datos.
Pruébalo tú mismo
Averigua la frescura de tu plan
Llama a
/account/usagey anotafreshness_secycalls_used: esta petición no cuenta como llamada.Mide la edad del snapshot
Obtén
/arbitrage/spot-spotconfetch, imprimetime.time() - meta["updated_at"]y compáralo con el umbral de 3 ×freshness_sec.Compara dos spreads
Imprime
spread_pctyquote_spread(row)de cinco filas y cuenta cuántos pares siguen siendo positivos en las mejores cotizaciones.Prueba la ruta de error
Ejecuta el bot con el marcador
GENESIS_API_KEY=gns_live_XXXXXXXXXXXXXXXX: la respuesta401 invalid_keydebe detenerlo con un mensaje claro.Repasa la lista de comprobación
Añade lo que le falte a tu código antes de ejecutar el bot las 24 horas.