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

Para conectar una plataforma de terceros a WEEX, crea una clave API de WEEX en Cuenta y luego en Administración de API, asígnale únicamente los permisos que necesita 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, el botón «Iniciar sesión con WEEX» puede hacer lo mismo sin que tengas que manejar una clave. Esta guía explica ambas opciones, cómo realizar una primera orden de forma segura, los errores más comunes y los ajustes de seguridad que determinan cuánto daño puede causar una clave filtrada. Los pasos y límites están actualizados al 7 de oct. de 2026.

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

Usa Conexión rápida cuando la plataforma la ofrezca y una clave manual en cualquier otro caso.

Conexión rápida es la autorización OAuth de WEEX, anunciada el 3 de ago. de 2026. Haz clic en «Iniciar sesión con WEEX» en la plataforma asociada, ve a la página de autorización de WEEX, revisa los permisos (el acceso de trading y de lectura están preconfigurados) y confirma. Luego, WEEX genera una clave API y la envía al backend de la plataforma. Nunca la ves ni la copias. WEEX indica que el proceso toma menos de 10 segundos.

Hay dos advertencias. La página de autorización está en www.weex.com, así que revisa la barra de direcciones antes de aprobar cualquier cosa. Además, las reglas de OAuth de WEEX permiten una clave por usuario para cada plataforma de terceros; por eso, 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, luego a Administración de API y selecciona Crear clave API. La página de API de WEEX tiene un botón Crear API que abre la misma pantalla.
2. Ponle a la clave el nombre de la plataforma para la que la usarás.
3. Configura una frase de contraseña que use solo 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 por defecto el permiso Solo lectura. Agrega Spot o Futures únicamente si la plataforma 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 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 la clave secreta 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 para la integración de WEEX. Una clave nueva o editada tarda alrededor de 15 minutos en activarse en todas partes. Además, la guía de KoinX señala que WEEX puede solicitar un cuestionario de activación de API y enviar un correo de confirmación antes de que funcione una clave; por eso, si una clave falla 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 agregó WEEX el 22 de ago. de 2026, es un ejemplo típico: abre Cuentas de exchange, elige WEEX Spot o Futures, ingresa la clave API como clave pública y la clave secreta como clave privada, agrega la frase de contraseña y presiona el botón para probar la clave. «Clave de acceso» y «clave pública» significan lo mismo que clave API.

Antes de dejar que una estrategia se ejecute, realiza una orden manual desde la plataforma:

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

Este recorrido de ida y vuelta confirma que la clave, los permisos y la correspondencia del par funcionan, y no cuesta nada.

Cuando falla, normalmente se debe a una de estas causas:

• Error -1052, permisos insuficientes. La clave no tiene el permiso de Futures o el par no es compatible.
• Errores de permisos con una clave recién creada. Espera los 15 minutos.
• HTTP 429. La plataforma está enviando demasiadas solicitudes. El límite REST de WEEX es de 500 unidades de peso cada 10 segundos por IP.
• Errores de firma o frase de contraseña. A uno de los tres valores le falta un carácter o se pegó con un espacio de más.
• Solicitudes rechazadas con la vinculación de IP activada. La plataforma se está conectando 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 que limitan los daños

Una clave de trading no puede retirar fondos, pero aun así puede hacerte perder dinero. El patrón de abuso conocido en cualquier exchange consiste en que un atacante use 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 esa exposición.

1. Concede los permisos mínimos. Las herramientas de impuestos y de portafolio necesitan el permiso Solo lectura. KoinX solicita exactamente eso. Una clave de solo lectura no puede realizar órdenes.
2. Vincula IP siempre que la plataforma lo permita. La documentación de WEEX dice que las claves sin vinculación de IP «representan riesgos de seguridad». Algunos servicios no funcionan con una lista fija. KoinX indica a los usuarios que desactiven 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 razón para compartirlas. Una clave independiente te permite desconectar un servicio sin afectar a los demás y saber cuál se filtró.
4. Trata la frase de contraseña como un tercer secreto. No la incluyas en capturas de pantalla, mensajes de chat ni tickets de soporte. La recomendación de WEEX es clara: «Nunca compartas 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 Solo lectura, Spot y Futures son los permisos para las claves que creas. Si una plataforma te pide la contraseña de inicio de sesión de WEEX o acceso a retiros, te está pidiendo algo que no se necesita para hacer trading.
6. Elimínala si tienes dudas. WEEX recomienda eliminar de inmediato cualquier clave comprometida. Haz lo mismo con cualquier plataforma que hayas dejado de usar.

Cómo desconectar una plataforma de WEEX

Elimina la clave dentro de la plataforma y luego bórrala en Administración de API de WEEX. El segundo paso es el que cuenta, porque una clave eliminada únicamente de la configuración de la plataforma sigue funcionando para cualquiera que tenga una copia.

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

Conectar una plataforma a WEEX toma unos minutos, y las decisiones que tomes en ese tiempo determinan el riesgo mientras exista la clave: qué permisos tiene, qué IP se permiten y si alguna vez se elimina. Las claves se crean y administran desde la página de API de WEEX.

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 para la integración de WEEX. Es suficiente para asignar una clave propia a cada plataforma conectada, lo que permite revocar el acceso de un servicio sin afectar a los demás.

2. ¿Puedo restablecer una frase de contraseña de API de WEEX que perdí?

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

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

Las tres causas 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 alrededor de 15 minutos en activarse, así que 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 la integración con TradingView ni la API FIX. Las conexiones funcionan mediante las interfaces REST y WebSocket, ya sea directamente o a través de una plataforma que las haya integrado.