Gestión y revocación de API Keys de Binance: flujo completo
Las API Keys de Binance son imprescindibles para el trading algorítmico y el arbitraje, pero también son la mayor puerta trasera de la cuenta. Esta guía explica granularidad de permisos, lista blanca de IPs, segmentación lectura/trading/retiro, revocación de emergencia y auditoría.
Las API Keys son la herramienta esencial de los bots de trading algorítmico, arbitraje y grid, y a la vez la principal puerta por la que se han perdido cantidades enormes entre 2024 y 2026. Marcar mal un permiso, olvidar la lista blanca de IPs, dejar la clave escrita en el código o subirla a un repositorio público: cualquiera de estos cuatro fallos puede dejarte sin fondos en 3 minutos. Respondiendo al título: la clave para gestionar las API Keys de Binance está en el principio de mínimo privilegio, la lista blanca de IPs y la rotación periódica. Nunca marques "Permitir retiros" al crear una Key (salvo con automatismos estrictos y controlados), obliga a la lista blanca con 1-3 IPs fijas, separa Key de solo lectura y Key de trading, no comprometas nunca la clave a Git y rota cada 90 días. Si sospechas de una filtración, lo primero es entrar en Binance y borrar la Key; lo segundo, revisar de inmediato el log de auditoría en busca de llamadas anómalas. Esta rutina completa evita el 98% de los incidentes. Este artículo desmenuza cada paso para que puedas aplicarlo tal cual.
Si vas a crear tu primera API Key, entra primero al panel desde el Sitio Oficial de Binance, o usa la App Oficial de Binance (descargable desde la página de descarga) para hacer una verificación por QR antes de continuar. La guía asume que ya completaste el KYC y tienes 2FA activo.
Por qué la API Key es la mayor superficie de ataque
Iniciar sesión por web tiene 2FA, captcha y alertas de inicio inusual: el coste del ataque es alto. Las llamadas API son HTTP firmados sin interacción secundaria; en cuanto Key + Secret se filtren, el atacante se convierte en el dueño legítimo de tu cuenta.
Incidentes típicos publicados entre 2024 y 2026
| Tipo | Origen | Rango de pérdida |
|---|---|---|
| Commit en claro a GitHub | El developer olvidó excluir el config antes del push | De minutos a cientos de miles de dólares. |
| .env expuesto en servidor cloud | Servidor comprometido | Todo el saldo. |
| Log pegado en un grupo de Telegram | Al pedir ayuda, se pega un log con la Key visible | Depende de los permisos. |
| Copiar y pegar en el trabajo en equipo | Se reenvía la Key a un dispositivo no controlado | Depende de la persona. |
| Validación laxa del permiso | Una Key de solo lectura permite consultar datos sensibles | Filtración de datos y base para futuras estafas. |
| Plataforma de estrategia externa desaparece | La plataforma con acceso API se lleva los fondos | Vacía los fondos accesibles. |
R: Cuando una Key se filtra, un atacante prueba todos los permisos en 1 segundo: ¿puedo retirar? ¿puedo transferir? ¿puedo cerrar posiciones? Si algún permiso peligroso está activo, en segundos te vacían la cuenta.
Cronología típica de un incidente
Desde la filtración hasta la pérdida suelen pasar entre 90 segundos y 5 minutos:
- Ocurre la filtración (por ejemplo, un push a GitHub).
- En 30 segundos, bots recolectan la Key desde GitHub.
- En 60 segundos, un script firma y comprueba la validez de la Key.
- En 120 segundos, ese script recorre todos los permisos.
- En 300 segundos, retiran todo lo que puedan.
Aviso de riesgo: aunque borres la Key nada más filtrarse, puede ser tarde. La única defensa real es que la Key nazca ya con permisos mínimos y con lista blanca de IPs; después casi no hay margen para reaccionar.
Granularidad de permisos: visión completa
Actualmente, Binance divide los permisos API en 8 interruptores independientes. Entender qué habilita cada uno es la base de una configuración segura.
Los 8 interruptores
| Permiso | Capacidad concreta | Valor recomendado |
|---|---|---|
| Enable Reading | Consultar saldo, posiciones y órdenes. | Activar según necesidad. |
| Enable Spot & Margin Trading | Enviar y cancelar órdenes en spot y margen. | Solo en la Key de trading. |
| Enable Futures | Enviar y cancelar órdenes de futuros. | Solo en la Key de futuros. |
| Enable Universal Transfer | Transferencias internas entre cuenta maestra y subcuentas. | Desactivado por defecto. |
| Enable Withdrawals | Retirar fondos a direcciones externas. | Salvo necesidad extrema, nunca. |
| Enable Options | Trading de opciones. | Activar según necesidad. |
| Permits Universal Margin | Ajuste global de margen. | Activar según necesidad. |
| Enable Copy Trading | Operaciones de copy trading. | Activar según necesidad. |
R: "Enable Withdrawals" es el permiso más peligroso de todos. Si además la lista blanca de IPs no está activa, el atacante puede vaciarte la cuenta sin obstáculos.
Trampas al combinar permisos
Hay permisos inofensivos por separado que juntos se vuelven peligrosos:
- Reading + Trading: puedes consultar el saldo y operar; un atacante puede "cerrarte" tus propias posiciones para transferirte el riesgo.
- Trading + Universal Transfer: puede mover posiciones perdedoras a otra subcuenta tuya.
- Withdrawals sin lista blanca: es como dejar la puerta abierta para siempre.
Lista blanca de IPs obligatoria
La lista blanca de IPs es la segunda barrera. Con ella activa, aunque se filtren Key y Secret, un atacante desde otra IP no podrá firmar peticiones válidas.
Cómo obtener tu IP fija
- Fibra doméstica: en el panel del router, en WAN IP, pero cuidado con la IP dinámica que cambia a diario.
- Servidor cloud: en la consola aparece la IP pública, normalmente fija.
- Oficina: pídesela al equipo de IT.
- Con VPN: si operas desde una VPN, contrata una IP fija a tu proveedor.
Cómo introducir la lista blanca
- En la pantalla de creación de la Key, ve a "Acceso restringido por IP".
- Elige "Restringir a IPs de confianza (recomendado)".
- Añade entre 1 y 3 IPs, una por línea.
- Al guardar, la Key solo funciona desde esas IPs.
- Cada vez que cambies de servidor, actualiza la lista.
Trampas frecuentes
| Trampa | Síntoma | Solución |
|---|---|---|
| IP doméstica dinámica | La Key funciona a ratos. | Contrata IP fija o VPN cloud. |
| CDN/proxy cambia IP | Fallos en algunas regiones. | Conéctate sin proxy. |
| Cambio de IP en cloud | Todas las llamadas empiezan a fallar. | Consulta la nueva IP y actualiza. |
| IP mal escrita | La Key no funciona tras guardar. | Edita la Key y vigila comas. |
| IPv6 olvidada | Algunas peticiones vía IPv6 fallan. | Añade la IPv6 o fuerza IPv4. |
R: Una API Key sin lista blanca es como pegar la llave de casa en la puerta. Hasta la Key "temporal" para desarrollo debe estar vinculada al menos a una IP.
Segmentación en tres Keys: lectura, trading y retiro
No uses una única Key para todo. Divide en tres Keys por permiso, así una filtración se convierte en pérdida acotada.
Configuración recomendada de las tres Keys
| Uso | Permisos | Lista blanca de IPs | Almacenamiento |
|---|---|---|---|
| Key de solo lectura | Reading | Tu ordenador + servidor cloud | Se puede guardar en claro. |
| Key de trading | Reading + Trading + Futures | IP fija del servidor cloud | Cifrada. |
| Key de retiro | Withdrawals (con lista blanca de direcciones) | Una única IP fija, difícil de cambiar | Dispositivo hardware cifrado y aislado. |
Uso de la Key de solo lectura
- Dashboard de saldo y posiciones.
- Tarea programada que exporta el histórico para la declaración fiscal.
- App móvil de monitoreo.
- Análisis y backtesting.
Filtrar la Key de solo lectura no te hace perder criptos, pero permite al atacante conocer al detalle tu operativa como paso previo a la ingeniería social. Guárdala también con cuidado.
Uso de la Key de trading
- Estrategias algorítmicas.
- Bots de grid.
- DCA automático.
- Arbitraje entre mercados.
Nunca actives el permiso de retiro en la Key de trading. Si tu estrategia mueve fondos entre cuentas, usa "Universal Transfer" en lugar de "Withdrawals".
Uso de la Key de retiro
La mayoría de usuarios no necesita Key de retiro. Solo se justifica en escenarios como:
- Market makers grandes que recargan hot wallets automáticamente.
- Equipos de tesorería que transfieren periódicamente a cold wallets.
- Integraciones entre exchanges.
Aun teniendo esta Key, combínala con la lista blanca de direcciones de retiro para que solo pueda enviar a direcciones ya autorizadas. Consulta Gestión de la lista blanca de retiros si estuviera publicada.
Almacenamiento seguro de las claves
Si Key + Secret están mal guardados, el resto de la configuración no sirve de nada.
Almacenamiento en tres capas
- PC local: usa macOS Keychain / Windows Credential Manager / GNOME Keyring; nada en claro.
- Servidor cloud: AWS Secrets Manager, GCP Secret Manager o HashiCorp Vault.
- Repositorio de código: incluye
.enven.gitignore; usa dotenv o direnv para variables de entorno.
Formas de almacenamiento totalmente prohibidas
- Hardcodearlas en el código.
- Subirlas dentro de un config.json a Git.
- Ponerlas de ejemplo en el README.
- Copiarlas y pegarlas en apps de mensajería.
- Enviar capturas al soporte con la Key visible.
- Guardarlas en un Google Doc compartido.
R: Cada vez que tu Key pasa de "totalmente offline" a "visible en algún servicio online" estás abriendo la puerta.
Segregación en equipos
Si la cuenta la usan varias personas:
| Rol | Key que debería recibir |
|---|---|
| Propietario | Copia íntegra de todas las Keys. |
| Desarrollador cuantitativo | Solo lectura + trading (sin retiro). |
| Analista de datos | Solo lectura. |
| Riesgo | Solo lectura + poder de congelación de emergencia. |
| Auditor externo | Key temporal, revocada al terminar. |
Revocación de emergencia tras una filtración
El instante en que detectas la filtración empieza una carrera contrarreloj.
5 pasos de revocación
- Paso 1: entra a binance.com desde un dispositivo de confianza.
- Paso 2: ve a Cuenta → Gestión de API.
- Paso 3: encuentra la Key comprometida y pulsa "Eliminar".
- Paso 4: la eliminación requiere 2FA + verificación por correo.
- Paso 5: revisa el log de auditoría (ver siguiente sección).
Cómo saber si has sido filtrado
- Google avisa de que en tu GitHub aparece la palabra clave "API secret".
- Recibes un correo de "llamada API anómala" de Binance.
- Ves transferencias Universal Transfer que no hiciste.
- Aparecen órdenes que no colocaste.
- Se liquidan posiciones sin motivo.
Reacción exhaustiva
Si no sabes qué Key se filtró, elimínalas todas:
- Borra todas las Keys existentes.
- Cambia la contraseña maestra.
- Cierra todas las sesiones activas.
- Regenera el 2FA con una semilla nueva.
- Activa la congelación de emergencia durante 24 horas para observar.
R: Antes que dudar sobre "si es o no una filtración real", borra todo y vuelve a crear. Rehacer una Key toma minutos; perder los fondos puede costarte decenas de miles de dólares.
Uso del log de auditoría
Binance ofrece un log completo de llamadas API. Tras una filtración, es imprescindible para entender cómo actuó el atacante.
Cómo acceder al log
- Web: Cuenta → Gestión de API → junto a cada Key, "Log de auditoría".
- Por API: GET /sapi/v1/account/apiRestrictions para consultar el histórico de permisos.
- Historial de operaciones: Cuenta → Extracto → Historial de operaciones vía API.
Qué muestra el log
| Campo | Significado |
|---|---|
| Hora de la llamada | Precisión de segundos. |
| IP origen | IP pública desde la que se hizo la petición. |
| Endpoint | Ruta concreta de la API llamada. |
| Método | GET/POST/DELETE. |
| Código de respuesta | 200/401/403, etc. |
| Parámetros | Con enmascaramiento parcial de datos sensibles. |
Investigación paso a paso
- Identifica en el log la primera IP desconocida.
- Con una herramienta de geolocalización, averigua país y proveedor cloud.
- Extrae todas las llamadas de esa IP.
- Deduce qué permisos probó y hasta dónde llegó.
- Guarda el log completo como prueba para futuras apelaciones.
Refuerzo tras la investigación
Si detectas que una IP probó Withdrawals, aunque sin éxito, sabes que el atacante iba a por ese permiso. Refuerzo posterior:
- Activar sí o sí la lista blanca de direcciones de retiro.
- Aplicar principio de mínimo privilegio en las Keys.
- Actualizar la contraseña maestra.
- Añadir Passkey en cuentas críticas.
- Establecer una auditoría semanal.
Para verificar la seguridad general de tu entorno, apóyate en Verificar el sitio oficial de Binance, la guía de instalación directa del APK Android y la guía de cambio de región en iOS: garantiza primero que el propio entorno de login es seguro.
Ciclo y flujo de rotación de claves
Aunque no haya filtración, hay que rotar. La rotación previene el compromiso gradual y silencioso.
Rotación cada 90 días: ritmo operativo
| Día | Acción |
|---|---|
| Día 0 | Crear la nueva Key con lista blanca y permisos correctos. |
| Día 1 | Salida en canario: migrar estrategia por estrategia. |
| Día 3 | Todas las estrategias en la Key nueva. |
| Día 7 | Se conserva la Key vieja pero ya no se usa. |
| Día 14 | Confirmar cero llamadas y eliminar la Key vieja. |
| Día 90 | Comienza el siguiente ciclo. |
Evita estos errores durante la rotación
- No elimines la Key vieja en el mismo segundo en que despliegas la nueva; deja margen.
- Documenta a qué estrategia pertenece cada Key para no confundirlas.
- Apóyate en un sistema de configuración (Consul, etcd, Kubernetes Secrets) que facilite el cambio.
- Anota cada rotación en un registro; te servirá para la auditoría de fin de año.
Preguntas frecuentes
¿Filtrar una Key de solo lectura es realmente inofensivo?
R: No, no lo es. No pierdes fondos directamente, pero el atacante conoce tu cartera, tus movimientos y tus tiempos. También las Keys de solo lectura merecen gestión estricta; no las trates como "no importa porque son de lectura".
¿Puedo usar CIDR en la lista blanca?
R: No, la lista blanca de Binance solo admite IPs concretas, no rangos CIDR. Si tienes varias IPs dinámicas, añádelas una a una hasta el máximo de 3. Si necesitas rangos, tendrías que dejar "Todas las IPs" y filtrar en tu capa aplicativa, algo poco recomendable.
¿Se puede recuperar una Key eliminada?
R: No. La eliminación es definitiva; Binance no conserva ninguna copia del Secret. Tras borrar, hay que crearla de nuevo y actualizar todas las estrategias.
¿Se puede fijar una fecha de caducidad?
R: Sí, Binance permite ahora fijar una fecha de vencimiento (Expiry Date) de hasta 180 días. Para Keys temporales, ponles 30 días de caducidad: se invalidan solas.
¿Es peligroso "Universal Transfer"?
R: Peligro medio. No permite retirar hacia fuera, solo mover entre tus cuentas y subcuentas y entre carteras spot, futuros y earn. Aun así, un atacante podría desplazar los fondos a otra subcuenta tuya como paso previo a otro ataque. Actívalo entendiendo el riesgo.
¿Es seguro conceder API a una plataforma de estrategias externa?
R: Solo con controles estrictos. Crea una Key exclusiva para esa plataforma, con permisos mínimos, sin retiros, sin Universal Transfer y con la IP fija de la plataforma. En cuanto dejes de usar la plataforma, revoca la Key. Antes de contratar, mira antigüedad, informes de auditoría y comunidad.
¿Existen límites de frecuencia en la API?
R: Sí. Binance aplica límites estrictos de Weight y Order Rate; consulta la documentación. Superarlos bloquea temporalmente la IP durante desde minutos hasta 24 horas. Sustituye las llamadas REST frecuentes por suscripciones WebSocket.
¿La Passkey sustituye a la API Key?
R: No. La Passkey es una credencial de login; la API Key es una credencial de automatización: usos diferentes. Passkey protege el acceso web/app y API Key la actividad programática. Se complementan y ninguna es prescindible.
Reflexiones finales
Gestionar API Keys no es un problema técnico, sino de disciplina. Permisos mínimos, lista blanca de IPs, Keys segmentadas, almacenamiento offline y rotación cada 90 días: cinco medidas que se aplican en pocos minutos y bajan a casi cero la tasa de incidentes.
Cuando termines, entra en Sitio Oficial de Binance para revisar tus API Keys actuales, y aprovecha para descargar la última versión de la App Oficial de Binance desde la página de descarga y montar la monitorización en tiempo real. Complementa con Verificar el sitio oficial de Binance y la guía avanzada antiphishing.
Aviso de riesgo: este artículo trata únicamente sobre "cómo gestionar y revocar las API Keys de Binance" y no constituye asesoramiento financiero. Los criptoactivos son volátiles; toma tus decisiones según tu propio perfil de riesgo. La creación, ajuste de permisos y configuración de lista blanca corren por tu cuenta; nunca envíes el Secret por canales inseguros ni lo subas a repositorios públicos.
Documento publicado el 2026-07-12, próxima revisión prevista para 2026-10-12