Preguntas frecuentes sobre la API de OKX

¿Qué es la passphrase?

Es la contraseña que has indicado al solicitar la clave de API. Debes recordarla tú. Si la olvidas, no podrás recuperarla y tendrás que crear una nueva clave de API.

¿Cómo puedo crear una clave de API de disco de prueba?

Para hacer trading en la API de disco de prueba, necesitarás crear una clave de API en el disco de prueba. Sigue estos pasos:

Inicia sesión en tu cuenta de OKX > Trading > Simulación de trading > Centro personal > Crea la clave de API de la cuenta de prueba > Empieza a hacer operaciones de prueba

¿Caducará la clave de API?

Las claves de API que no estén vinculadas a una IP y tengan permisos de transacción o retiro serán eliminadas automáticamente después de 14 días de inactividad. Las claves de API no serán consideradas inactivas si son utilizadas para importar interfaces privadas o de cuenta que requieren de verificación de identidad, tales como ver el saldo de la cuenta, los datos de facturación o la creación de órdenes.

Únicamente no caducarán las claves de API de solo lectura ligadas a una IP o a permisos específicos.

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

No: para las órdenes de contratos, la interfaz ofrece por defecto órdenes en número de contratos. Si necesitas calcular la conversión en monedas del número de contratos, puedes consultar la interfaz de conversión entre contratos y monedas que encontrarás aquí.

¿Cómo puedo obtener la tasa de fluctuación de la interfaz?

La interfaz no puede obtener directamente el aumento o la reducción del precio, pero es posible calcularlo mediante una fórmula.

El valor de subida y de bajada del precio de la última transacción comparado con el precio de apertura de la línea K hace 24 horas / 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 disponible aquí (last-open24h)/open24h.

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

Primero tienes que comprobar el modo de cuenta (modo de compra y venta o modo de apertura y cierre) y puedes comprobar aquí cómo obtener el posMode.

Notas:

• En el caso de apertura y cierre de posiciones y para crear órdenes utilizando un contrato, es necesario el parámetro posSide y debe indicarse el valor long o short.

• Si se trata del modo de compra y venta o de una transacción de criptomoneda o con apalancamiento que se lleva a cabo bajo el modo de apertura y cierre, posSide admitirá solamente una transmisión neta o nula.

¿Qué interfaz se puede utilizar 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í.

Ejemplo de formato instId:

apalancamiento de monedas/monedas: BTC-USDT

Contrato perpetuo: estándar de monedas: BTC-USD-SWAP, estándar U: BTC-USDT-SWAP (todas las letras deben ser mayúsculas)

Contrato de liquidación: estándar de moneda: BTC-USD-210326, estándar U: BTC-USDT-210326 últimos dos dígitos del año + semana actual o próxima semana, o mes actual o siguiente, o trimestre actual o siguiente

Contratos de opciones: opciones alcistas BTC-USD-210326-2000-C, opciones de put BTC-USD-210326-2000-P

¿Cómo configurar órdenes stop loss y take profit?

Si la orden está adjunta para take profit stop loss, puedes consultar la interfaz de la orden aquí.: parámetros de matriz attachAlgoOrds.

Sin embargo, si se trata de una orden stop loss separada, puedes consultar la interfaz de comisión de estrategia aquí.

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

Reglas para establecer el precio de activación de stop loss/precio de activación de take profit: durante la venta, el precio de activación de take profit es mayor que el precio de la transacción más reciente y el precio de activación del stop loss es menor que el precio de la transacción más reciente mientras que, durante la compra, el precio de activación de take profit es menor que el precio de transacción más reciente y el precio de activación del stop loss es mayor que el precio de la transacción más reciente.

¿Qué es el error "Interface error: 50102 Timestamp request expired"?

Este error se produce cuando la marca de tiempo ha expirado. Deberás llamar a la interfaz horaria del sistema aquí para sincronizar tu hora local con la hora del servidor. Puede ayudar el mantener la diferencia de tiempo en 30 segundos o menos.

Nota: la hora del encabezado de la solicitud está en UTC0. Al llamar a la interfaz horaria del servidor, la hora indicada estará en UTC + 8.

¿Qué es el error "Interface error: 50101 APIKey does not match the current environment"?

Este error se produce debido a una incompatibilidad entre la clave de API y el entorno actual. Las llamadas de cuentas reales requieren el uso de la clave de API de la cuenta real y el valor del parámetro x-simulated-trading en el encabezado de la solicitud debe ser 0. Las llamadas de cuentas simuladas requieren el uso de la clave de API de cuentas simuladas y el valor del parámetro x-simulated-trading en el encabezado de la solicitud debe ser 1.

¿Qué es el error "Interface error: 51010 Request unsupported under current account mode"?

Este error está relacionado con tu modo de cuenta. Si quieres establecer un apalancamiento o un contrato de una sola moneda, tienes que ajustarte a los otros tres modos (¡excepto en el caso del modo spot!). Puedes configurarlo usando los ajustes de la interfaz aquí y también puedes configurarlo en la web o en la aplicación.

Nota: la primera configuración debe estar establecida en la página o en la aplicación: opción de configuración en el menú principal de la página de trading > Modo de cuenta.

¿Qué es el error "Interface error: 51121 Order quantity must be a multiple of the lot size"?

En la API, las órdenes de contratos se dan 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 mediante el campo minSz de la interfaz del producto aquí.

Error "Withdrawal error: 58207 Withdrawal address is not whitelisted for verification exemption": ¿por qué la verificación de la lista blanca sigue notificando un error estando cerrada en la página de retiro?

Para retirar monedas utilizando la interfaz API, es necesario añadir una dirección de retiro en la página y comprobar la no verificada por el botón de visa. Que la verificación de la lista blanca esté desactivada en la página no afectará a la función de la interfaz.

¿Qué es el error "Interface error: 50004 API endpoint request timeout"? (No significa que la solicitud se haya realizado correctamente ni que haya fallado. Comprueba el resultado de la solicitud)

El error 50004 suele venir causado por una excesiva presión del servidor. Las 8, 16 y 24 a. m. son los momentos horarios para el cobro de las comisiones de capital cada día. En este momento, la presión del servidor es alta. Se recomienda escalonar las transacciones en esos momentos. Si se informa de un error de 50004 en otros momentos, puedes volver a intentarlo más tarde. Si se crea una orden con un error 50004, no representa el resultado real de la solicitud de interfaz. La solicitud puede tener éxito o fallar. Consulta el resultado real.

Nota: si tienes cualquier otra pregunta u otra consulta relacionada con la API, puedes ponerte en contacto con nosotros escaneando el código que aparece más abajo a través de la aplicación.