Genesis Arbitrage

Genesis Arbitrage · · 10 min de lectura

Clave de Genesis API: cómo obtenerla, dónde guardarla, cómo reemitirla y revocarla

En resumen

  • Una clave gns_live_… se crea en tu perfil con el botón «Obtener clave» y se muestra una sola vez. Guardamos solo su hash, así que una clave perdida no se recupera: se reemite.
  • La clave va en el encabezado X-API-Key desde tu propio servidor. El código la lee de la variable de entorno GENESIS_API_KEY; nunca va en la URL de una petición ni en el código de un sitio web.
  • Si la clave se filtra, pulsa «Reemitir»: la clave anterior deja de funcionar al instante y la sustituyes en todos tus programas. Cada cuenta tiene una sola clave.

Una clave API de Genesis API es una cadena gns_live_… que funciona como una contraseña: el servidor la usa para identificar tu cuenta y tu plan. La envías en cada petición en el encabezado HTTP X-API-Key; sin clave, o con una incorrecta, la API responde 401 invalid_key. Cada cuenta tiene una sola clave, y la obtienes, reemites y revocas en tu perfil de Genesis Arbitrage.

Dónde está la clave

La clave se gestiona en tu perfil, en el bloque «Genesis API»; los demás bloques del perfil se explican en la guía del perfil de la cuenta. El bloque muestra tu suscripción a la API y el estado de la clave:

Lo que vesQué significa
«Suscripción inactiva», botón «Suscribirse»Todavía no tienes un plan de API; el botón abre los planes
«Suscripción activa», «Activa hasta …», botón «Renovar»El plan está vigente hasta esa fecha
«Suscripción caducada», botón «Renovar»El plazo terminó: la clave se rechaza y los botones de la clave se ocultan hasta que renueves
«Aún no hay clave», botón «Obtener clave»Tienes un plan, pero todavía no una clave
«Clave API» y gns_live_…El comienzo de la clave activa; la clave completa no se vuelve a mostrar
«creada …» · «usada …»Cuándo se creó la clave y cuándo hizo su última petición
«Llamadas usadas», «req/s», «frescura», «se restablece …»Cuota consumida, límite de peticiones por segundo, retraso de los datos y fecha en que se reinicia el contador

El enlace «Documentación» de la esquina del bloque abre la documentación de Genesis API. La cuota y los límites se explican en la guía de límites de Genesis API.

Cómo obtener la clave

  1. Suscríbete a un plan de API

    En la página de precios de Genesis API, elige Trial, Start, Pro o Max y un período, pulsa «Suscribirse» y paga la factura en cripto. El estado en tu perfil cambia a «Suscripción activa».

  2. Pulsa «Obtener clave»

    El botón aparece en el bloque «Genesis API» mientras no tengas clave. La clave se crea al instante.

  3. Guarda la clave de la ventana «Tu clave API»

    La ventana muestra la clave completa una sola vez. Pulsa «Copiar» y guárdala en un gestor de contraseñas o directamente en las variables protegidas de tu servidor. Después de «Listo» ya no podrás ver la clave completa: solo conservamos su hash.

  4. Prueba la clave con una petición

    Llama a /account/usage como en los ejemplos de abajo. Una respuesta 200 con tu plan en data.plan significa que la clave se ha aceptado.

Cómo enviar la clave

La clave va solo en el encabezado X-API-Key. El servidor no lee la clave de parámetros de la URL ni del encabezado Authorization, y responde 401. Los ejemplos leen la clave de la variable de entorno GENESIS_API_KEY; la URL base es https://api.genesisarbitrage.com/v1.

curl:

# la clave viene de una variable de entorno
curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: $GENESIS_API_KEY"

Python 3.10+ con la biblioteca requests:

import os

import requests

# os.environ[...] falla de inmediato si la variable no está definida
key = os.environ["GENESIS_API_KEY"]

r = requests.get(
    "https://api.genesisarbitrage.com/v1/account/usage",
    headers={"X-API-Key": key},
    timeout=10,
)
r.raise_for_status()
print(r.json()["data"]["plan"])

JavaScript, Node.js 18+ con fetch integrado:

// archivo .mjs: los módulos permiten top-level await
const key = process.env.GENESIS_API_KEY;
if (!key) throw new Error('GENESIS_API_KEY no está definida');

const res = await fetch(
  'https://api.genesisarbitrage.com/v1/account/usage',
  { headers: { 'X-API-Key': key } },
);
const body = await res.json();
console.log(res.status, body.data?.plan);

Las tres peticiones devuelven la misma respuesta (valores ilustrativos):

{
  "success": true,
  "data": {
    "plan": "pro",
    "calls_used": 184201,
    "calls_limit": 5000000,
    "rps_limit": 5,
    "freshness_sec": 10,
    "period_resets_at": 1786492800
  },
  "meta": { … }
}

Los campos de la respuesta se describen en la sección Uso de la documentación.

Dónde guardar la clave

Una clave de Genesis API solo lee datos: con ella no se puede operar ni retirar fondos. Una filtración te cuesta otra cosa: programas ajenos consumen tu cuota y tu límite de peticiones por segundo.

