KuCoin no tiene un interruptor llamado "solo lectura". Su clave de solo lectura es la que tiene el permiso General y nada más. SetupBook lee tus ejecuciones con una clave así, así que tus operaciones de futuros USDT-M y spot llegan a tu diario sin teclear nada. KuCoin también pide una passphrase al crear la clave, y SetupBook la necesita. Lleva unos cinco minutos.

Esta guía muestra cada paso con imágenes. Para saber cómo se conectan todas las plataformas, lee el resumen de todas las conexiones. Si también usas MEXC, mira la guía de MEXC.

Antes de empezar

  • Una cuenta de SetupBook con Pro. Conectar una plataforma es parte de Pro, y cada diario empieza con 14 días de Pro: empieza 14 días gratis.
  • Una cuenta de KuCoin. KuCoin pide una verificación de seguridad al crear una clave: tu contraseña de trading, más un código de tu correo y otro de tu app de autenticación.
  • Un lugar donde apuntar la passphrase, como un gestor de contraseñas.
  • Cinco minutos.

La clave solo lee. Marcas General y dejas desactivados Spot, Futures, Margin, Earn y Withdrawal. SetupBook nunca coloca una orden y nunca mueve dinero. Guarda la clave y la passphrase selladas en el servidor y las usa para leer tus ejecuciones.

1. Abre API Management y crea una clave

En la web de KuCoin haz clic en tu avatar, elige API Management y pulsa Create API. KuCoin pregunta para qué es la clave: elige API Trading, la opción que crea una clave propia. Después escribe un API name (llámalo SetupBook) y una API passphrase.

Dibujo del formulario Create API de KuCoin: solo General marcada, Spot, Futures y Withdrawal desactivadas
Create API: un nombre, una passphrase tuya, General marcado, todo lo demás desactivado.

2. Marca General y nada más

En el paso de permisos marca General. KuCoin lo describe como limitado a acciones de solo lectura: información de la cuenta, extractos e información de órdenes. Deja desactivados Spot, Futures, Margin, Earn y Withdrawal, y deja desactivada también cualquier otra casilla. El texto del formulario puede variar un poco de una región a otra (la web de la UE llama a este paso API Restrictions), así que busca la casilla General.

Restricción de IP: la ayuda de KuCoin dice que una clave que opera debe estar vinculada a una dirección IP. La tuya no opera, así que deja la restricción desactivada. Si el formulario insiste en una de todos modos, pídenosla en el formulario de comentarios bajo las conexiones: todavía no podemos darte una dirección fija que permitir. Con una clave de solo lectura no se puede operar ni retirar nada, con o sin restricción.

3. Copia la clave, el secreto y la passphrase

Confirma la verificación de seguridad. KuCoin muestra la API key y el secreto. Copia los dos en un lugar seguro, junto con tu passphrase. KuCoin no puede recuperar ninguno de los tres una vez perdidos, así que si pierdes uno, crea una clave nueva.

4. Pega los tres en SetupBook

En SetupBook abre Cuentas → Conexiones y pulsa Añadir conexión. Elige KuCoin. Pega la clave en Clave API, el secreto en Secreto API y la passphrase en Passphrase.

En Mercados marca lo que operas: Perpetuos USDT (futuros USDT-M) y Spot. Para spot, KuCoin no tiene una llamada de "qué operé", así que escribe los pares que operas en Pares spot, separados por comas, por ejemplo BTC-USDT, ETH-USDT. Los pares de las monedas que tienes se añaden solos. Los futuros no necesitan lista.

Deja En la cuenta en Crear desde la cuenta de la plataforma, o elige una tuya, y pulsa Comprobar la clave y conectar.

SetupBook: diálogo de conexión de KuCoin con campos de clave, secreto y passphrase, mercados y pares spot
Cuentas → Conexiones → Añadir conexión → KuCoin. Clave, secreto, passphrase, mercados y pares spot.

KuCoin no le dice a una clave cuáles son sus propios permisos, así que SetupBook no puede avisarte si marcaste una casilla de operar por error. Mira una vez los permisos de la clave en KuCoin para estar seguro.

5. Mira la primera sincronización

