Preguntas frecuentes sobre la API avanzada

Última actualización: 25 nov 2025

Posibles valores de estado para transacciones de depósito/retiro

Utilizando los puntos finales de financiación de la API REST, los clientes pueden depositar/retirar fondos de su cuenta de Kraken y solicitar el estado en tiempo real de una transacción de depósito/retiro.

Los depósitos/retiros pasan por varias etapas entre la solicitud inicial y la finalización de la transacción, por lo que los puntos finales de financiación devolverán un valor de estado diferente según el momento en que se les llame.

Tenga en cuenta que los valores de estado procedían originalmente de las páginas 16/17 del documento Internet Financial Exchange Protocol (IFEX), pero los valores se han modificado ligeramente para que sean más adecuados para las transacciones de criptomonedas (no se utilizan todos los valores de estado posibles, por ejemplo).

Depósitos

Los posibles valores de estado para las transacciones de depósito son los siguientes:

•
Liquidado = El depósito ha sido recibido pero aún necesita confirmaciones adicionales en la cadena de bloques.
•
Éxito = El depósito ha alcanzado el número requerido de confirmaciones en la cadena de bloques.
•
Fallo = El depósito falló (por una o varias razones).

Los siguientes son algunos ejemplos de cómo aparecerían los valores de estado anteriores en las respuestas del punto final DepositStatus:

Estado Liquidado:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Estado Éxito:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

Retiros

Los posibles valores de estado para las transacciones de retiro son los siguientes:

•
Inicial = La solicitud de retiro ha sido recibida y se está verificando su validez (cualquier restricción de financiación en la cuenta, etc.).
•
Pendiente = El retiro está esperando ser procesado por nuestra pasarela de financiación.
•
Liquidado = El retiro ha sido enviado a la cadena de bloques (en este punto, el ID de la transacción de la cadena de bloques estaría disponible).
•
Éxito = La transacción de retiro tiene al menos 1 confirmación en la cadena de bloques.
•
En espera = El retiro ha sido retenido y debe ser revisado manualmente por nuestro equipo de financiación.
•
Fallo = El retiro falló (por una o varias razones).

Los siguientes son algunos ejemplos de cómo aparecerían los valores de estado anteriores en las respuestas del punto final WithdrawStatus:

Estado Inicial:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Estado Pendiente:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Estado Liquidado:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Estado Éxito:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Estado Fallo:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

Información adicional sobre depósitos/retiros está disponible en nuestras páginas de soporte de financiación en efectivo y financiación de criptomonedas.

Cómo recuperar el historial de tiempo y ventas (historial de trading) utilizando el endpoint de Trades de la API REST

El punto final OHLC de la API REST solo proporciona una cantidad limitada de datos históricos, específicamente 720 puntos de datos del intervalo solicitado. Por ejemplo, solicitar datos OHLC en intervalos de 1 minuto devolverá los 720 minutos más recientes (12 horas) de datos.

Para las aplicaciones que requieren datos OHLC o de ticks adicionales, es posible recuperar todo el historial de trading de nuestros mercados (el tiempo y las ventas históricos) a través del punto final de Trades de la API REST. El OHLC para cualquier marco de tiempo y cualquier intervalo se puede crear a partir de los datos históricos de tiempo y ventas.

El punto final de Trades toma un parámetro opcional llamado since, que especifica la fecha/hora de inicio de los datos. El valor de since es una marca de tiempo UNIX con resolución de nanosegundos (una marca de tiempo UNIX estándar en segundos con 9 dígitos adicionales).

Por ejemplo, una llamada al punto final de Trades como https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 devolvería el tiempo y las ventas históricos para XBT/USD desde el 1 de junio de 2019 a las 00:00:00 UTC:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Las llamadas posteriores al punto final de Trades deben reemplazar el valor del parámetro since con el valor del parámetro last de los resultados de la llamada anterior, como https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

El uso del valor especial since de 0 (cero) devolvería el tiempo y las ventas históricos desde el inicio del mercado (comenzando con la primera operación).

Cómo colocar, ver y cancelar órdenes utilizando una referencia de usuario

Una referencia de usuario es un ID de orden proporcionado por el cliente que se puede utilizar en lugar del ID de orden real (proporcionado por la API) para algunas tareas de gestión de órdenes (especialmente la cancelación de órdenes).

Las referencias de usuario se implementan para ser lo más flexibles posible y, por lo tanto, se pueden utilizar de diversas maneras, incluyendo:

•
como un ID único (donde cada orden tiene una referencia de usuario diferente),
•
para agrupar órdenes relacionadas (como agrupar órdenes con diferentes niveles de apalancamiento),
•
o como un ID de respaldo en caso de que el ID de orden real no se conozca.

Una referencia de usuario debe ser un valor numérico entre 1 y 2.147.483.647 (esencialmente cualquier número positivo de 32 bits), y por lo tanto podría implementarse como un contador simple, como un valor aleatorio de 32 bits con signo, o incluso como una marca de tiempo en segundos (aunque esto fallaría después del 19 de enero de 2038 a las 3:14:07 UTC).

Realizar órdenes con una referencia de usuario

Las órdenes se pueden colocar con una referencia de usuario adjunta llamando al endpoint AddOrder e incluyendo el parámetro userref con la referencia de usuario como valor:

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

Visualizar órdenes que tienen una referencia de usuario

Las órdenes que ya tienen una referencia de usuario adjunta se pueden ver llamando a los endpoints Open/Closed/QueryOrders e incluyendo el parámetro userref con la referencia de usuario existente como valor (en este caso, la referencia de usuario actúa como un filtro, mostrando solo las órdenes asociadas):

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

