Mensajes de error de la API

Los errores de permiso denegado se devuelven cuando el cliente de la API intenta una tarea para la cual la clave de la API no tiene permiso. Por ejemplo, si un cliente de la API intentara recuperar el saldo de la cuenta utilizando una clave de API configurada para permitir el acceso de trading pero no el acceso a la gestión de la cuenta, se devolvería el error de permiso denegado. Puede revisar sus claves de API y su configuración (como sus permisos) a través de la pestaña Configuración -> API de la gestión de la cuenta. Deberá asegurarse de que las claves de API utilizadas por sus aplicaciones de terceros tengan todas las configuraciones y permisos que sus aplicaciones requieren.

Este error se devuelve cuando la clave de la API utilizada para la llamada ha caducado o está deshabilitada. Revise la clave de la API en la pestaña Configuración -> API de la gestión de su cuenta o genere una nueva y actualice su aplicación.

Puede obtener la lista completa de nuestros pares de activos desde la llamada pública AssetPairs y buscar el nombre del par como entrada de los encabezados Json o por el parámetro "altname": https://api.kraken.com/0/public/AssetPairs

Este error se devuelve cuando se llama a un método sin los parámetros requeridos. Por ejemplo, llamar al método QueryOrders sin especificar un parámetro de ID de transacción (txid) válido provocaría que se devolviera el error de argumentos no válidos. Llamar a un método con parámetros innecesarios no devolvería el error de argumentos no válidos porque los parámetros innecesarios simplemente se ignorarían.

Los errores de firma no válida ocurren si su clave API o su secreto API están escritos incorrectamente en su programa o porque los datos POST utilizados en la autenticación y los datos POST enviados a la API no coinciden. Para referencia adicional, el siguiente es un ejemplo de código Python para implementar el algoritmo de firma de la API. La clave pública de la API apropiada debe copiarse y pegarse de la gestión de la cuenta, y el método de la API y los datos POST deben actualizarse adecuadamente. El valor de salida se puede usar directamente como el valor para el encabezado HTTP API-Sign. #!/usr/bin/env python

# Importar librerías de Python requeridas
import time
import base64
import hashlib
import hmac

# Decodificar la clave privada de la API del formato base64 mostrado en la gestión de la cuenta
api_secret = base64.b64decode("nmlrD83t1J+yVWKUBx9vD6j26C5zhC11tFfXpN+Ww+8oOVuGgse5AeADcvl95jYaD+UAi3D5CrVfFr8GfQ7zhA==")

# Variables (método API, nonce y datos POST)
api_path = "/0/private/TradeBalance"
api_nonce = str(int(time.time()*1000))
api_post = "nonce=" + api_nonce + "&asset=xxbt"

# Algoritmos de hash criptográfico
api_sha256 = hashlib.sha256(api_nonce + api_post).digest()
api_hmac = hmac.new(api_secret, api_path + api_sha256, hashlib.sha512)

# Codificar la firma en formato base64 utilizado en el valor API-Sign
api_signature = base64.b64encode(api_hmac.digest())

# Firma de autenticación de la API para usar en el encabezado HTTP API-Sign
print(api_signature)El SHA256 se calcula utilizando el valor nonce y los datos POST para el método de la API, y los DATOS POST se componen de los pares nombre/valor para el nonce (de nuevo) y los parámetros del método de la API. Un ejemplo de los datos que deben pasarse al SHA256 para el método TradeBalance sería el siguiente:SHA256 = SHA256 de "1541933977000nonce=1541933977000&asset=xxbt"El valor de cadena que se pasa al SHA256 no debe contener ningún valor nulo adicional (\0) y el valor de cadena no debe codificarse como base64 o hexadecimal (es decir, el valor de cadena debe ser una cadena de texto plano).La ruta URI es la URL completa del método de la API, excepto el prefijo "https://api.kraken.com", por lo que la ruta URI del método TradeBalance (por ejemplo) sería el valor de cadena "/0/private/TradeBalance" sin ningún valor nulo adicional.El HMAC SHA512 se calcula utilizando la ruta URI y el resumen SHA256 calculado previamente, con la clave privada de la API decodificada en base64 como clave HMAC. Un ejemplo de los datos que deben pasarse al HMAC sería el siguiente:HMAC SHA512 utilizando la clave privada decodificada en base64 = HMAC de "/0/private/TradeBalanceSHA256"Los encabezados HTTP API-Key y API-Sign son los únicos dos encabezados HTTP personalizados requeridos. El encabezado API-Key es una copia exacta de la clave pública de la API de la gestión de la cuenta. El encabezado API-Sign es el resumen HMAC SHA512 codificado en base64.

