Preguntas frecuentes
P1: No se pueden retirar fondos incluso después de añadir la dirección a la lista blanca
Causas:
1. La lista blanca en la página de retiro y la lista blanca de retiros de API son independientes entre sí.
2. Las direcciones añadidas a través de [Página de retiro] > [Gestión de direcciones de retiro] no son aplicables para retiros mediante API.
Solución:
- Visite la página de gestión de lista blanca de retiros API: https://www.coinex.com/apikey
- Añada la dirección de retiro a la lista blanca específica para API.
P2: Error access_id not exist
Causas comunes:
(1) Las claves API recién creadas normalmente tardan unos 10 minutos en activarse. Llamar a la API inmediatamente después de su creación puede provocar este error.
(2) access_id incorrecto.
(3) Verificación de firma inválida.
(4) Encabezado de solicitud incorrecto.
Solución:
(1) Consulte la [Documentación de la API de CoinEx] para aprender cómo construir una solicitud de autenticación HTTP.
(2) Ejemplo:
P3: Error 3008/4001 service unavailable
Causa: Este error puede ocurrir al cancelar órdenes durante períodos de alta carga del servidor.
Solución:
(1) Priorice la cancelación de órdenes importantes.
(2) Vuelva a intentarlo después de 1-2 segundos.
(3) Si la respuesta devuelve code: 0 pero la orden no se cancela:
- Registre la solicitud y respuesta completas.
- Contacte con atención al cliente y proporcione la información de la cuenta principal/subcuenta para recibir asistencia.
P4: Error de parámetros inválido
Causa: Esto suele ocurrir cuando los parámetros cargados no coinciden con los tipos especificados en la documentación de la API.
Solución: Tomando como ejemplo el endpoint POST /spot/cancel-order:
(1) Compare estrictamente los nombres y tipos de parámetros en la documentación de la API.
(2) Preste especial atención a las diferencias entre tipos numéricos y de cadena.
P5: ¿Cuáles son los límites de tasa de la API?
Los límites de tasa se dividen en límites a corto plazo y límites a largo plazo, que se pueden identificar a través del Encabezado de Respuesta:
1. Límites de Tasa a Corto Plazo: Si el valor X-RateLimit-Limit es mayor que 0, el límite de tasa a corto plazo no se ha activado.
El límite a corto plazo utiliza un mecanismo de cubo de tokens, con límites de tasa independientes para cuentas principales y subcuentas.
- Error común después de activarse: Código: 213, 4213
- Mensaje: Please don't try too frequently.
2. Límites de Tasa a Largo Plazo: Si se devuelve X-RateLimit-LongPeriod-{period}-Remaining, se han activado los límites de tasa a largo plazo. El sistema evalúa el volumen y la calidad de las solicitudes del usuario para decidir si impone límites en los totales de solicitudes durante un período más largo. Después de activarse, las tasas de solicitud para todos los endpoints (excepto la cancelación de órdenes) se limitarán a 1 solicitud por segundo.
- Error común: Código: 213, 4213
- Se requiere un juicio adicional a través del Encabezado de Respuesta.
Otras preguntas comunes
P1: ¿Cómo reducir la latencia de las solicitudes API?
Los servidores están desplegados en AWS Tokio y admiten equilibrio de carga entre regiones. Puede elegir una región cercana para minimizar la latencia.
Zonas disponibles:
- ap-northeast-1a
- ap-northeast-1c
- ap-northeast-1d
P2: ¿Se requiere 2FA para los retiros mediante API?
Por razones de seguridad:
1. Antes de utilizar retiros mediante API, debe iniciar sesión y autorizar mediante 2FA.
2. Después de añadir direcciones de retiro a la [Lista blanca de retiros], puede iniciar retiros mediante API sin verificación 2FA adicional.
P3: ¿Se pueden añadir direcciones a la lista blanca de retiros mediante la API?
Actualmente, no se admite añadir direcciones a la lista blanca de retiros mediante la API. Por favor, vaya a [Gestión de las API] > [Lista blanca de retiros] para añadir direcciones manualmente o por lotes.
P4: Error de firma incorrecta
Soluciones:
1. Compruebe si el access_id y secret_key están configurados correctamente.
2. Verifique si el cuerpo de la solicitud y los parámetros utilizados para la generación de la firma son idénticos. Preprocese los parámetros de solicitud como cadenas y asegure la consistencia antes y después de firmar.
3. Si se utiliza una biblioteca de terceros para la firma, asegúrese de que esté configurada correctamente.
P5: Error de verificación de tonce - El tonce correcto debe estar dentro de un minuto de la hora actual
Solución:
(1) Asegúrese de que la marca de tiempo para todas las solicitudes API esté en milisegundos.
Ejemplo:
(2) Verifique que su ordenador tenga habilitada la sincronización automática de hora.
P6: ¿Cómo recuperar el saldo disponible real y el valor neto de una cuenta de futuros?
(1) Utilice el endpoint /assets/futures/balance para recuperar el campo available, que indica el saldo disponible actual de la cuenta de futuros.
(2) Los endpoints de API actualmente no admiten devolver el valor neto de la cuenta. El valor neto es la suma de ganancias y pérdidas realizadas y no realizadas.
(3) Las ganancias y pérdidas no realizadas no son valores fijos y pueden fluctuar con los cambios de posición. Se requieren cálculos manuales para resultados precisos.
(4) Para fórmulas de cálculo, consulte la documentación "Cómo calcular los ingresos en cuenta y PNL de contratos lineales".
P7: ¿Cómo procesar los datos devueltos por la API WebSocket?
La API WebSocket devuelve datos en formato de cadena JSON comprimida, que debe descomprimirse antes de su uso (por ejemplo, utilizando el módulo gzip).
Error común:
utf-8 codec can't decode byte 0x8b in position 1: invalid start byte
P8: ¿Qué hacer si una plataforma fiscal de terceros informa un error?
Los servicios V1 se descontinuaron el 25 de septiembre de 2024. El error puede deberse a que la plataforma no actualizó su código a V2. Póngase en contacto con la plataforma fiscal correspondiente para obtener ayuda.
P9: ¿Cómo confirmar una conexión WebSocket exitosa?
Al suscribirse con éxito, se recibirá una respuesta con el resultado de la suscripción.
Posteriormente, recibirá las actualizaciones de mensajes suscritos:
P10: ¿Por qué la conexión WebSocket se desconecta automáticamente? ¿Cómo mantener la conexión?
(1) Las desconexiones de WebSocket suelen ser causadas por problemas de red. Compruebe si la conexión de red es estable.
(2) Para mantener la conexión WebSocket, necesita usar server.ping para mantenerla activa.
(3) Si no hay comunicación con el servidor durante 1 minuto, la conexión WebSocket se desconectará automáticamente. Se recomienda establecer un intervalo de envío dentro de 60 segundos a través de la interfaz ping para mantener la conexión activa.
Para otros errores de API, por favor haga clic AQUÍ para contactar con atención al cliente y proporcione la siguiente información para ayudar a resolver el problema:
(1) El correo electrónico de la cuenta principal o el nombre de usuario de la subcuenta.
(2) Detalles completos de solicitud y respuesta.
Importante: NO comparta el access_id y secret_key en los mensajes de error para evitar pérdidas innecesarias.