Preguntas frecuentes sobre la API de OKX
¿A qué se refiere la frase de contraseña?
Esta es la contraseña que ingresaste al solicitar la clave de API. Debes recordarla tú mismo. Una vez que la olvides, no podrás recuperarla y tendrás que crear una nueva clave de API.
¿Cómo creo una clave de API?
En la App:
1. Inicia sesión en tu Cuenta de OKX > Selecciona menú (⋮⋮⋮) > Desplázate hacia abajo y selecciona clave de API > Crear clave de API
2. Rellena el nombre de la API > Selecciona Cuenta y Propósito > Introduce la lista blanca de direcciones IP > Selecciona Permisos > Introduce la Frase clave
En la Web:
1. Inicia sesión en tu Cuenta de OKX > Ve a tu Perfil y selecciona API y conexiones > Crear clave de API
2. Rellena el nombre de la clave de API > Selecciona cuenta y uso
3. Introduce la lista blanca de direcciones IP > Selecciona Permisos > Introduce la Frase clave
Nota:
Las direcciones IP ayudan a proteger tu clave de API. Puedes vincular hasta 20 direcciones por clave, separándolas con una coma o un espacio.
Debes consultar la información de la API y acceder a su interfaz. Por favor, mantén tu contraseña segura. Puedes crear una nueva API si pierdes la contraseña, ya que no podemos recuperar las APIs.
¿Cómo gestiono o edito la clave de API?
Para gestionar o editar tu clave de API en OKX:
Inicia sesión en tu Cuenta de OKX y ve a Perfil > API.
Verás una lista de tus claves API existentes. Haz clic en la que quieras gestionar.
Desde aquí puedes:
Ver el nombre de la clave de API, los permisos y la lista blanca de IP vinculadas.
Edita el nombre de la clave, los permisos (Leer, Trade, retirar) o las direcciones IP vinculadas.
Elimina la clave si ya no es necesaria.
Nota: No puedes ver la Frase de paso después de la creación inicial. Si la pierdes, tendrás que eliminar la clave existente y crear una nueva. Guarda siempre tus credenciales de forma segura.
¿Cómo puedo diferenciar entre spot o trading con margen si opero usando API?
La forma en que se diferencian el spot y el trading con margen a través de la API puede variar según el tipo de cuenta y la configuración que tengas. Recomendamos consultar la documentación de la API de OKX para obtener los parámetros más precisos y actualizados aplicables a la configuración de tu cuenta.
Si necesitas más aclaraciones, contacta con el Asistente de OKX para recibir orientación personalizada.
¿Cómo creo una clave de API para disco de demostración?
Para tradear en el disco de demostración API, necesitas crear una clave de API en el disco de demostración. Sigue los pasos a continuación:
Inicia sesión en tu Cuenta de OKX > Trading > simulación de trading > Centro Personal > Crear clave de API de cuenta demo > Comenzar simulación de trading
¿Caducará la clave de API?
Las claves API que no estén vinculadas a una IP y tengan 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 la cuenta que requieran verificación de identidad, como consultar el saldo de la cuenta, los datos de facturación o realizar órdenes.
Solo las claves API de solo lectura vinculadas a una IP o permisos específicos no expirarán.
¿Qué son los permisos de Préstamo, Ganar y Transferir?
Transferir: Permite que la clave transfiera fondos entre tus cuentas. Disponible para todas las cuentas.
Préstamo: Permite a la clave pedir prestado, amortizar y gestionar préstamos. Solo visible si tu cuenta tiene la elegibilidad requerida para esta función.
Ganar: Permite que la clave se suscriba y canjee productos Ganar. Solo visible si tu cuenta tiene la elegibilidad requerida para esta función.
Si tu API Key tenía permisos de Trade habilitados anteriormente, los tres permisos se activarán automáticamente con esta actualización. No se requiere configuración manual.
¿Se pueden realizar órdenes en unidades de moneda al hacer pedidos a través de la interfaz?
No; para las órdenes de contratos, la interfaz muestra por defecto las órdenes en número de contratos. Si necesitas calcular la conversión entre el número de contratos y monedas, puedes consultar la interfaz de conversión de contratos a moneda aquí.
¿Cómo obtener la tasa de fluctuación de la interfaz?
La interfaz no puede obtener directamente el aumento o la disminución del precio, pero se puede calcular mediante una fórmula.
El valor de subida y bajada del último precio de transacción en comparación con el precio de apertura de la vela K hace 24 horas / 100 % del precio de apertura de la vela K hace 24 horas.
Los datos de la fórmula anterior se pueden obtener a través de la interfaz de mercado aquí.
¿Cuál es la razón del mensaje de error "51000 Parameter posSide error" al colocar una orden?
Primero debes comprobar el modo de cuenta; modo de compra y venta/modo de apertura y cierre, que puedes consultar aquí para obtener posMode.
Nota:
En el caso de abrir y cerrar posiciones y realizar órdenes usando un contrato, se requiere el parámetro posSide, y se debe completar con long o short.
Si es un modo de compra y venta, o se realiza una transacción de criptomoneda o apalancada bajo el modo de apertura y cierre, posSide solo admite neto 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 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á vinculada a take profit stop loss, puedes consultar la interfaz de órdenes aquí: parámetros del array attachAlgoOrds.
Sin embargo, si es un stop loss de orden separado, puedes consultar la interfaz de comisión de estrategia aquí.
¿Por qué se informa 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/precio de ejecución de 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; mientras que 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é significa "Error de interfaz: 50102 Solicitud de marca de tiempo vencida"?
Este error ocurre cuando la marca de tiempo ha vencido. Debes llamar a la interfaz de tiempo del sistema aquí para sincronizar tu hora local con la hora de nuestro servidor. Mantener la diferencia de tiempo dentro de los 30 segundos puede ayudar a evitar este problema.
Nota: la hora en el encabezado de la solicitud está en UTC0. Al llamar a la interfaz de hora del servidor, la hora se proporciona en UTC + 8.
¿Qué significa "Error de interfaz: 50101 APIKey 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 x-simulated-trading 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 x-simulated-trading en el encabezado de la solicitud debe ser 1.
¿Qué significa "Error de interfaz: 51010 Solicitud no soportada bajo el modo de cuenta actual"?
Esto está relacionado con tu modo de cuenta. Si quieres colocar un apalancamiento o contrato de una sola moneda, necesitas ajustarte a los otros tres modos excepto el modo spot. Puedes configurarlo a través de los ajustes de la interfaz aquí, o puedes configurarlo en la web o en la app.
Nota: la primera configuración debe establecerse en la página o aplicación; opción de configuración en el menú principal de la página de trading - modo de cuenta.
¿Qué significa "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 contratos y deben ser un múltiplo de la cantidad mínima de orden del par de moneda. La cantidad mínima de orden se puede obtener a través del campo minSz de la interfaz de producto aquí.
"Error de retiro: 58207 La dirección de retiro no está en la lista blanca para la exención de verificación"; ¿por qué la verificación de la lista blanca sigue reportando un error cuando está desactivada en la página de retiro?
Para retirar monedas usando la interfaz API, es necesario añadir una dirección de retiro en la página y marcar el botón de no verificado por visa. Si la verificación de la lista blanca está desactivada en la página, no afectará la función de la interfaz.
¿Qué significa "Error de interfaz: tiempo de espera de la solicitud al punto final API 50004" (no significa que la solicitud fue exitosa o fallida, por favor verifica el resultado de la solicitud)?
El error 50004 suele ser causado por una presión excesiva en el servidor. Las 8, 16 y 24 horas son los puntos de tiempo para la recolección de tarifas de capital cada día. En esos momentos, la presión en el servidor es alta. Se recomienda escalonar las transacciones en esos horarios. Si se reporta un error 50004 en otros momentos, se puede intentar de nuevo más tarde. Si se realiza una orden con un error 50004, esto no representa el resultado real de la solicitud de la interfaz. La solicitud puede haber tenido éxito o haber fallado. Por favor, consulta el resultado real.
¿Qué significa el error "50119 API key no existe"?
Este error suele ocurrir cuando el dominio de tu cuenta no coincide con tu región.
Para los usuarios del EEE, cambia el nombre del dominio de tu solicitud API a eea.okx.com en lugar de www.okx.com.
Para usuarios de EE. UU., cambia el nombre del dominio de tu solicitud API a us.okx.com en lugar de www.okx.com.
Si estás usando un software de terceros para conectarte con OKX y ves este error, verifica con el proveedor del software si admite dominios regionales. Por ejemplo, los usuarios del EEE deben conectarse a través de eea.okx.com, de lo contrario la solicitud fallará.
¿Por qué aparece el error "50110" al vincular con un software de terceros?
Este error puede ocurrir si el tipo actual de clave de API no es compatible con la vinculación de 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.
¿Cómo obtengo el último precio de transacción de un determinado par de monedas?
Usa los detalles aquí para tickers y para ticker, aquí. La interfaz de tickers se usa para obtener el último precio de transacción de pares de moneda en lotes, y ticker se usa para obtener el último precio de transacción de pares de moneda individuales.
Ejemplo del parámetro de respuesta del Precio del último trading en la sección de Tickers
¿Cuáles son los requisitos para crear una clave de API?
Se requiere un saldo mínimo de Activos Bajo Gestión (AUM) de 100 USD para crear una clave de API.
Se requiere un AUM superior a 100 USD (AUM > 100U) para crear una clave de API
Para cuentas principales o subcuentas, solo se permite crear claves API a las cuentas con AUM > 100U
Nota: Este requisito es aplicable solo a usuarios en ciertas áreas
Nota:
Si tienes preguntas sobre WebSocket u otros temas relacionados con la API, haz clic en el enlace del artículo y escanea el código QR al final del artículo usando el OKX app para unirte al grupo y contactar con nuestro especialista en soporte de API.
Cómo escanear: en la app, toca menú > el icono de escanear, y escanea el código QR.