Configuración de una clave API de WEEX: cómo conectar de forma segura una plataforma de terceros

Para conectar una plataforma de terceros a WEEX, crea una clave API de WEEX en Cuenta y, después, en Gestión de API; asígnale únicamente los permisos que necesite la plataforma y pega la clave API, la clave secreta y la frase de contraseña en la plataforma. Si la plataforma es un bróker registrado de WEEX, un botón «Iniciar sesión con WEEX» puede hacer lo mismo sin que tengas que gestionar ninguna clave. Esta guía explica ambas opciones, cómo realizar una primera orden segura, los errores más habituales y los ajustes de seguridad que determinan el daño que podría causar una clave filtrada. Los pasos y límites están actualizados a 7 de octubre de 2026.

Conexión rápida o clave API manual de WEEX: qué opción elegir

Usa Conexión rápida cuando la plataforma la ofrezca y, en los demás casos, una clave manual.

Conexión rápida es la autorización OAuth de WEEX, anunciada el 3 de agosto de 2026. Haz clic en «Iniciar sesión con WEEX» en la plataforma asociada, accede a la página de autorización de WEEX, revisa los permisos (el acceso de lectura y el de trading están preestablecidos) y confirma. A continuación, WEEX genera una clave API y la envía al backend de la plataforma. No la ves ni tienes que copiarla. WEEX indica que el proceso tarda menos de 10 segundos.

Hay dos precauciones que debes tener en cuenta. La página de autorización está en www.weex.com, así que comprueba la barra de direcciones antes de aprobar nada. Además, las reglas OAuth de WEEX permiten una clave por usuario para cada plataforma de terceros, por lo que, si vuelves a vincular la misma plataforma, primero tendrás que eliminar la clave anterior.

Una clave manual funciona con cualquier software compatible con WEEX, incluidas las herramientas que no son brókeres, y te da control total sobre los permisos y la vinculación de IP.

Cómo crear una clave API de WEEX paso a paso

1. Inicia sesión en WEEX desde la web. Ve a Cuenta y, después, a Gestión de API; selecciona Crear clave API. La página de WEEX API tiene un botón Crear API que abre la misma pantalla.
2. Pon a la clave el nombre de la plataforma para la que la vas a usar.
3. Crea una frase de contraseña usando únicamente letras y números. Las preguntas frecuentes de WEEX indican que no se aceptan caracteres especiales. No podrás recuperar ni cambiar la frase de contraseña más adelante.
4. Elige los permisos. Las claves nuevas tienen el permiso Solo lectura de forma predeterminada. Añade Spot o Futuros solo si la plataforma va a realizar operaciones en ese mercado. Los dos permisos de trading son independientes, así que un bot de futuros no necesita acceso a spot.
5. Vincula las direcciones IP si la plataforma publica las direcciones desde las que se conecta.
6. Completa la verificación de seguridad.
7. Copia la clave API, la clave secreta y la frase de contraseña, y guárdalas en un lugar seguro. Las guías de configuración de HaasOnline y KoinX advierten que el secreto solo se muestra una vez.

Conviene conocer tres límites. Cada cuenta puede crear hasta 10 grupos de claves API, según la guía de preparación de la integración de WEEX. Una clave nueva o editada tarda unos 15 minutos en activarse en todas partes. Además, la guía de KoinX indica que WEEX puede pedir un cuestionario de activación de API y enviar un correo electrónico de confirmación antes de que la clave funcione; por tanto, que una clave falle durante las primeras horas no significa necesariamente que esté mal configurada.

Vincular la clave y realizar una primera orden

Las plataformas usan nombres distintos para los tres valores. HaasOnline, que añadió WEEX el 22 de agosto de 2026, es un ejemplo típico: abre Cuentas de exchange, selecciona WEEX spot o futuros, introduce la clave API como clave pública y el secreto como clave privada, añade la frase de contraseña y pulsa el botón de prueba de clave. «Clave de acceso» y «clave pública» se refieren a la clave API.

Antes de poner una estrategia en marcha, realiza manualmente una orden a través de la plataforma:

1. Elige un par líquido e introduce el tamaño más pequeño que permita la plataforma, como una orden limitada muy alejada del precio actual.
2. Comprueba que la orden aparezca entre tus órdenes abiertas en la propia WEEX.
3. Cancélala desde la plataforma y confirma que desaparezca de WEEX.

Esta operación de ida y vuelta demuestra que la clave, el permiso y la correspondencia del par funcionan, y no cuesta nada.

Si falla, lo más habitual es que se deba a una de estas causas:

• Error -1052: permisos insuficientes. A la clave le falta el permiso de Futuros o el par no es compatible.
• Errores de permisos en una clave recién creada. Espera los 15 minutos.
• HTTP 429. La plataforma está enviando demasiadas solicitudes. El límite de REST de WEEX es de 500 unidades de peso cada 10 segundos por IP.
• Errores de firma o de frase de contraseña. Se ha pegado uno de los tres valores con un carácter que falta o un espacio de más.
• Solicitudes rechazadas con la vinculación de IP activada. La plataforma se conecta desde una dirección que no está en tu lista.

Las preguntas frecuentes de la API de futuros de WEEX incluyen la lista completa de códigos.

Seguridad de la clave API de WEEX: seis ajustes para limitar los daños

Una clave de trading no permite retirar fondos, pero aun así puede ocasionar pérdidas. En cualquier exchange, se conoce un patrón de abuso en el que un atacante usa una clave robada que solo permite operar para comprar un token ilíquido a precios inflados, desde una cuenta que controla. Estos seis hábitos reducen ese riesgo.

1. Concede los permisos mínimos necesarios. Las herramientas fiscales y de cartera necesitan el permiso Solo lectura. KoinX solicita precisamente ese permiso. Una clave de solo lectura no puede realizar órdenes.
2. Vincula las IP siempre que la plataforma lo permita. La documentación de WEEX indica que las claves sin vinculación de IP «suponen riesgos de seguridad». Algunos servicios no pueden funcionar con una lista fija. KoinX indica a los usuarios que dejen desactivada la restricción de IP. Si una plataforma necesita una clave sin restricciones, mantenla en modo de solo lectura.
3. Usa una clave por plataforma. Con hasta 10 grupos de claves, no hay motivo para compartirlas. Una clave independiente te permite bloquear un servicio sin interrumpir los demás y saber cuál se ha filtrado.
4. Trata la frase de contraseña como un tercer secreto. No la incluyas en capturas de pantalla, mensajes de chat ni solicitudes de asistencia. La recomendación de WEEX es tajante: «No compartas nunca tu frase de contraseña».
5. Rechaza las solicitudes de permisos que vayan más allá del trading. Las guías de integración indican que las claves que crees pueden tener los permisos Solo lectura, Spot y Futuros. Una plataforma que te pida la contraseña de inicio de sesión de WEEX o acceso a retiradas está solicitando algo que no hace falta para operar.
6. Elimina la clave si tienes dudas. WEEX recomienda eliminar de inmediato cualquier clave comprometida. Haz lo mismo con las plataformas que hayas dejado de usar.

Cómo desconectar una plataforma de WEEX

Elimina la clave en la plataforma y, después, bórrala en Gestión de API de WEEX. Este segundo paso es el importante, porque una clave que se haya eliminado solo de los ajustes de la plataforma seguirá funcionando para quien tenga una copia.

Las claves creadas mediante Conexión rápida siguen la misma regla. La guía OAuth de WEEX indica que hay que eliminar la clave existente antes de volver a vincular la cuenta a esa plataforma.

Conectar una plataforma a WEEX lleva unos minutos, y las decisiones que tomes en ese tiempo determinan el riesgo mientras exista la clave: qué permisos tiene, qué IP están autorizadas y si se elimina cuando deja de usarse. Las claves se crean y gestionan desde la página de WEEX API.

Preguntas frecuentes

1. ¿Cuántas claves API puedo crear en WEEX?

Hasta 10 grupos de claves API por cuenta, según la guía de preparación de la integración de WEEX. Es suficiente para asignar una clave propia a cada plataforma conectada y poder revocar el acceso de un servicio sin afectar a los demás.

2. ¿Puedo restablecer una frase de contraseña de WEEX API que haya perdido?

No. La documentación de WEEX indica que una frase de contraseña perdida no se puede recuperar ni modificar. Elimina la clave, crea otra con una frase de contraseña nueva y actualiza la plataforma que la estaba utilizando.

3. ¿Por qué mi nueva clave API de WEEX devuelve un error de permisos?

Las tres causas más habituales son la falta de un permiso de trading, un par que no está cubierto por el mercado de la clave y el tiempo de activación. WEEX indica que las claves nuevas o modificadas tardan unos 15 minutos en activarse; por tanto, vuelve a intentarlo después de ese plazo antes de cambiar los ajustes.

4. ¿WEEX admite conexiones de TradingView o FIX?

Las preguntas frecuentes de la API de futuros de WEEX indican que no se admiten ni la integración con TradingView ni la API FIX. Las conexiones se realizan mediante las interfaces REST y WebSocket, ya sea directamente o a través de una plataforma que las haya integrado.