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-Keydesde tu propio servidor. El código la lee de la variable de entornoGENESIS_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 ves | Qué 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
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».
Pulsa «Obtener clave»
El botón aparece en el bloque «Genesis API» mientras no tengas clave. La clave se crea al instante.
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.
Prueba la clave con una petición
Llama a
/account/usagecomo en los ejemplos de abajo. Una respuesta200con tu plan endata.plansignifica 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 servidor | Sí | La clave queda fuera del código y del repositorio |
Un archivo .env incluido en .gitignore | Sí | Lo cargan python-dotenv (load_dotenv()) y node --env-file=.env en Node.js 20.6+ |
| Secretos del hosting y de CI | Sí | 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ñas | Sí | Una copia de respaldo para una persona |
| URL de la petición | No | Las 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óvil | No | Quien abra el código fuente de la página o desempaquete la app ve la clave |
| Repositorio público | No | La clave queda en el historial de commits aunque se borre el archivo |
| Capturas de pantalla, chats, tickets de soporte | No | Los 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ón | Qué ocurre | Cuándo usarlo |
|---|---|---|
| «Reemitir» | La clave anterior deja de funcionar al instante y la ventana «Tu clave API» muestra una nueva | La 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ó:
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.Sustituye la clave en todos los programas
Actualiza las variables de entorno, los archivos
.envy 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 siGENESIS_API_KEYya está definida en el entorno: python-dotenv ynode --env-fileno sobrescriben con el valor de.envuna variable que ya está definida.Revisa el uso de llamadas
La línea «Llamadas usadas» de tu perfil o una petición a
/account/usagemuestra 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."
}
}
- El encabezado no llegó. «Missing X-API-Key header.» significa que la petición no llevaba ninguna clave. Comprueba el nombre del encabezado y si la variable está definida donde se ejecuta el programa: en el servidor, en el contenedor, en la tarea programada.
- La clave está alterada. Un espacio de más, comillas dentro del valor o un final cortado dan
401: la clave debe coincidir carácter por carácter. - La clave se reemitió o se revocó. Compara el comienzo de la clave de tu programa con el que muestra tu perfil en «Clave API».
- La suscripción caducó. Tu perfil muestra «Suscripción caducada». Tras «Renovar», la misma clave vuelve a funcionar, sin necesidad de reemitirla.
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.