Puede encontrar más información sobre este error aquí:https://support.kraken.com/hc/en-us/articles/360001148063Y más sobre Nonce y Nonce Window aquí:https://support.kraken.com/hc/en-us/articles/360000906023https://support.kraken.com/hc/en-us/articles/360001148023

Los errores de sesión no válida se devuelven a través de la API de WebSocket cuando se intenta suscribirse a un feed autenticado (privado) utilizando un token de autenticación que ya no es válido (por ejemplo, ha caducado).

La solución es simplemente solicitar un nuevo token de autenticación a través del endpoint GetWebSocketsToken de la API REST y utilizar el nuevo token para todas las solicitudes de suscripción autenticadas (privadas) posteriores.

Un error de solicitud incorrecta indica que hay algo incorrecto en la solicitud HTTP subyacente (no en la solicitud API posterior), como URLs no coincidentes entre REST/WebSocket, o no incluir los datos HTTP POST correctamente:

% curl --data "" https://api.kraken.com/0/private/GetWebSocketsToken

{"error":["EAPI:Bad request"]}

Este error se devuelve cuando el endpoint al que se llama no es un endpoint válido.

Ha superado el límite de tasa de la API.

Aunque añadir y cancelar órdenes no cuenta para nuestros límites de contador de API estándar, estas operaciones tienen su propio contador de añadir y cancelar órdenes. Este contador funciona de tal manera que cuanto más tiempo permanecen las órdenes en el libro de órdenes, más órdenes pueden añadir o cancelar los clientes.

Los mensajes de error de bloqueo temporal pueden ocurrir si ha tenido demasiadas llamadas a la API fallidas o demasiados errores de nonce no válidos en un corto período de tiempo o firmas no válidas. Aunque estas llamadas devuelven un error, ese error sigue contando para sus límites de API y puede resultar en un bloqueo temporal.

Los bloqueos temporales duran aproximadamente 15 minutos. Después de recibir el error de bloqueo temporal, espere 15 minutos antes de enviar nuevas solicitudes a la API. Si está provocando varios errores de nonce no válidos, aumente la ventana de nonce, ya que esto puede ayudar a reducir la frecuencia con la que se producirán estos errores. Intente también reducir la frecuencia de sus llamadas a la API privada.

La apertura de nuevas posiciones al contado con margen ha sido suspendida temporalmente por mantenimiento del motor de trading. La función volverá pronto y podrá seguir las actualizaciones en status.kraken.com.

Otras razones pueden ser que las posiciones al contado con margen no están actualmente disponibles para clientes que residen en ciertos países.

En Kraken no puede abrir una posición larga y corta para el mismo par.

Si desea abrir una posición larga y corta para la misma divisa, elija diferentes pares de trading con la misma divisa como divisa base o de cotización. Ej: corto XBT/USD, largo XBT/EUR.

Este error ocurre cuando ha excedido los límites de margen permitidos para su nivel de verificación actual. Los límites de margen permitidos para cada divisa varían según su nivel de verificación actual.

Tenemos fondos limitados disponibles para extensiones de margen. El mensaje de "margen insuficiente" indica que nos hemos quedado sin fondos en el fondo de margen aplicable por el momento. Esto puede cambiar en cualquier momento. Es posible que pueda realizar su orden con éxito segundos o minutos después, pero las órdenes de gran volumen y las órdenes realizadas durante períodos de gran volumen pueden tardar más. Acepte nuestras disculpas por cualquier inconveniente.

