Creación de API Keys en Binance y vinculación de lista blanca de IP en la práctica
Flujo completo para crear una API Key en Binance desde cero y vincular la lista blanca de IP: selección de permisos, notación de rango IPv4 203.0.113.0/24, mecanismo de rotación a 90 días y pasos de emergencia ante una fuga de credenciales, todo explicado de una vez.
El orden correcto para crear una API Key en Binance es: primero inicia sesión y completa el 2FA, entra en la página «Cuenta → Gestión de API», crea una nueva API y ponle un nombre; marca inmediatamente la lista blanca de IP e introduce tu rango IPv4 de salida fijo (por ejemplo, 203.0.113.0/24); marca solo los permisos que necesites entre solo lectura, spot y retirada (por defecto se recomienda solo lectura); guarda el API Secret y haz una copia de seguridad sin conexión. Cada nueva API Key tiene una vigencia de 90 días y debe rotarse al vencer. Sitio Oficial de Binance
Desde la óptica de un desarrollador web, una API Key es una «llave física» que abre las capacidades de la cuenta a scripts, bots de trading o paneles de datos; una vez filtrada equivale a entregar parte del control de la cuenta. Cerrar los permisos al mínimo, apretar al máximo la lista blanca de IP y acortar todo lo posible el ciclo de rotación son las tres reglas de oro. A continuación desglosamos el flujo y explicamos de una vez las reglas de notación de rangos IPv4, los niveles de permiso y la respuesta ante una fuga.
Preparación antes de crear la API Key
Antes hay que tener clara la IP de salida
El requisito previo para vincular la lista blanca de IP es que tú o tu programa tengáis una IPv4 de salida estable; de lo contrario, cada cambio de IP obliga a modificar la lista. Tres situaciones típicas:
- Banda ancha doméstica: en su mayoría IP dinámica, se necesita DDNS o VPN para fijarla; no se recomienda vincular directamente la IP de casa.
- Servidor en la nube: la IP de salida suele ser fija; usa directamente la IPv4 pública asignada por el proveedor.
- Red de oficina: hay que confirmar con el administrador si la salida es una sola IP o un pool de NAT.
Si de momento no dispones de una IP fija, puedes crear la API Key pero sin habilitar los permisos de trading, dejando solo lectura, y liberar permisos gradualmente una vez vinculada la IP.
Nombra según el uso, uno a uno
Usa una API Key distinta para cada script y evita que una sola llave sirva a varios escenarios. Nombres de referencia:
| Nombre de la Key | Uso | Permiso | Observación |
|---|---|---|---|
read-only-portfolio |
Panel de activos que consulta saldos | Solo lectura | Sondeo cada hora |
spot-bot-btc-usdt |
Bot de rejilla en spot | Trading spot | Un solo par |
data-export |
Exporta órdenes diariamente | Solo lectura | Solo se ejecuta una vez |
treasury-withdraw |
Retiros programados a cartera fría | Retirada | Prohibido activar trading |
La ventaja de separarlas es que, si una se filtra, basta con revocar esa entrada sin afectar a los demás scripts, y también facilita auditar la última hora de llamada de cada Key.
Prepara con antelación el 2FA y la verificación por correo
Cada acción de creación, edición o eliminación de una API Key exige código 2FA + confirmación por correo. Si has migrado el 2FA recientemente (véase /posts/biabaweb-2fa-migration/), confirma primero que el nuevo autenticador funciona con estabilidad.
Cómo marcar los niveles de permiso
Los permisos de una API Key de Binance se dividen en varios niveles de arriba abajo; se recomienda marcar según el principio de mínimo privilegio.
Consulta rápida de niveles de permiso
| Permiso | Qué permite | Riesgo | Escenario recomendado |
|---|---|---|---|
| Solo lectura | Consultar saldos, órdenes y operaciones | Bajo | Panel de datos, exportación fiscal |
| Trading spot | Colocar y cancelar órdenes | Medio | Bot de rejilla o arbitraje |
| Trading de futuros | Abrir, cerrar y ajustar apalancamiento | Alto | Estrategias de futuros |
| Préstamo con margen | Pedir prestado y devolver | Alto | Estrategias apalancadas |
| Retirada | Iniciar retiros on-chain | Muy alto | Scripts financieros de salida |
| Cartera universal | Permisos combinados | Muy alto | No recomendado |
Comportamiento por defecto de solo lectura
Con solo lectura marcada, la API Key solo puede ejecutar endpoints GET. Aunque se filtre, el atacante solo verá el saldo y el historial, sin poder mover fondos; junto con la lista blanca, el riesgo de pérdida de activos es prácticamente nulo. Cualquier escenario de análisis de datos debería quedarse en este nivel.
Requisitos extra del permiso de retirada
En cuanto marcas el permiso de retirada, Binance exige: haber vinculado antes la lista blanca de IP; combinarlo con la lista blanca de retiradas a nivel de cuenta (véase /posts/biabaweb-withdrawal-whitelist/); los límites por operación y a 24 horas se comparten con los límites de retirada a nivel de cuenta. Cualquier script que quiera hacer «retirada automática» debe tener ambas listas blancas activas.
Q: ¿Puedo empezar con solo lectura y cambiar a trading una vez esté todo probado? R: Sí, y es un orden muy recomendado. Empieza con solo lectura durante una semana, observa si la IP cambia y si el script es estable; solo cuando todo funcione libera permisos escalón a escalón. Cada liberación pedirá de nuevo 2FA + correo.
Q: Si una Key tiene marcado solo lectura y trading spot a la vez, ¿se suman o se sustituyen? R: Se suman. La solo lectura viene por defecto en toda Key; marcar trading equivale a añadir por encima la capacidad de operar.
Cómo escribir la lista blanca de IP
La lista blanca acepta varias entradas separadas por comas: IP única, varias IPs o rangos CIDR.
Ejemplos habituales
- IPv4 única:
203.0.113.55 - Varias IPv4:
203.0.113.55,203.0.113.56 - Segmento IPv4:
203.0.113.0/24(equivale a 203.0.113.0 hasta 203.0.113.255) - Segmento pequeño:
203.0.113.0/29(8 IPs consecutivas)
Puntos a tener en cuenta:
- Cuanto mayor sea la máscara (menor el número), más IPs cubre y más peligroso resulta; normalmente no bajes de /24.
- No se admite mezclar IPv4 e IPv6 en la lista; usa el protocolo real de tu salida.
- No se admiten nombres de dominio ni hosts DDNS; deben ser IPs numéricas.
- Separa entradas con comas latinas sin espacios en medio.
Cómo confirmar la salida de un servidor en la nube
Si tu despliegue está en la nube, conéctate por SSH y usa un servicio externo de detección de IP para confirmar la salida pública, por ejemplo un endpoint que devuelva la IP en texto plano. No confíes en la «IP pública» que muestra el panel del proveedor, porque algunos separan la IP de entrada y de salida.
Recomendaciones para elegir el rango CIDR
Prioriza el /32 del host (una sola IP) o /29 (8 IPs, útil para autoescalado); evita /24 salvo que realmente escales a gran escala; nunca uses 0.0.0.0/0 ni dejes vacía la lista, dejarla vacía equivale a permitir a cualquier IP y es un riesgo altísimo.
Verificar si la lista blanca está activa
Al terminar de vincular, prueba a llamar a cualquier endpoint con la API Key desde una máquina fuera de la lista blanca; deberías recibir un error claro -2015 o algo similar como «Invalid API-key, IP, or permissions». Recibir ese error confirma que la lista está activa; si aún puedes llamar, quiere decir que la configuración no se guardó o la IP no está vinculada.
Vencimiento a 90 días y rotación
Desde 2023, Binance impone una vigencia obligatoria de 90 días a las API Keys que tengan permisos de trading o retirada. Al vencer, la Key se degrada automáticamente a solo lectura y hay que renovarla o rotarla manualmente.
Cómo rotar correctamente
- Siete días antes del vencimiento, crea una API Key nueva con los mismos permisos, IP y notas.
- Despliega el Access Key / Secret Key nuevos en el script y cambia las variables de entorno.
- Observa 24 horas y confirma que la nueva Key funciona con normalidad.
- Al vencer, elimina la Key antigua de inmediato; no la conserves «por si acaso».
Las ventajas: hay 24 horas de convivencia sin interrupción; la antigua se destruye al vencer, reduciendo la superficie de fuga.
No dependas de la renovación automática
Aunque Binance ofrece un botón de «Ampliar vigencia», depender de la renovación automática implica que el Access Key / Secret Key no cambian nunca, y cualquier fuga histórica se convierte en una fuente de riesgo permanente. La rotación periódica es la mejor higiene de claves.
Combinación con la lista blanca de retiradas
Si la Key implica retiradas, al rotarla no hace falta rehacer la lista blanca de retiradas; el libro de direcciones a nivel de cuenta es independiente de la Key. Pero sí conviene hacer un ensayo completo: prueba una retirada mínima con la nueva Key hacia una dirección de la lista blanca y confirma que la cadena es correcta antes de escalar.
Emergencia por fuga de credenciales
Cuando detectes o sospeches una fuga de la API Key, sigue este orden y en 5 minutos podrás minimizar las pérdidas.
- Abre «Cuenta → Gestión de API» y elimina la Key sospechosa.
- Cierra todas las sesiones (marca «Cerrar sesión en otros dispositivos» en la página de login).
- Cambia inmediatamente la contraseña de inicio de sesión.
- Revisa «Seguridad → Historial de accesos» y «Seguridad → Registro de operaciones» buscando anomalías.
- Revisa el «Historial de fondos» buscando operaciones o retiradas no autorizadas.
- Restablece el 2FA (opcional, si sospechas intrusión en la cuenta).
- Abre un ticket para explicar la situación desde el sitio oficial de Binance.
- En el plazo de una semana haz una revisión de seguridad completa: lista blanca, 2FA, API y correo vinculado.
Análisis posterior
¿Cómo se filtró la Key? Canales habituales:
- Subida a un repositorio público de GitHub.
- Escrita en un archivo de configuración que se envió por chat.
- Script de despliegue que incluía la Key y se desplegó en varias máquinas.
- Empleado que dejó la empresa sin que se le retiraran los permisos.
- Uso de herramientas de desarrollo con función de captura o subida de logs.
Haz un análisis de causa raíz de cada fuga y mejora los procesos para evitar la siguiente.
Aviso de riesgo: cualquier cuenta que te contacte espontáneamente en redes sociales prometiendo «montarte una rejilla API por ti» es un intento de phishing. Cualquiera que te pida el Access Key o el Secret Key por mensaje privado es, sin excepción, un fraude. App Oficial de Binance solo desde los canales oficiales; para reconocer la autenticidad consulta también /posts/binance-anti-phishing-real-fake/.
Preguntas frecuentes
¿Cuántas API Keys puede crear como máximo una cuenta?
La cuenta principal admite actualmente hasta 30 API Keys; las subcuentas cuentan por separado. En la práctica se recomienda no tener más de 5 activas a la vez; limpia periódicamente las sobrantes para reducir la carga operativa.
¿Pueden las subcuentas crear sus propias API Keys?
Sí. Las subcuentas gestionan de forma independiente su lista de API y su lista blanca de IP, con permisos aislados de la cuenta principal. Es muy útil para aislar entornos institucionales: una subcuenta por estrategia, una Key por IP.
¿Qué hago si olvido el Secret Key?
No se puede recuperar. El API Secret solo se muestra una vez al crearlo, Binance no guarda una copia en claro; si lo pierdes solo queda eliminarlo y volver a crearlo. Recuerda anotarlo enseguida en un gestor de contraseñas o archivo cifrado al crearlo.
¿Puede otra persona usar mi API Key desde su IP?
No, si tienes vinculada la lista blanca. Aunque el atacante obtenga Access Key + Secret Key, al llamar desde una máquina fuera de la lista fallará al momento. Este es el valor esencial de la lista blanca.
¿Puedo seguir usando la Key antigua tras el vencimiento?
Sí, pero se degrada a solo lectura. Para recuperar los permisos de trading o retirada hay que pulsar «Ampliar» y rehacer la verificación 2FA. No es recomendable en producción; conviene rotar proactivamente a una Key nueva.
¿Cambia el límite de peticiones según la lista blanca?
No. El límite es a nivel de cuenta y es independiente de la lista blanca de IP. Si activas el límite con frecuencia, hay que optimizar la frecuencia de llamada o pedir una cuota mayor; vincular más IPs no lo soluciona.
¿Se pueden poner rangos CIDR en la lista blanca?
Sí. Con la notación 203.0.113.0/24. Pero cuanto mayor sea el rango, más peligro; si puedes usar /32, no uses /24, y si puedes /29, tampoco.
Tengo despliegues en varias regiones cloud, ¿cómo gestiono las listas blancas?
Se recomienda una API Key independiente por región vinculada a la IP de salida de esa región. Así, al cambiar de zona solo tocas la Key correspondiente y localizar problemas es más rápido. No es recomendable atar una sola Key a múltiples segmentos multi-nube: dificulta el diagnóstico y aumenta la superficie de ataque.
Documento publicado el 2026-07-01, próxima revisión prevista para 2026-10-01.