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:
Consulta 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 contraseña 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 demo disk API, necesitas crear una clave de API en el demo disk. 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, ganancia y transferencia?
Transferir: Permite que la clave transfiera fondos entre tus cuentas. Disponible para todas las cuentas.
Préstamo: Permite al usuario 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 de cuenta real requieren el uso de la clave de API de cuenta real, y el valor del parámetro x-simulated-trading en el encabezado de la solicitud debe ser 0. Las llamadas de cuenta simulada requieren el uso de la clave de API de 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. Que 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 indica 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 h son los momentos del día en que se recaudan las tarifas de capital. En esos momentos, la presión sobre el servidor es alta. Se recomienda escalonar las transacciones en esos horarios. Si se informa 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 tener éxito o fallar. 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 de la 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 de clave de API actual 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
¿Qué debo hacer si WebSocket no puede conectarse o se desconecta constantemente?
Confirma que estás usando la URL correcta de WebSocket para tu sitio y servicio API. Revisa tu red, proxy, configuración TLS, parámetros de suscripción, latido Ping/Pong y lógica de reconexión. Si el problema persiste, proporciona el canal, la hora de ocurrencia, el mensaje de error completo y los registros redactados.
¿Cómo debo solucionar un código de error de API o un parámetro de solicitud no válido?
Consulta el código de error en la documentación oficial de la API de tu sitio, luego verifica el punto final, el método HTTP, los parámetros de la solicitud, el modo de cuenta y las restricciones del producto. Si la causa sigue sin estar clara, proporciona el código de error completo, sCode/sMsg, la hora de ocurrencia y la solicitud y respuesta redactadas.
¿Por qué falló la colocación, modificación o cancelación de mi orden API?
Utiliza el mensaje de error y el código de error devueltos por la API para determinar la causa específica. Si no estás seguro de lo que significa el error, proporciona los parámetros completos de la solicitud y los detalles del error para que podamos investigarlo más a fondo.
¿Qué debo hacer si los datos del mercado, los gráficos de velas o los datos del libro de órdenes parecen incorrectos?
Confirma el nombre del canal, instId, los parámetros de suscripción y la frecuencia de las solicitudes, y distingue los datos de instantáneas de las actualizaciones incrementales. Para los libros de órdenes, también verifica los IDs de secuencia y las marcas de tiempo. Si parece faltar algún dato, registra el canal, el rango de tiempo y la respuesta sin procesar redactada.
¿Por qué los saldos, posiciones o valores de margen de la API difieren de los del sitio web o la aplicación?
Primero distingue entre la cuenta de trading y la cuenta de fondos, luego verifica el modo de cuenta, la dimensión de moneda, el punto final y la hora de actualización de los datos. Para los cálculos de saldo, posición y margen, utiliza la documentación más reciente del producto y de la API para el sitio correspondiente.
¿Qué debo hacer si un depósito, retiro o transferencia mediante API falla?
Verifica los permisos de la API, la moneda, la red, la cuenta de destino y cualquier requisito de la libreta de direcciones o lista blanca, luego soluciona problemas usando el código de error devuelto. Las restricciones de seguridad de la cuenta, cumplimiento legal o riesgos pueden requerir una revisión adicional por parte del soporte para el sitio correspondiente.
¿Cómo creo y uso una clave de API para una subcuenta?
Crea la clave de API bajo la subcuenta destinada y utiliza los permisos, la frase de contraseña y el dominio del sitio de esa subcuenta. No mezcles la clave de API, el secreto ni la frase de contraseña de la cuenta principal con los de la subcuenta.
¿Qué debo hacer después de activar un límite de tasa de API?
Reduce la tasa de solicitudes según el límite para el punto final específico y utiliza colas de solicitudes, retroceso exponencial o puntos finales por lotes cuando sea apropiado. El alcance y la cuota del límite de tasa pueden variar según el punto final, por lo que no asumas que todos los puntos finales comparten la misma asignación.
¿Dónde puedo encontrar la documentación de la API, los SDK y ejemplos de código?
Documentación API (V5) — www.okx.com/docs-v5/en. Referencia REST + WebSocket, registro de cambios, códigos de error, ejemplos de solicitud/respuesta por punto final. SDKs oficiales (GitHub) — github.com/okxapi Ejemplo de código disponible en el SDK.
¿Qué información debo proporcionar si solo puedo decir “la API no funciona”?
Proporciona el punto final, método HTTP, operación prevista, código o mensaje de error completo, hora de ocurrencia, sitio de la cuenta, entorno de red y la solicitud y respuesta redactadas. Nunca envíes un API Secret, Passphrase, código de verificación o firma sin redactar.
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.