Preguntas frecuentes sobre la API de OKX

¿Qué es la frase de acceso?

Esta es la contraseña que ingresaste al solicitar la clave de API. Debes recordarla por tu cuenta. Si la olvidas, no podrás recuperarla y tendrás que crear una nueva clave de API.

¿Cómo crear una clave de API de disco demo?

Para tradear con API de disco demo, debes crear una clave de API en el disco demo. Sigue estos pasos:

Inicia sesión en tu cuenta de OKX > Trading > Simulación de trading > Centro personal > Crear clave de API de la cuenta de simulación > Iniciar simulación de trading

¿La clave de API caduca?

Las claves API que no están vinculadas a una IP y tienen permisos de transacción o retiro se eliminarán automáticamente después de 14 días de inactividad. Las claves API no se considerarán inactivas si se utilizan para llamar a interfaces privadas o relacionadas con cuentas que requieren verificación de identidad, como la visualización del saldo de la cuenta, los datos de facturación o la creación de órdenes.

Las claves API de solo lectura vinculadas a una IP o permisos específicos no vencerán.

¿Es posible crear órdenes en unidades de moneda al crear órdenes a través de la interfaz?

No, para las órdenes de contratos, la interfaz predeterminada para las órdenes es en cantidad de contratos. Si necesitas calcular la conversión entre la cantidad de contratos y monedas, puedes consultar la cantidad de contratos en la interfaz de conversión de contratos a monedas aquí.

¿Cómo se obtiene la tasa de fluctuación de la interfaz?

La interfaz no puede obtener directamente el aumento o la disminución del precio, pero puede calcularse con una fórmula.

El valor de aumento y caída del precio de la última transacción en comparación con el precio de apertura de la línea K hace 24 horas ÷ el 100 % del precio de apertura de la línea K hace 24 horas.

Los datos de la fórmula anterior se pueden obtener a través de la interfaz del mercado aquí (última apertura en 24 h) ÷ apertura en 24 h.

¿Cuál es el motivo del mensaje de error "Error del parámetro posSide 51000" al crear una orden?

Primero debes revisar el modo de cuenta. El modo de compra y venta, o el modo de apertura y cierre se pueden ver aquí para obtener el modo punto de venta (posMode).

Nota:

• A la hora de abrir y cerrar posiciones, y crear órdenes usando un contrato se requiere el parámetro posSide y se completan las posiciones long o short.

• Si se trata de un modo de compra y venta, o si se realiza una transacción de criptomonedas o apalancada en el modo de apertura y cierre, el posSide solo admite la transmisión neta o sin transmisión.

¿Qué interfaz se puede usar para obtener el valor nominal del contrato y la cantidad mínima de la orden?

Puedes usar la interfaz para obtener la información básica de los productos de trading aquí.

valor nominal del contrato: ctVal, cantidad mínima de la orden: minSz.

¿Cuál es el formato de instId?

Puedes usar directamente la interfaz para obtener la información básica de los productos de trading aquí.

¿Cómo configurar stop loss y take profit?

Si la orden está adjunta al nivel de take profit stop loss, puedes consultar la interfaz de la orden aquí: parámetros del array attachAlgoOrds.

Sin embargo, si se trata de una orden stop loss independiente, puedes consultar la interfaz de comisiones de la estrategia aquí.

¿Por qué se reportó un error al establecer el precio de ejecución para take profit y stop loss: 51046, 51047, 51048, 51049?

Reglas para establecer el precio de ejecución de stop loss/take-profit: durante la venta, el precio de ejecución de take profit es mayor que el precio de la última transacción y el precio de ejecución de stop loss es menor que el precio de la última transacción. Por el contrario, durante la compra, el precio de ejecución de take profit es menor que el precio de la última transacción y el precio de ejecución de stop loss es mayor que el precio de la última transacción.

¿Qué es el "Error de interfaz: 50102. La solicitud de la marca de tiempo venció"?

Este error se produce cuando caduca la marca de tiempo. Debes llamar aquí a la interfaz de tiempo del sistema para sincronizar tu hora local con la hora de nuestro servidor. Si mantienes la diferencia horaria dentro de un rango de 30 segundos, puedes evitar este problema.