La primera sincronización empieza al momento. Los futuros llegan unos tres meses atrás; el spot se lee par por par hasta donde KuCoin lo sirve. Cuando termina, la conexión muestra Activa, la hora de la última sincronización y el número de operaciones. Después SetupBook busca ejecuciones nuevas cada hora, y puedes pulsar Sincronizar en cualquier momento.

SetupBook: tarjeta de conexión de KuCoin en estado Activa, con última sincronización y operaciones
Estado Activa, última sincronización y número de operaciones tras la primera sincronización.

Qué obtienes:

  • Posiciones, no ejecuciones sueltas. Las ejecuciones se agrupan en posiciones igual que en la importación de archivos, así que una posición cerrada en tres partes es una operación con tres salidas.
  • Tamaño del contrato. Un contrato de futuros vale una cantidad fija de la moneda (el contrato de BTC XBTUSDTM es 0,001 BTC), y SetupBook la usa, así que el tamaño y el resultado coinciden con KuCoin.
  • Campos bloqueados. Símbolo, lado, horas, precios, tamaño, comisiones y el resultado neto vienen de KuCoin y se mantienen exactos (alimentan tu beneficio neto). El plan, la calidad del setup, los errores, las notas y las capturas siguen siendo tuyos.
  • Zona horaria. Las horas de KuCoin están en UTC, así que no hay nada que configurar.
  • No incluido. Los contratos margen en moneda (inversos) y los pagos de funding no se leen.

Demo o real

SetupBook conecta solo cuentas reales de KuCoin. KuCoin no tiene un trading demo que SetupBook pueda leer.

Reemplazar una clave

Abre el menú de la conexión, elige Editar y pulsa Reemplazar la clave. Pega la clave, el secreto y la passphrase nuevos y guarda: SetupBook los comprueba, olvida los antiguos y usa los nuevos desde la siguiente sincronización. Las operaciones se quedan.

Problemas

Qué ves Por qué Qué hacer
Las claves de OKX, Bitget y KuCoin necesitan su passphrase El campo de la passphrase está vacío Pega la passphrase que escribiste al crear la clave
El exchange rechazó la clave Una passphrase equivocada, un secreto mal escrito, o una clave eliminada Comprueba los tres valores, o crea una clave nueva
Olvidaste la passphrase KuCoin no puede recuperarla Crea una clave nueva y usa Reemplazar la clave
Faltan operaciones spot El par no está en tu lista Edita la conexión y añade el par a Pares spot
Faltan operaciones de futuros Perpetuos USDT no está marcado, o el contrato es de margen en moneda Marca el mercado; los contratos de margen en moneda se omiten
No llega nada y el estado es Error La clave se eliminó en KuCoin Crea una clave nueva y reemplázala

¿Problemas para conectar? Escríbenos desde la página de conexiones con lo que has probado. Respondemos por correo en 30 minutos, todos los días.

Preguntas frecuentes

¿Es seguro? ¿Puede SetupBook operar o retirar?

No. Una clave con solo General no puede colocar una orden ni retirar, y SetupBook no tiene código que lo intente. La clave y la passphrase se guardan selladas en el servidor y nunca se envían a tu navegador. Para parar, elimina la clave en KuCoin y la conexión se detiene.

¿Por qué necesita SetupBook la passphrase?

KuCoin firma cada petición con la passphrase además de la clave y el secreto. Sin ella, KuCoin rechaza la petición. La passphrase la elegiste tú al crear la clave.

¿Tengo que restringir la dirección IP?

No. Déjala desactivada. Todavía no podemos darte una dirección fija que permitir; si quieres una, pídenosla en el formulario de comentarios. Una clave de solo lectura no puede operar ni retirar, con o sin regla de IP.

¿Por qué tengo que listar mis pares spot?

KuCoin no tiene una llamada que devuelva los pares spot que operaste. Tú listas los pares, y SetupBook añade encima los pares de las monedas que tienes. Los futuros no necesitan lista.

¿Cuesta algo?

Conectar es parte de Pro. Cada diario empieza con 14 días de Pro y no se cobra nada en esos 14 días. Si cancelas antes de que terminen, te quedas en el plan gratuito, que mantiene el registro manual.

¿Prefieres un archivo? La importación sigue funcionando: mira la guía de uso. Para conectar otro exchange, lee la guía de Hyperliquid.