Lugar¿Vale?Por qué
Variable de entorno en el servidorSíLa clave queda fuera del código y del repositorio
Un archivo .env incluido en .gitignoreSíLo cargan python-dotenv (load_dotenv()) y node --env-file=.env en Node.js 20.6+
Secretos del hosting y de CISíLa plataforma entrega la clave al programa al arrancar; en GitHub Actions, un secreto del repositorio pasado mediante el env del paso
Gestor de contraseñasSíUna copia de respaldo para una persona
URL de la peticiónNoLas URL acaban en los registros del servidor y del proxy y en el historial del navegador
Código de un sitio web, una extensión o una app móvilNoQuien abra el código fuente de la página o desempaquete la app ve la clave
Repositorio públicoNoLa clave queda en el historial de commits aunque se borre el archivo
Capturas de pantalla, chats, tickets de soporteNoLos mensajes y las imágenes se reenvían

Si los datos tienen que llegar a un navegador, por ejemplo a un panel o a una extensión, tu servidor llama a Genesis API y el navegador recibe de tu servidor el resultado ya elaborado. Soporte necesita el X-Request-Id de la respuesta, la hora de la petición en UTC, el endpoint y el estado, nunca la clave. Las claves de exchange con permisos de trading son más arriesgadas; cómo restringirlas se explica en cómo proteger tu cuenta de exchange cripto.

Reemitir y revocar

BotónQué ocurreCuándo usarlo
«Reemitir»La clave anterior deja de funcionar al instante y la ventana «Tu clave API» muestra una nuevaLa clave se filtró o se perdió, o se fue alguien que la conocía
«Revocar»La clave se desactiva sin sustituta y se cierra el acceso a la API; el bloque vuelve a mostrar «Obtener clave»Ya no necesitas la clave

Ambos botones piden confirmación antes. Los diálogos dicen «¿Reemitir la clave? La clave actual dejará de funcionar de inmediato.» y «¿Revocar la clave? Dejará de funcionar al instante y se cerrará el acceso a la API.», y ofrecen «Cancelar» y «Confirmar». Si la clave se filtró:

  1. Reemite la clave

    Pulsa «Reemitir», luego «Confirmar», y guarda la nueva clave de la ventana «Tu clave API». Desde ese momento, las peticiones con la clave anterior reciben 401.

  2. Sustituye la clave en todos los programas

    Actualiza las variables de entorno, los archivos .env y los secretos de CI y de hosting, y después reinicia los programas: un proceso lee su entorno al arrancar. Si un programa sigue enviando la clave anterior, comprueba si GENESIS_API_KEY ya está definida en el entorno: python-dotenv y node --env-file no sobrescriben con el valor de .env una variable que ya está definida.

  3. Revisa el uso de llamadas

    La línea «Llamadas usadas» de tu perfil o una petición a /account/usage muestra cuántas llamadas se han gastado en este período. Reemitir no reinicia el contador.

401 invalid_key: qué revisar

El servidor responde 401 con el código invalid_key cuando falta la clave, es incorrecta o está revocada, o cuando la suscripción ha caducado:

{
  "success": false,
  "error": {
    "code": "invalid_key",
    "message": "Missing X-API-Key header."
  }
}

Si el encabezado llegó pero la clave se rechazó, message enumera de una vez todos los motivos posibles. Una respuesta 403 plan_restricted significa otra cosa: la clave se acepta, pero el endpoint no forma parte de tu plan. Otros códigos están en la sección Errores y en la guía de respuestas y errores de Genesis API.

El formulario «Probar» de la documentación

Cada endpoint de la documentación tiene un formulario «Probar». Pega la clave en el campo «Tu clave API (gns_live_…)» y pulsa «Enviar petición»: debajo del formulario aparecen el código de estado, el tiempo de respuesta y una respuesta abreviada. La clave se guarda solo en tu navegador y no se envía a ningún sitio salvo la API.

El navegador recuerda la clave y rellena el campo en tu próxima visita, así que no uses el formulario en un ordenador ajeno. Una petición desde el formulario es una llamada normal a la API: consume la cuota y el límite de peticiones por segundo igual que una petición desde código. Tu primera petición desde código, con la respuesta explicada, está en el inicio rápido de Genesis API.

Preguntas y respuestas

¿Puedo tener una clave distinta para cada bot?

No, cada cuenta tiene una sola clave. Todos los programas que la usan comparten la cuota de llamadas y el límite de peticiones por segundo. Si los límites se quedan cortos, sube de plan: abrir varias cuentas para esquivar los límites infringe las reglas.

¿Reemitir reinicia el contador de llamadas?

No. «Llamadas usadas» pertenece a la suscripción de la cuenta, no a la clave: la nueva clave continúa el mismo período de 30 días.

¿Puedo escribir el encabezado en minúsculas, x-api-key?

Sí. Los nombres de los encabezados HTTP no distinguen mayúsculas de minúsculas, según la regla de la RFC 9110, sección 5.1. La clave en sí debe enviarse sin cambios.

¿Necesito una clave nueva tras renovar?

No. Mientras la suscripción está caducada, la clave recibe 401, y tras «Renovar» la misma clave vuelve a funcionar.