Clave de API
Una clave de API es una cadena larga y aleatoria con la que un servicio sabe quién envió una petición: de qué cuenta es, en qué plan está y qué datos puede recibir. Para un programa, la clave funciona como una contraseña: quien conoce la cadena actúa en nombre del propietario.
Cómo se envía la clave
La clave viaja en una cabecera de cada petición, mientras que los filtros van en la URL. En Genesis API la cabecera es X-API-Key y la clave tiene la forma gns_live_…. El ejemplo pide las señales de alpha con nota de Señales de IA:
import os
import requests
key = os.environ.get("GENESIS_API_KEY")
if not key:
raise SystemExit("define GENESIS_API_KEY en el servidor")
r = requests.get(
"https://api.genesisarbitrage.com/v1/ai/signals",
headers={"X-API-Key": key}, # la clave va solo en la cabecera
params={"category": "alpha"}, # los filtros van en la URL
timeout=10,
)
if r.status_code == 401:
# la clave falta, no es válida o fue revocada
print(r.json()["error"]["code"]) # invalid_key
elif r.ok:
print("señales alpha:", r.json()["meta"]["count"])
Se usa una cabecera porque la URL de la petición, con su cadena de consulta, acaba en los registros del servidor web y de los proxies, y en el historial del navegador si alguien la abre en él. La documentación de Genesis API lo dice claro: nunca pases la clave en los parámetros de consulta, nunca la incluyas en el código de un sitio web o de una aplicación y haz las peticiones solo desde tu propio servidor. Los exchanges funcionan igual: Binance recibe la clave en la cabecera X-MBX-APIKEY, y las peticiones de cuenta además se firman con una segunda clave, el API secret.
Cómo guardar la clave
- Guarda la clave en una variable de entorno o en un archivo
.envdel servidor, y añade.enva.gitignore. - Nunca pegues la clave en el código de un sitio web, en una aplicación móvil, en un chat ni en una captura de pantalla.
- Genesis API muestra la clave una sola vez y guarda solo su hash: una clave perdida no se puede recuperar, solo reemitir.
- Si la clave se filtra, pulsa «Reemitir» en tu perfil y la clave anterior deja de funcionar al instante. «Revocar» desactiva la clave sin darte una nueva.
Clave de exchange frente a clave de Genesis API
| Clave de exchange | Clave de Genesis API | |
|---|---|---|
| Permisos | Leer, operar, retirar: lo que actives | Solo lectura de datos |
| Una filtración expone | Operaciones y retiros de tu cuenta | Tu cuota de llamadas |
| Protección | Sin retiros, lista blanca de IP | Reemitir en tu perfil |
Una clave de Genesis API es de solo lectura: no puede colocar órdenes ni retirar dinero. Los errores de clave y sus códigos están en las secciones Autenticación y Errores.
Véase también: API, endpoint, rate limit, clave de API: obtener, guardar, reemitir y revocar.
Preguntas y respuestas
¿Puedo crear varias claves de Genesis API?
No, una cuenta tiene una sola clave. «Reemitir» te da una clave nueva y desactiva la anterior de inmediato.
¿Dónde obtengo una clave de Genesis API?
En tu perfil, en el bloque «Genesis API», una vez que pagas un plan de API. El botón «Obtener clave» abre la ventana «Tu clave de API» con un botón «Copiar».