Este error ocurre cuando no hay suficiente Margen Libre para abrir una nueva posición en la cuenta o si el intento actual de abrir una posición resultaría en que el Margen Libre de la cuenta caiga por debajo del 100%.

No tiene los fondos disponibles para realizar esta orden. Revise sus posiciones y órdenes abiertas para ver los elementos que puedan estar reteniendo sus fondos.

No ha alcanzado el volumen mínimo de orden para este activo.

Ha excedido la cantidad máxima de órdenes abiertas disponibles para su cuenta.

Estos límites se basan en su nivel de verificación. Cierre algunas de sus órdenes abiertas o verifique su cuenta a un nivel superior.

Ha excedido la cantidad máxima de posiciones abiertas disponibles para su cuenta.

Estos límites se basan en su nivel de verificación. Cierre o liquide algunas o todas sus posiciones abiertas o verifique su cuenta a un nivel superior si es posible.

Se intentó editar una orden existente (abierta) pero las modificaciones no pudieron completarse con éxito. Las posibles razones incluyen fondos insuficientes para la nueva orden, algunos escenarios de ejecución parcial y algunas órdenes apalancadas.

El nuevo volumen es inferior al volumen ya ejecutado/completado.

El tamaño de la orden excedió el límite de tamaño de la posición de margen del par de trading.

El volumen de visualización no ha alcanzado el volumen mínimo de la orden.

El volumen de visualización debe ser menor que el volumen de la orden.

Las órdenes iceberg no son compatibles con ningún otro tipo de orden que no sea una orden limitada.

Cada criptomoneda tiene un máximo de 5 direcciones de depósito nuevas (sin usar), después de lo cual cualquier intento de crear una sexta dirección nueva devolverá un error.

Este error se devuelve siempre que se llama a los puntos finales de financiación con un parámetro "method" no válido o faltante. 

El parámetro de entrada "key" no corresponde a la descripción de la dirección establecida en la gestión de la cuenta (a través de Financiación -> Retirar).

Los importes mínimos de retiro por divisa varían y cualquier intento de retiro por debajo del mínimo resultaría en este error.

Este es un error genérico que indica que una solicitud de financiación no pudo completarse (por ejemplo, clientes de ciertas ubicaciones que intentan realizar solicitudes de staking en cadena causarían este error).

No se pudo completar el retiro solicitado porque la dirección de destino no tiene la información requerida del beneficiario/destinatario (tenga en cuenta que esto actualmente solo se aplica a retiros seleccionados de cuentas canadienses).

Los errores de servicio que está experimentando deberían ser solo temporales. Puede que desee volver a enviar sus solicitudes si han fallado. Estaremos monitoreando los problemas y actualizaremos nuestra página:

https://status.kraken.com/

Cuando nos enfrentamos a problemas de degradación de la API, estos pueden traducirse en problemas para Kraken en forma de mensajes de servicio no disponible e interrupciones del sitio.

Este problema tiene que ver con la seguridad de su cuenta, que puede haber sido comprometida. Cambie su contraseña y la autenticación de dos factores y póngase en contacto con nuestro Centro de soporte.

Este error ocurre cuando un indicador o parámetro de entrada está deshabilitado temporal o permanentemente. El error debería provenir de una de las entradas pasadas; póngase en contacto con nuestro soporte enviando un registro con la información completa utilizada para la llamada que generó el error.

Estos errores 5xx y 10xx no son realmente errores de la API, sino errores del servidor web de Cloudflare.

Los errores de la API siempre se devuelven en formato JSON, como “error”:[“TipoDeError:MensajeDeError”], por lo que cada vez que se recibe un error en un formato diferente (como un código de estado HTTP 520, 504, 502, 1020, etc.), la solución provisional es intentar la llamada a la API de nuevo poco después y, con suerte, la llamada será exitosa.