Nota: La hora en la hora del encabezado de la solicitud está en el huso horario UTC+0. Al llamar a la interfaz de tiempo del servidor, la hora se proporciona en UTC+8.

¿Qué es "Error de interfaz: 50101. La clave de API no coincide con el entorno actual"?

Esto se debe a la incompatibilidad entre la clave de API y el entorno actual. Las llamadas a cuentas reales requieren el uso de la clave de API de la cuenta real y el valor del parámetro de trading simulado de x en el encabezado de la solicitud debe ser 0. Las llamadas a cuentas simuladas requieren el uso de la clave de API de la cuenta simulada y el valor del parámetro de trading simulado de x en el encabezado de la solicitud debe ser 1.

¿Qué es el "Error de interfaz: 51010. La solicitud no es compatible en el modo de cuenta actual"?

Esto tiene que ver con tu modo de cuenta. Si quieres establecer un apalancamiento de moneda única o un contrato, debes ajustarlos en los otros tres modos, excepto en el modo spot. Puedes hacer esto desde los ajustes de la interfaz aquí, o desde el sitio web o la app.

Nota: La primera configuración debe establecerse en la página web o la app; la opción de configuración en el menú principal de la página de trading: modo de cuenta.

¿Qué es el "Error de interfaz: 51121. La cantidad de la orden debe ser un múltiplo del tamaño del lote"?

En la API, las órdenes de contrato están en unidades de hojas y deben ser un múltiplo de la cantidad mínima de la orden del par de monedas. La cantidad mínima de la orden se puede obtener a través del campo minSz de la interfaz del producto aquí.

"Error de retiro: 58207. La dirección de retiro no se encuentra en la lista blanca para exención de verificación". ¿Por qué la verificación de la lista blanca sigue reportando un error cuando se cierra en la página de retiro?

Para retirar monedas usando la interfaz de la API, es necesario agregar una dirección de retiro en la página y controlar las no verificadas con el botón para Visa. Si la verificación de la lista blanca está desactivada en la página, esto no afectará la función de la interfaz.

¿Qué es el "Error de interfaz: 50004. Se agotó el tiempo de espera de la solicitud del punto final de la API"? (No significa que la solicitud fue exitosa o falló, comprueba el resultado de la solicitud)

50004 suele ocurrir por la excesiva tensión del servidor. Las 8:00, 16:00 y 00:00 son los puntos de tiempo en los que se cobran las comisiones de capital todos los días. En tales momentos, la tensión del servidor es alta. Se recomienda intercalar las transacciones en estos momentos. Si se reportó un error de 50004 en otros momentos, se puede volver a intentar más tarde. Si se crea una orden con un error de 50004, esta no representa el resultado real de la solicitud de la interfaz. La solicitud puede ser exitosa o fallar. Consulta el resultado real.

Nota: Si tienes alguna otra pregunta u otra consulta relacionada con la API, puedes ponerte en contacto con nosotros escaneando el siguiente código desde la app.

¿Qué es el error "50119 La clave de API no existe"?

Este error suele ocurrir cuando el dominio de tu cuenta no coincide con tu región.

• Si eres un usuario del EEE, cambia el nombre del dominio de tu solicitud de API a eea.okx.com. No uses www.okx.com.

• Si eres un usuario de EE. UU., cambia el nombre del dominio de tu solicitud de API a us.okx.com. No uses www.okx.com.

• Si estás usando un software de terceros para conectarte con OKX y ves este error, consulta al proveedor del software si admite dominios regionales. Por ejemplo, el usuario del EEE debe conectarse a través de eea.okx.com, de lo contrario, la solicitud fallará.

¿Por qué aparece el error "50110" al vincular un software de terceros?

Este error puede ocurrir si el tipo de clave de API actual no es compatible con la vinculación del software de terceros. Intenta solicitar el tipo de transacción de clave de API sin vincular una lista de IP y, luego, vuelve a conectar el software de terceros.