Cancelar órdenes que tienen una referencia de usuario

Las órdenes que ya tienen una referencia de usuario adjunta se pueden cancelar utilizando la referencia de usuario llamando al endpoint CancelOrder y usando la referencia de usuario como valor txid (en lugar del valor del ID de orden):

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

Tenga en cuenta que todas las órdenes abiertas con la misma referencia de usuario se cancelarían, por lo que es posible realizar una única llamada a CancelOrder para cancelar varias órdenes simultáneamente (como lo indica el valor count de 3 en la siguiente respuesta):

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

¿Por qué recibo un error 403 al usar la API de Kraken?

Este problema puede estar relacionado con Cloudflare:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

NOTA: Kraken tiene habilitada la "Verificación de integridad del navegador".

Esto puede ocurrir si su solicitud contiene encabezados sospechosos. Por ejemplo, su solicitud puede carecer de un agente de usuario o utilizar un agente de usuario no estándar; por lo tanto, verifique los encabezados de su solicitud.

Si no puede crear ninguna solicitud estándar que nuestro sistema permita, envíenos una copia completa de la(s) solicitud(es) que está intentando, incluyendo su dirección IP y todos los encabezados. Esta información nos permitiría investigar más a fondo.

¿Kraken ofrece un entorno de prueba de API?

API de Futuros

Para nuestras API REST y WebSocket de Futuros (futures.kraken.com), ofrecemos un entorno de prueba completo utilizando la URL de la API demo-futures.kraken.com.

Entornos de prueba de REST, WebSocket y FIX

Para nuestra API REST/WebSocket y API FIX al contado, actualmente ofrecemos un entorno de prueba para clientes cualificados. El acceso a este entorno requiere un proceso de incorporación que puede iniciarse contactando directamente con el equipo de la API.

Prueba de nuestra API utilizando el parámetro de prueba de validación

Al realizar un pedido a través de los puntos finales AddOrder de la API REST o addOrder de la API WebSocket, el parámetro de entrada de validación se puede utilizar para simular el pedido.

Llamar a AddOrder/addOrder con el parámetro de validación establecido en verdadero (validate=1, validate=true, validate=anything, etc.) hará que los detalles del pedido se verifiquen en busca de errores, pero la respuesta de la API nunca incluirá un ID de pedido (que siempre se devolvería para un pedido exitoso sin el parámetro de validación).

Ejemplo de llamada a AddOrder con el parámetro validate (tenga en cuenta el ID de pedido que falta):

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

Órdenes reales pequeñas y/o órdenes con precios extremos

Para una prueba exhaustiva de la API utilizando el parámetro de validación, recomendamos colocar órdenes de mercado muy pequeñas (órdenes para el tamaño mínimo de orden), u órdenes límite que tengan un precio muy alejado del precio de mercado actual (por ejemplo, colocar una orden límite para vender ETH/USD a 800 $ cuando el precio de mercado es de 200 $).

La prueba con órdenes en vivo permite que su código API interactúe con nuestra API en condiciones reales, por lo que cada aspecto de la prueba será preciso (cómo sus órdenes afectan al libro de órdenes, etc.).

Actualización de TLS que podría afectar sus conexiones API

Por razones de seguridad, recientemente hemos dejado de dar soporte a TLS 1.0 y 1.1. Si encuentra mensajes de error de conexión SSL/TLS al intentar conectarse a nuestra API, es probable que se deba al uso de uno de estos estándares obsoletos. Deberá modificar su cliente API para forzar el uso de TLS 1.2/1.3 o actualizar su versión de .NET a 4.6 o superior, que utiliza TLS 1.2/1.3 como estándar.

Calculadora de autenticación de la API REST (Hoja de cálculo de Google)

La siguiente hoja de cálculo de Google se puede utilizar para calcular la firma de autenticación de la API REST para cualquier combinación de datos de entrada:

•
Clave privada (secreta) de la API
•
Punto final de la API (Balance, TradeBalance, QueryOrders, etc.)
•
Valor nonce (consulte nuestra página de soporte qué es un nonce para obtener más detalles)
•
Parámetros de entrada del punto final (por ejemplo, asset=doge)

La calculadora se puede utilizar para verificar que el algoritmo de autenticación se ha implementado correctamente, evitando así posibles problemas (especialmente errores inesperados de clave no válida) más adelante en el ciclo de desarrollo.

Instrucciones de uso

1
Abra la calculadora de autenticación de la API REST en Chrome (o cualquier otro navegador web reciente)
2
Haga una copia de la calculadora en su propio Google Drive a través del menú Archivo -> Hacer una copia (deberá iniciar sesión en su cuenta de Google para este paso)
3
Edite los campos clave API, punto final API, valor nonce y datos de entrada con su propia clave API y detalles de la solicitud
4
Compare la firma de autenticación de la API calculada con el valor calculado por su propio código API (los dos valores deben coincidir exactamente)

Por razones de seguridad, recomendamos utilizar la calculadora de autenticación con una clave API temporal, y luego eliminar la clave API de su cuenta una vez que la implementación de su firma de autenticación se demuestre correcta.

Ejemplo

¿Necesito usar un envoltorio de biblioteca de cliente?

El principal beneficio de usar nuestros envoltorios de biblioteca de cliente es que no necesita dedicar tiempo/esfuerzo a reinventar la rueda para crear firmas de API, ya está hecho para usted.

Si solo tiene la intención de realizar llamadas a métodos públicos, puede optar por no usar las bibliotecas de cliente, ya que no se necesita autenticación.

La lista de envoltorios disponibles se puede encontrar aquí.