Claves y permisos del agente

Un agente IA nunca necesita la clave privada de tu wallet. Dentro de la app, el agente actúa a través de la sesión de tu wallet conectada y solo tras tu confirmación; para un agente o bot externo, crea una API key de Bitnxs con solo las banderas de permisos que necesite. Las API keys de Bitnxs no tienen ningún permiso de retiro.

¿Qué credenciales usa el agente de la app?

Credencial	Dónde se guarda	Qué puede hacer
Tu API key del LLM (p. ej. OpenAI)	Solo en tu navegador (localStorage)	Permite a la página llamar a tu LLM. Bitnxs no la necesita.
Tu sesión de wallet	Se crea al conectar tu wallet	Coloca las órdenes límite que confirmas en el panel del agente.

El agente de la app no usa una “clave de agente” separada.

¿Cómo creo una API key de solo trading para un agente externo?

1. En la app abre More → API Keys y ponle nombre a la clave (p. ej. claude-agent-1; letras, dígitos, _ y -, hasta 32 caracteres).
2. Marca solo los permisos que necesita el agente (ver abajo).
3. Firma una vez el mensaje de derivación en tu wallet. La clave se deriva en tu navegador y se muestra una sola vez; cópiala al almacén de secretos de tu agente.
4. Tu agente firma sesiones con esta clave y pasa la dirección de tu wallet principal como user. Ver Autenticación.
5. Revócala cuando quieras desde More → API Keys; al revocarla terminan sus sesiones.

¿Qué permiten las cuatro banderas?

Bandera	Permite	Dásela a un agente que…
place_orders	POST /session/order, /session/batchOrder	coloca entradas
cancel_orders	POST /session/cancel, /session/modify	gestiona o reprecia órdenes
change_leverage	POST /session/leverage	normalmente desactivada; fija tú el apalancamiento
set_triggers	POST /session/trigger, /session/cancel_trigger	gestiona TP/SL

No existe bandera de retiro, transferencia ni gestión de claves. Una API key no puede retirar fondos ni crear otras claves. Una bandera desactivada devuelve api-key-permission-denied.

Buenas prácticas de seguridad

• Una clave por agente, con etiqueta clara, para revocar una sin afectar a las demás.
• Mínimo privilegio: empieza con place_orders (+ set_triggers si gestiona TP/SL). Deja change_leverage desactivada; el agente de la app tampoco toca el apalancamiento.
• No pongas claves en los prompts. Nunca pegues una API key o frase semilla en un chat con un LLM; cárgala desde una variable de entorno o gestor de secretos.
• Usa una wallet aparte solo con lo que aceptes que un agente opere.
• Baja tú el apalancamiento antes; el agente ajusta por tamaño, no por apalancamiento.
• Respeta los límites: unas 20 escrituras/segundo por firmante (ráfaga de 50); /info y /ws no tienen límite.
• Vigílalo: suscríbete a executionReports por WebSocket y revoca la clave si algo parece mal.
• La app guarda tu API key del LLM en el navegador; usa una clave con límite de gasto y no uses el agente en ordenadores compartidos.