Genesis Arbitrage

Genesis Arbitrage · · 3 min de lectura

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

Clave de exchange frente a clave de Genesis API

Clave de exchangeClave de Genesis API
PermisosLeer, operar, retirar: lo que activesSolo lectura de datos
Una filtración exponeOperaciones y retiros de tu cuentaTu cuota de llamadas
ProtecciónSin retiros, lista blanca de IPReemitir 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».