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.

Qué cubre la API
Los endpoints reproducen las secciones del sitio:
- Arbitraje: Spot – Spot, Spot – Futuros, Futuros – Futuros, DEX – Spot, DEX – Futuros, Crosschain y Arbitraje bursátil.
- Libros de órdenes: precios de ejecución para un volumen en cada mercado, «Δ del libro de órdenes» para las filas de arbitraje, el libro de órdenes de un mercado, el historial de ejecución y el slippage en DEX (en los planes de API Pro y Max).
- Mercados de predicción: arbitraje de predicciones y estado de las plataformas; analítica, smart money, operaciones grandes y ranking de traders en los planes de API Pro y Max.
- Funding: tasas de funding de todos los exchanges, spread de funding y analítica histórica del funding (en los planes de API Pro y Max).
- Mercado: Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Tracking.
- On-chain: grandes transferencias, flujos CEX, mint y bridges, billeteras de equipos, posiciones Perp. DEX, unlocks, claims, hackeos; en los planes de API Pro y Max también la vista general de DEX, la analítica y la ficha de la moneda.
- IA y búsqueda: señales de Genesis AI+ y la ficha completa de la moneda.
- Cuenta: el estado de tu clave: plan, cuota usada y límites.
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 API | Llamadas al mes | Frescura de datos |
|---|---|---|
| Trial | 500K | 60 s |
| Start | 2M | 30 s |
| Pro | 5M | 10 s |
| Max | 10M | 5 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
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.
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.Haz una petición
Envía un HTTP GET normal y pasa la clave en el encabezado
X-API-Key. La URL base eshttps://api.genesisarbitrage.com/v1. Un buen primer endpoint es/account/usage: muestra tu plan y la cuota restante.Procesa la respuesta
Una respuesta correcta llega en un único sobre: un array
datay un bloquemeta. 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
datacontiene un array o un objeto, según el endpoint.metacontiene el número de elementos, la hora de la última actualización de los datos, el retraso de tu plan en segundos y tu plan.- Los valores vacíos son
null. Los tiempos están en segundos unix. - Los spreads y las tasas son porcentajes: 0,92 significa 0,92%.
- Todos los parámetros de filtro son opcionales: sin ellos, un endpoint devuelve el conjunto completo de datos.
Errores y límites
| Código | Significado |
|---|---|
| 401 | La clave falta, no es válida o está revocada |
| 403 | El endpoint no forma parte de tu plan |
| 404 | No se encontró el endpoint o el recurso |
| 429 | Límite superado: consulta los encabezados X-RateLimit y Retry-After |
| 500 | Error interno, reintenta más tarde |
| 503 | Los 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
- Clave API: obtener, guardar, reemitir — dónde está la clave en tu perfil y cómo protegerla.
- Límites: cuota, peticiones por segundo, frescura — cómo evitar las respuestas 429.
- Respuestas y errores: JSON, ETag, códigos HTTP — el sobre de respuesta, 304 y reintentos.
- Endpoints por grupo: arbitraje, libros de órdenes, funding, mercado y señales de IA, on-chain, mercados de predicción y surebets.
- Genesis API para agentes de IA — la especificación OpenAPI, llms.txt y function calling.
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.