API key de Binance: permisos, restricción de IP y qué hacer si se filtra
En Binance, los permisos que marcas al crear una API key y la restricción de IP parecen dos ajustes distintos, pero las reglas los atan: una key generada por el sistema sin restricción de IP solo puede leer, y el permiso de retiro no se activa hasta que agregues una restricción de IP en formato IPv4. La primera rige desde el 30/1/2023 a las 0:00 (UTC); las dos siguen en el centro de ayuda de Binance (verificado en noviembre de 2026). Si quieres que una herramienta opere por ti sin fijar una IP, Binance da solo tres salidas: agregar la restricción de IP, pasarte a una key autogenerada Ed25519 o RSA, o desactivar los controles de seguridad predeterminados. Abajo separamos los dos ajustes, qué frena cada uno y qué no, y después vienen el error -2015 y qué hacer si la key se filtra.
- Dos ajustes dentro de una misma key
- Permisos: qué puede hacer la key
- Restricción de IP: desde dónde se puede usar
- Cómo guardar el secreto
- Rotación y limpieza periódica
- El riesgo de las herramientas de terceros
- Error -2015: cuál de las tres causas falló
- Si sospechas una fuga: revocar y rehacer
- Preguntas frecuentes
Dos ajustes dentro de una misma key
Una API key es la llave con la que un programa habla con Binance en tu nombre. Hay dos tipos. La generada por el sistema usa cifrado simétrico HMAC y te entrega dos cadenas: la API Key y la Secret Key. La autogenerada usa Ed25519 o RSA: tú creas el par de claves pública y privada con un software de terceros y a Binance le das solo la pública. Sea cual sea, la herramienta que la tenga puede hacer lo que los ajustes de esa key le permitan.
Lo que define cuánto te cuesta una fuga son dos ajustes que se suelen mezclar:
- Los permisos deciden qué puede hacer la key: leer, operar, retirar, transferir. Lo que esté marcado, lo puede hacer quien tenga la key.
- La restricción de IP decide desde dónde funciona: si cargas direcciones IPv4, los pedidos que vengan de cualquier otro lado se rechazan.
Cada uno falla a su manera. Los permisos no miran quién usa la key; solo limitan lo que puede hacer. La restricción de IP no frena un pedido que sale de una dirección de tu lista, así que si hackean el servidor donde corre tu herramienta, el atacante ya está adentro de la lista blanca. Cuando una key termina mal, casi siempre es porque los permisos quedaron más abiertos de lo necesario y además el secreto se escapó. Para revisar las keys que ya tienes, pásalas por el autochequeo de riesgo de permisos de API.
Permisos: qué puede hacer la key
Los permisos que lista la documentación para desarrolladores de Binance (el endpoint para consultar los permisos de una API key) corresponden a estos interruptores: lectura, trading spot y de margen, retiro, transferencia interna entre la cuenta principal y las subcuentas, transferencia universal, futuros y opciones. Hay unos cuantos más para Portfolio Margin y la API FIX que una herramienta común no toca. La regla es una: marca solo lo que la herramienta use de verdad.
- Ver precios, llevar registro, mirar posiciones: solo lectura. Una key generada por el sistema sin restricción de IP no puede pasar de ahí de todos modos.
- Operar en automático (bots, copy trading): trading spot y de margen, o futuros, según lo que opere la estrategia. El retiro, apagado: una estrategia de trading no tiene por qué sacar fondos.
- Futuros: si creaste la key antes de abrir tu cuenta de futuros, o activaste Portfolio Margin, Binance indica que esa key no puede habilitar el permiso de futuros. Te toca crear otra.
- Retiro: el único interruptor que puede sacar fondos de tu cuenta. No se puede activar sin restricción de IPv4; es un requisito, no una sugerencia.
Los dos permisos de transferencia son los que más se marcan sin pensar. La transferencia interna mueve fondos al instante entre tu cuenta principal y tus subcuentas; la universal autoriza a la key a usar un endpoint de transferencia dedicado para varias monedas compatibles. Los dos mueven plata. La interna queda entre tu cuenta principal y tus subcuentas, así que los fondos no salen de tu nombre, pero el reparto que armaste entre subcuentas se puede desarmar; adónde puede mandar fondos la universal lo define la documentación del endpoint. Si la herramienta no los necesita, apagados también.
La ventaja del permiso mínimo recién se nota después de una fuga: quien tenga una key de solo lectura ve tu saldo y tus órdenes, y no puede mover ni un centavo.
Restricción de IP: desde dónde se puede usar
Con la restricción de IP puesta, la key solo acepta pedidos que salen de las direcciones IPv4 que cargaste y rechaza todo lo demás. Un secreto filtrado no le sirve a alguien que lo intenta desde su propia red.
Cómo se ata a los permisos lo dice el centro de ayuda de Binance:
- Retiro: «Es obligatorio añadir restricciones de acceso a IP (formato IPv4) para habilitar el permiso de retiro».
- Todo lo demás: «Desde el 30/1/2023 a las 0:00 (UTC), el permiso de la clave API generado por el sistema solo puede establecerse en [Habilitar lectura] si tu IP no tiene restricciones».
| Tipo de key | Lectura | Operar y otros permisos | Retiro |
|---|---|---|---|
| Generada por el sistema (HMAC), sin restricción de IP | Sí | No | No |
| Generada por el sistema (HMAC), con restricción IPv4 | Sí | Sí | Se puede activar |
| Autogenerada (Ed25519 / RSA) | Sí | Sí; Binance la cita como una forma de tener otros permisos sin restricción de IP | Igual exige restricción IPv4 |
Fuente: centro de ayuda de Binance, artículo sobre cómo crear claves API (n.º 360002502072, marcado «Última actualización: 20 de marzo de 2025»). Verificado en noviembre de 2026; vale lo que muestre la página en ese momento. El estado de la cuenta igual puede trabar un permiso puntual, como el caso de futuros de arriba.
La tercera salida que lista Binance es desactivar los controles de seguridad predeterminados. Hace justo eso: saca esta protección para que una key sin restricción de IP pueda tener otros permisos. No la recomendamos: si esa key se filtra, funciona desde cualquier lado.
La IP de tu casa cambia: qué conviene
La mayoría de las conexiones hogareñas reciben una IP pública que cambia. Si la fijas, el día que rota la dirección la herramienta deja de conectar; si no la fijas, una key generada por el sistema queda en solo lectura. Para operar en automático hay dos caminos más estables:
- Correr la herramienta en un servidor con IP fija y cargar esa dirección.
- Usar una key autogenerada Ed25519, que puede operar sin restricción de IP.
El segundo pide pensarlo un poco más. Esto es una inferencia nuestra, no algo que diga Binance: una key autogenerada sin restricción de IP tiene una sola cosa entre ella y un atacante, la clave privada que guardas en tu equipo. Dónde está ese archivo y quién puede llegar a él pasa a ser tu única defensa. Nosotros, si hay un servidor con IP fija a mano, vamos por ahí, y dejamos las keys autogeneradas para cuando de verdad no hay una dirección estable.
También vas a encontrar que «las keys sin IP se desactivan a los 90 días». El artículo vigente del centro de ayuda de Binance no dice eso y el endpoint que informa los permisos de una key no tiene ningún campo de vencimiento, así que no lo repetimos acá.
Cómo guardar el secreto
Los permisos y la IP son el colchón para después de una fuga; la primera línea es que no se filtre.
- La key generada por el sistema te da una API Key y una Secret Key. La Secret Key suele mostrarse solo al crearla; el centro de ayuda no lo dice con esas palabras, así que prepárate como si fueras a verla una sola vez: guárdala en el momento en algo como un gestor de contraseñas, nada de chats, notas ni capturas.
- Con una key autogenerada, la clave privada queda siempre contigo y Binance solo tiene la pública. Si alguien copia ese archivo, se lleva la llave en sí.
- No metas la key en el código para después subirlo a un repositorio público. Es una de las formas más comunes de que se escape un secreto: hay bots escaneando repos públicos todo el tiempo.
- Si sospechas que un equipo tiene virus, da por filtradas todas las keys que usaste en él: bórralas y créalas de nuevo.
Rotación y limpieza periódica
Una API key no es de crearla una vez y olvidarse.
- Rótala cada tanto: crea una nueva y borra la vieja. Cuanto más vive una key y en más lugares la pegaste, más chances hay de que se haya filtrado sin que te enteres; empieza por las que tienen permisos amplios.
- Terminaste, borra: esa herramienta que probaste una vez y nunca más abriste todavía tiene tu key. Vuelve y elimínala.
Entra a la gestión de API de Binance y repasa la lista de arriba abajo: ¿cada key sigue en uso? ¿tiene más permisos de los que necesita? ¿tiene restricción de IP? Si dudas, contrástala con el autochequeo de riesgo de permisos de API.
El riesgo de las herramientas de terceros
Cargar una key en una herramienta de terceros es entregarle parte del control de tu cuenta a esa herramienta y a quienes la manejan. La restricción de IP ayuda menos de lo que parece: la herramienta corre en sus propios servidores, la IP que fijaste es la de ese servidor, y si lo hackean el atacante ya está en la lista blanca.
- Usa herramientas con reputación verificable y trayectoria larga. Si el proveedor informa un incidente de seguridad, borra la key que le diste y crea otra.
- Una herramienta que solo debería leer datos y te pide operar o retirar ya es una señal de alarma.
- Quien te pida la Secret Key por privado, diga que es soporte de la herramienta o de Binance, te está estafando. En un flujo normal, tú mismo pegas la key en la página de ajustes de la herramienta.
- Una key por herramienta. Si una falla, borras solo esa y el rastreo queda claro.
Error -2015: cuál de las tres causas falló
Cuando el log de una herramienta muestra -2015, el mensaje completo es Invalid API-key, IP, or permissions for action. (códigos de error oficiales de la API spot de Binance, nombre REJECTED_MBX_KEY). En una sola línea entran tres causas posibles. Revísalas en este orden:
- La key: ¿copiaste mal la API Key, con un espacio de más, o ya la borraste en Binance?
- La IP: ¿la dirección desde la que sale de verdad el pedido está en tu lista? Que la herramienta cambie de servidor o que tu conexión de casa se reconecte la cambia.
- El permiso: ¿está activado el que necesita esa acción? El caso típico es futuros: una key creada antes de abrir tu cuenta de futuros no puede tener ese permiso, así que crea otra.
En foros y en algunas páginas de ayuda de herramientas aconsejan poner la IP en «sin restricción» para probar. No lo arregles así. Con las reglas actuales, una key generada por el sistema sin restricción queda en solo lectura y la orden igual falla; y apagar los controles de seguridad predeterminados para esquivar eso es quitar la protección entera. Encuentra cuál de las tres es y arregla solo esa.
Si sospechas una fuga: revocar y rehacer
Órdenes que tú no pusiste, un equipo donde usaste la key que pudo agarrar virus, una herramienta que anuncia un incidente: con cualquiera de esas alcanza. Sigue este orden:
- Elimina (revoca) esa key ya mismo en la gestión de API de Binance para dejarla inservible. Es eliminar, no solo cambiarle los permisos o la IP; mientras el secreto viejo exista, todavía la pueden usar.
- Revisa la actividad reciente de la cuenta: historial de órdenes, movimientos de fondos y equipos con acceso. Si ves operaciones que no hiciste, el problema va más allá de la API: encáralo entero con el flujo de rescate de cuenta hackeada, cambiando la contraseña de acceso, revisando el 2FA y congelando la cuenta si hace falta.
- Rastrea el origen de la fuga: ¿qué equipo, qué herramienta? Si no cierras eso, la key nueva se puede filtrar igual.
- Rehaz una key más ajustada para la herramienta que sigas usando: solo los permisos que usa y la restricción de IP en un servidor que controles tú.
Un robo por API suele ir de la mano con la seguridad general de la cuenta, así que no te quedes solo en la key. Si sospechas problemas a nivel cuenta, el operativo completo está en la guía completa de rescate de cuenta hackeada; y el autochequeo de riesgo de permisos de API te ayuda a listar los puntos flojos de las keys que te quedan.
Preguntas frecuentes
¿Pueden usar mi API key de Binance para retirar fondos?
Solo si se juntan tres cosas: la key tiene el permiso de retiro, el pedido sale de una IP de su lista blanca y el secreto se filtró, por ejemplo porque hackearon el mismo servidor donde corre tu herramienta. El retiro no se puede activar sin restricción de IPv4, así que con las reglas actuales no existe una key con retiro activado y sin IP. Si no necesitas retirar por API, déjalo apagado; si lo necesitas, fija solo la IP de un servidor que controles tú.
¿Sigue haciendo falta mantener en secreto la API key si ya tiene lista blanca de IP?
Sí. Si el atacante manda pedidos desde una dirección permitida, por ejemplo porque entró a ese mismo servidor, la restricción de IP no lo frena; y si más adelante cambias la config de IP, puede quedar un hueco. Van las tres juntas: permiso mínimo, restricción de IP y secreto bien guardado.
Si sospecho que se filtró la API key, ¿qué hago primero?
Lo primero es eliminar (revocar) esa key en Binance para dejarla inservible, no solo cambiarle los permisos. Después revisa órdenes, fondos y accesos recientes por si hay algo raro, confirma que la cuenta esté sana en general, y recién ahí rehaz una key nueva con permisos más ajustados e IP bien puesta para la herramienta que sigas usando.
¿Puedo usar una misma key en varias herramientas?
No conviene. Crea una key aparte para cada herramienta: si una falla, revocas solo esa sin arrastrar a las demás, y el rastreo queda claro. Una misma key en varias herramientas: una sola fuga las expone a todas.
¿Las opciones de permisos y las reglas de IP pueden cambiar?
Sí, y ya hubo un cambio grande: desde el 30/1/2023 a las 0:00 (UTC), una key generada por el sistema sin restricción de IP solo puede quedar en lectura. Aparte, el retiro exige restricción de IPv4; esa regla no lleva fecha de inicio en el centro de ayuda. Las dos reglas seguían en el centro de ayuda de Binance cuando lo verificamos en noviembre de 2026. Si vuelven a cambiar, vale lo que muestren en ese momento las páginas de creación y gestión de API y el centro de ayuda.
¿Una key sin IP se borra sola a los 90 días?
Muchas guías lo dicen. El artículo vigente del centro de ayuda de Binance sobre cómo crear claves API no lo menciona, así que no lo damos como regla. Si la key sigue existiendo y en qué estado está, lo dice la página de gestión de API.
Fuentes
- Centro de ayuda de Binance · cómo crear claves API (artículo 360002502072, marcado «Última actualización: 20 de marzo de 2025»; verificado el 2026-11-13)
- Documentación de la API spot de Binance · códigos de error, -2015 REJECTED_MBX_KEY (errors.md en GitHub)
- Documentación para desarrolladores de Binance · Get API Key Permission (GET /sapi/v1/account/apiRestrictions), descripción de cada permiso