El permiso de solo lectura de la API de Binance (que la interfaz muestra como Enable Reading) únicamente puede leer datos: no permite crear órdenes, cancelarlas ni retirar fondos, por lo que resulta adecuado para consultar el mercado, conciliar activos y autorizar herramientas de contabilidad de terceros. Para crear una clave, primero inicie sesión en el área de cuenta del Sitio Oficial de Binance; los usuarios de móvil también pueden revisar las claves existentes en la App Oficial de Binance, y los usuarios de iPhone pueden consultar la guía de instalación en iOS. Conviene recordar que una clave de solo lectura no puede mover fondos, pero sí muestra saldos y el historial de operaciones, de modo que sigue siendo información sensible y no debe entregarse a la ligera.
Qué puede y qué no puede hacer el permiso de solo lectura
R: El permiso de solo lectura puede consultar saldos de la cuenta, órdenes abiertas, órdenes históricas, detalles de operaciones, registros de depósitos y registros de retiros. No puede crear órdenes, cancelarlas ni iniciar ningún retiro. Cuando se crea una clave de API en Binance, por defecto solo está marcado el permiso de lectura; los permisos de trading, retiro, futuros y otros deben activarse manualmente.
El valor del acceso de solo lectura está en separar "ver datos" de "mover fondos". Si una clave de solo lectura se entrega a una herramienta de informes, una aplicación de contabilidad o un script propio, un atacante que la obtenga seguirá sin poder transferir activos ni operar en el mercado, de modo que el daño queda limitado a la privacidad.
La tabla siguiente compara las capacidades de los tipos de permiso más habituales. Los nombres y opciones exactos son los que muestre en ese momento la página de gestión de API de Binance:
| Tipo de permiso | Consulta de saldos y registros | Crear o cancelar órdenes | Retirar fondos | Riesgo principal si se filtra |
|---|---|---|---|---|
| Solo lectura (Enable Reading) | Sí | No | No | Se exponen posiciones y hábitos de trading |
| Trading de spot y margen | Sí | Sí | No | Órdenes maliciosas que causan pérdidas |
| Trading de futuros | Sí | Sí (cuenta de futuros) | No | Posiciones maliciosas o liquidación |
| Permitir retiros | Sí | Según otras casillas | Sí | Los activos se transfieren directamente |
La tabla muestra que la clave de solo lectura es la de menor riesgo de las cuatro configuraciones. En los casos en que solo se necesita consultar datos, debe elegirse primero la lectura, en lugar de marcar todos los permisos por comodidad.
En qué se diferencian los datos públicos de mercado y una clave de solo lectura
R: Los endpoints públicos de mercado no necesitan ninguna clave; la clave de solo lectura resuelve el problema de consultar los datos de la propia cuenta. Los endpoints de mercado de Binance, como el último precio, las velas, la profundidad del libro de órdenes y las estadísticas de 24 horas, son datos públicos que cualquiera puede llamar sin iniciar sesión.
Muchos principiantes creen que consultar precios también exige una clave de API, pero basta con una petición HTTP. El siguiente comando consulta directamente el último precio de BTCUSDT:
curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"
La respuesta es un fragmento de JSON con el nombre del par y el último precio negociado. Solo los datos vinculados a una cuenta personal, como saldos, órdenes abiertas y el historial de operaciones, requieren una API Key y una petición firmada.
| Aspecto | Endpoints públicos de mercado | Endpoints con clave de solo lectura |
|---|---|---|
| ¿Requiere API Key? | No | Sí |
| ¿Requiere firma? | No | Sí (HMAC-SHA256) |
| Datos disponibles | Precios, velas, profundidad, operaciones | Saldos, órdenes, operaciones, registros de depósitos y retiros |
| ¿Afecta a la privacidad personal? | No | Sí |
| Uso típico | Seguimiento de gráficos, paneles de mercado, backtesting de estrategias | Conciliación, contabilidad, monitorización de posiciones |
Tres usos típicos del permiso de solo lectura
R: Los tres usos más habituales de una clave de solo lectura son la conciliación de activos, la monitorización de posiciones y la autorización de herramientas de terceros. Ninguno de los tres requiere acceso a los fondos; solo necesitan leer los datos de la cuenta de forma estable.
Uso 1: conciliación de activos
La conciliación de activos consiste en contrastar, partida por partida, los saldos reales de la cuenta de Binance con el libro de cuentas o la hoja de cálculo propios. Al leer la lista de activos mediante el endpoint de solo lectura y sumar los registros propios de compras, ventas, depósitos y retiros, se pueden detectar comisiones omitidas, transferencias sin registrar u operaciones que se olvidó anotar.
Durante la conciliación suelen importar tres cifras: el saldo disponible, el saldo congelado y la valoración. El saldo congelado procede de las órdenes abiertas sin ejecutar; es fácil pasarlo por alto y a menudo hace que el libro no coincida con los datos que devuelve la API.
Uso 2: monitorización de posiciones
La monitorización de posiciones consiste en obtener los activos de la cuenta de forma periódica y multiplicarlos por los precios públicos del mercado para calcular la valoración total. Muchos paneles personales, widgets de pantalla de inicio del móvil y scripts de avisos funcionan así.
Estos scripts solo leen datos, por lo que basta una clave de solo lectura. Tanto si el script se ejecuta en un ordenador personal, en una Raspberry Pi o en un servidor en la nube, no hace falta activar el permiso de trading.
Uso 3: autorizar herramientas de contabilidad e impuestos de terceros
Algunas herramientas de contabilidad, agregación de carteras y preparación fiscal piden a los usuarios una clave de API de solo lectura para sincronizar el historial de operaciones. Esas herramientas no necesitan crear órdenes, así que el permiso de solo lectura es suficiente; si una herramienta pide el permiso de retiro, debe detenerse la autorización de inmediato y comprobarse su procedencia.
Paso 1 a paso 4: crear una clave de API de solo lectura
R: Crear una clave de solo lectura requiere por lo general cuatro pasos: iniciar sesión, abrir la gestión de API, crear y nombrar la clave, y guardar el Secret confirmando los permisos. La posición de los menús en el sitio web y en la aplicación de Binance puede cambiar entre versiones, así que debe seguirse la página que se muestre realmente.
Paso 1: iniciar sesión y preparar la verificación
Primero inicie sesión en el Sitio Oficial de Binance, confirme que la cuenta ha completado la verificación de identidad necesaria y que la autenticación en dos pasos (2FA) está activada. Al crear una clave de API, Binance suele pedir confirmar la operación mediante 2FA, correo electrónico o un código por SMS.
Paso 2: abrir la página de gestión de API
Busque la entrada "Gestión de API" en el centro de la cuenta y elija crear una nueva clave de API. Binance permite elegir el tipo de clave generada por el sistema y escribir una etiqueta para la clave. Una etiqueta que indique el propósito, como "solo lectura - herramienta de contabilidad", facilita distinguir las claves más adelante.
Paso 3: revisar los permisos y vincular una IP
Tras la creación, la página de la clave muestra una lista de permisos. Una clave de solo lectura debe mantener activado "Enable Reading" y comprobarse que los permisos de trading, retiro y demás estén desactivados. También conviene introducir una restricción de acceso por IP para que solo el propio servidor o una dirección de salida fija pueda llamar a la API.
Paso 4: guardar la Secret Key
La API Key puede consultarse en la página en cualquier momento, pero la Secret Key normalmente solo se muestra completa una vez, al crearla. Guarde el Secret de inmediato en un gestor de contraseñas o en un archivo cifrado; no envíe una captura de pantalla a un grupo de chat ni lo escriba en un repositorio de código público. Para conocer opciones de almacenamiento concretas, consulte en este sitio el artículo sobre cómo guardar de forma segura las claves de la API de Binance.
Flujo básico para consultar una cuenta con una clave de solo lectura
R: Una petición de lectura firmada consta de tres partes: la API Key va en la cabecera de la petición, los parámetros incluyen una marca de tiempo y la firma se añade al final de la cadena de consulta. La firma se calcula aplicando HMAC-SHA256 a la cadena de parámetros con la Secret Key.
El siguiente ejemplo en Python lee la clave de las variables de entorno y luego consulta la información de la cuenta de spot:
import os, time, hmac, hashlib, requests
API_KEY = os.environ["BINANCE_API_KEY"]
API_SECRET = os.environ["BINANCE_API_SECRET"]
query = f"timestamp={int(time.time() * 1000)}"
signature = hmac.new(API_SECRET.encode(), query.encode(), hashlib.sha256).hexdigest()
resp = requests.get(
f"https://api.binance.com/api/v3/account?{query}&signature={signature}",
headers={"X-MBX-APIKEY": API_KEY},
)
for item in resp.json()["balances"]:
if float(item["free"]) > 0 or float(item["locked"]) > 0:
print(item["asset"], item["free"], item["locked"])
El código imprime únicamente los saldos distintos de cero. Si una petición devuelve 401 o un error de permisos, primero hay que comprobar si la clave tiene marcado el permiso de lectura y si la IP desde la que se llama está en la lista blanca. Los demás detalles de la firma se explican en el artículo de este sitio sobre cómo generar firmas de la API de Binance.
Los endpoints de lectura habituales incluyen información de la cuenta, órdenes abiertas, historial de órdenes, registros de operaciones de la cuenta, historial de depósitos e historial de retiros. Las rutas y parámetros exactos son los de la documentación oficial de la API de Binance.
Cómo se hace la conciliación de activos en la práctica
R: La conciliación de activos se hace fijando primero un momento de conciliación y contrastando después los datos de la API con los registros propios, partida por partida. Así se evitan los desajustes causados por datos que cambian en tiempo real.
Los pasos siguientes sirven para particulares y equipos pequeños:
- Elija el momento de la conciliación, por ejemplo una hora fija del último día de cada mes, y anote su marca de tiempo.
- Lea mediante el endpoint de solo lectura los saldos disponibles y congelados de cada activo en ese momento.
- Lea los registros de operaciones, depósitos y retiros del periodo.
- Tome el saldo de cierre anterior, sume las entradas del periodo y reste las salidas para obtener el saldo teórico.
- Compare el saldo teórico con el saldo real devuelto por la API y revise las diferencias activo por activo.
Cuando aparecen diferencias, las causas más comunes son comisiones descontadas en otro activo (por ejemplo, al pagar con BNB), conversiones de activos de poco valor, recompensas de promociones acreditadas y transferencias sin registrar entre cuentas (spot, financiación, futuros). Durante la revisión conviene comprobar cada activo por separado en lugar de comparar todo en conjunto.
| Origen de la diferencia | Síntoma típico | Cómo investigarlo |
|---|---|---|
| Descuento de comisiones | El saldo es algo menor de lo esperado | Revisar el activo de la comisión en los registros de operaciones |
| Transferencias entre cuentas | El saldo de spot cambia de repente | Contrastar con el historial de transferencias |
| Recompensas de promociones y airdrops | El saldo muestra una entrada de más | Revisar los registros de fondos y los anuncios |
| Saldo congelado | El saldo disponible parece bajo | Consultar las órdenes abiertas actuales |
| Conversión de activos pequeños | Desaparecen varios activos pequeños | Verificar los registros de conversión |
Riesgos y avisos de seguridad al usar claves de solo lectura
R: Una clave de solo lectura no puede provocar que los fondos se transfieran, pero sí expone las posiciones y el comportamiento de trading, por lo que debe guardarse igualmente como una credencial sensible. Si alguien obtiene información sobre las posiciones, esta puede servir de material para ataques de ingeniería social y estafas de phishing.
Estas son algunas reglas básicas de seguridad:
- No marque los permisos de trading, futuros ni retiro en una clave destinada solo a lectura; cuantos menos permisos, más seguridad.
- Configure una restricción de acceso por IP en la clave para que solo la propia dirección fija pueda usarla.
- Utilice una clave distinta para cada herramienta o script, de modo que cada una pueda revocarse por separado.
- No envíe nunca las claves a quien afirme ser personal de soporte o un servicio de "gestión de cuentas"; Binance nunca solicita oficialmente la Secret Key.
- Si aparecen llamadas anómalas o se deja de usar una herramienta, elimine de inmediato la clave correspondiente en la página de gestión de API.
- Si una herramienta de terceros pide el permiso de retiro, considérelo una señal de alto riesgo y rechace la autorización.
Conviene recordar además que este sitio es un sitio de tutoriales independiente de terceros y no el sitio web oficial de Binance. Los nombres de los permisos de la API, las entradas de las páginas y las restricciones son los que muestren en ese momento las páginas y la documentación oficiales de Binance. Los precios de los criptoactivos fluctúan con fuerza y la inversión conlleva riesgos; los usuarios de China continental deben informarse y cumplir la legislación local al utilizar los servicios relacionados.
Preguntas frecuentes
P: ¿Puede alguien usar el permiso de solo lectura de la API de Binance para retirar fondos? R: No. El permiso de solo lectura no incluye la capacidad de retirar; los retiros requieren el permiso independiente "Permitir retiros". Aun así, si una clave de solo lectura se filtra, se pueden ver las posiciones y los registros de operaciones, por lo que conviene eliminarla y volver a crearla cuanto antes.
P: ¿Necesito una clave de API solo para consultar los precios del mercado? R: No. Los endpoints públicos de mercado, como el último precio, las velas y la profundidad, no necesitan clave ni firma; basta con enviar una petición HTTP.
P: ¿Se puede usar una clave de solo lectura sin lista blanca de IP? R: Se puede, pero no se recomienda. Con una restricción de IP, otras direcciones no pueden usar la clave aunque se filtre. Los usuarios con IP dinámica pueden reenviar las peticiones a través de un servidor en la nube con dirección de salida fija.
P: ¿Puede una clave de solo lectura ver los datos de la cuenta de futuros? R: Una cuenta de futuros suele requerir que se activen por separado las opciones relacionadas con futuros en los permisos de la clave para poder leer sus datos mediante la API. Las opciones exactas son las que muestre la página de gestión de API de Binance.
P: Una herramienta de contabilidad de terceros me pide mi clave de solo lectura. ¿Es seguro? R: En cuanto a permisos, la lectura es relativamente segura, pero hay que confirmar que la herramienta procede de una fuente fiable y tiene una declaración de privacidad clara, crear una clave exclusiva para ella y eliminarla cuando deje de usarse.
P: ¿Qué hago si una llamada de lectura devuelve un error de permisos? R: Primero confirme que la clave tiene marcado el permiso de lectura; después compruebe si la IP desde la que se llama está en la lista blanca y si el reloj del sistema difiere demasiado de la hora del servidor de Binance; por último, verifique que la firma sea correcta.
P: ¿Hay que sustituir la clave de solo lectura con regularidad? R: Es aconsejable rotarla periódicamente y cambiarla de inmediato tras cambios de personal, al retirar una herramienta o ante la sospecha de una filtración. No existe un periodo de rotación universal; conviene fijarlo según la propia tolerancia al riesgo.
Quien aún no tenga cuenta de Binance puede completar primero el registro y la verificación en el Sitio Oficial de Binance y crear después la clave de solo lectura siguiendo los pasos de este artículo; en el móvil se puede instalar la App Oficial de Binance para consultar el estado de las claves en cualquier momento.