Genesis Arbitrage

Genesis Arbitrage · · Actualizado · 6 min de lectura

Inicio rápido de Genesis API: clave, primera petición y límites

En resumen

  • Genesis API es el acceso REST a los datos de Genesis Arbitrage: spreads CEX y DEX, libros de órdenes, funding, cross-chain, flujos on-chain, mercados de predicción y señales de Genesis AI+.
  • Llegar a la primera petición lleva tres pasos: un plan, una clave en tu perfil y una petición GET con el encabezado X-API-Key.
  • Tu plan define la cuota de llamadas, las peticiones por segundo y el retraso de los datos: de 60 segundos en Trial a 5 segundos en Max.

Genesis API ofrece los datos de Genesis Arbitrage como una API REST: spreads entre CEX y DEX, libros de órdenes, funding, cross-chain, flujos on-chain, mercados de predicción y señales de Genesis AI+. Cada herramienta del sitio está disponible como un endpoint propio con un único formato JSON. Para tu primera petición necesitas un plan de API, una clave y un encabezado HTTP: no hace falta SDK, sirve cualquier lenguaje con cliente HTTP.

Inicio rápido de Genesis API: clave, primera petición y límites
Así se ve en Genesis Arbitrage

Qué cubre la API

Los endpoints reproducen las secciones del sitio:

Los conjuntos de datos se describen en la página Genesis API; los parámetros y campos de cada endpoint, en la documentación.

Planes y límites

La API tiene sus propios planes, independientes de la suscripción al sitio: Trial, Start, Pro y Max. Se diferencian en la cuota de llamadas, el límite de peticiones por segundo y la frescura de los datos.

Plan de APILlamadas al mesFrescura de datos
Trial500K60 s
Start2M30 s
Pro5M10 s
Max10M5 s

Trial cuesta 20 $ al mes, y Max permite 15 peticiones por segundo. Los endpoints que no forman parte de tu plan devuelven un error 403 con el código plan_restricted. Las peticiones por encima de los límites no se cobran: espera al nuevo período o mejora tu plan. Solo las respuestas 200 consumen la cuota: los errores y las respuestas 304 son gratuitos. Los precios y la comparación completa están en la página Precios de Genesis API.

Tu primera petición

  1. Elige un plan

    En la página Precios de Genesis API, elige un plan y un período y haz clic en «Suscribirse». El pago es con criptomonedas, igual que la suscripción al sitio. Si ya tienes otro plan de API activo, pagar uno nuevo lo reemplaza y pierdes el resto; el sitio te avisa antes.

  2. Obtén tu clave

    En tu perfil, en el bloque Genesis API, haz clic en «Obtener clave». Aparece una clave gns_live_… en la ventana «Tu clave API»: haz clic en «Copiar» y guárdala. Se muestra una sola vez.

  3. Haz una petición

    Envía un HTTP GET normal y pasa la clave en el encabezado X-API-Key. La URL base es https://api.genesisarbitrage.com/v1. Un buen primer endpoint es /account/usage: muestra tu plan y la cuota restante.

  4. Procesa la respuesta

    Una respuesta correcta llega en un único sobre: un array data y un bloque meta. Si algo falla, consulta la tabla de errores de más abajo.

Un ejemplo con curl:

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_…"

La documentación tiene un formulario «Probar»: pega tu clave, haz clic en «Enviar petición» y verás una respuesta resumida en la propia página. La clave se guarda solo en tu navegador.

Formato de respuesta

Errores y límites

CódigoSignificado
401La clave falta, no es válida o está revocada
403El endpoint no forma parte de tu plan
404No se encontró el endpoint o el recurso
429Límite superado: consulta los encabezados X-RateLimit y Retry-After
500Error interno, reintenta más tarde
503Los datos se están regenerando, reintenta en unos segundos: consulta Retry-After

Los encabezados X-RateLimit de cada respuesta muestran tu límite de peticiones por segundo, cuántas peticiones quedan en la ventana actual y cuándo se reinicia la ventana. Los encabezados X-Quota muestran la cuota de llamadas del período, lo que queda y cuándo se reinicia. Cada respuesta incluye además un X-Request-Id: al contactar con soporte, inclúyelo junto con la hora de la petición en UTC, el endpoint y el estado. No envíes nunca la clave.

Qué sigue

Preguntas y respuestas

¿En qué se diferencia Genesis API de las APIs gratuitas de los exchanges?

Las APIs de los exchanges devuelven los libros de órdenes y los tickers de una sola plataforma. Genesis API devuelve spreads calculados entre decenas de exchanges y redes, flags de depósito y retiro, y datos limpios de pares ilíquidos.

¿Qué pasa si supero el límite?

El servidor responde con 429 y los encabezados X-RateLimit y Retry-After. Las peticiones de más no se cobran.

¿Puedo cambiar de plan de API?

Sí. Un plan nuevo entra en vigor justo después del pago: los nuevos límites y la frescura se aplican de inmediato, la cuota de llamadas empieza desde cero y el resto del plan anterior se pierde. Renovar el mismo plan suma días al período actual.

¿Puedo usar los datos en mi propio producto?

Sí, puedes construir tus propios servicios, bots y dashboards sobre Genesis API. No puedes revender los datos crudos tal cual.