All
Filtrar por:
¿Cómo deposito efectivo en mi cuenta?
Necesito ayuda con la verificación de la cuenta
¿Por qué no puedo acceder a mi cuenta?
¿Existen comisiones por retirar criptomonedas?
Necesito ayuda para iniciar sesión en mi cuenta
API WebSocket v1 - realizar y cancelar órdenes
Última actualización: 1 abr 2025
Nuestra API WebSocket v1 admite el trading a través de los puntos finales addOrder y cancelOrder. El punto final addOrder se utiliza para realizar nuevos pedidos y el punto final cancelOrder se utiliza para cancelar pedidos existentes (abiertos).
Tanto addOrder como cancelOrder son puntos finales privados, lo que significa que solo se puede acceder a ellos a través de una conexión WebSocket autenticada.
Se debe realizar una conexión inicial a la URL de WebSocket autenticada wss://ws-auth.kraken.com/, que luego puede mantenerse abierta indefinidamente mientras se realizan y cancelan pedidos. Una única conexión WebSocket está diseñada para admitir múltiples solicitudes, por lo que no es necesario (ni recomendable) conectarse/desconectarse para cada llamada a los puntos finales de trading.
Autenticación de WebSocket
Se puede recuperar un token de autenticación de WebSocket a través del punto final GetWebSocketsToken de la API REST.
Una vez que se ha recuperado un token, se puede establecer una conexión con la URL privada de WebSocket wss://ws-auth.kraken.com/ y los puntos finales addOrder y cancelOrder se pueden utilizar indefinidamente (el token no caducará mientras se utilice para realizar y cancelar pedidos).
Tenga en cuenta que la clave API que se utiliza para recuperar el token debe tener los permisos Modificar pedidos y Cancelar/Cerrar pedidos, de lo contrario, se recibirá un error de permiso denegado de la API WebSocket.
Realizar un pedido
Una vez establecida una conexión WebSocket autenticada, se puede realizar un pedido enviando un mensaje como el siguiente:
- •
{"event":"addOrder", "token":"nT9n23/7oLdq+bNHNMNJ4VvF1hiHhjTnPOaCMiB1GJ0", "pair":"XBT/USD", "type":"buy", "ordertype":"limit", "price":"9857", "volume":"0.002", "leverage":"5", "userref":"8874657"}
Luego se recibirá una respuesta que indicará el estado de la solicitud (si el pedido fue aceptado o rechazado). Para un pedido que fue aceptado y realizado con éxito, la respuesta indicará un estado de ok y será similar a la siguiente:
- •
{"descr":"buy 0.00200000 XBTUSD @ limit 9857.0 with 5:1 leverage","event":"addOrderStatus","status":"ok","txid":"OPOUJF-BWKCL-FG5DQL"}
Para un pedido que fue rechazado y no realizado, la respuesta indicará un estado de error, junto con un mensaje de error que indicará el motivo del rechazo (argumentos no válidos, fondos insuficientes, etc.), como el siguiente rechazo para un pedido que no cumplió con el tamaño mínimo de pedido:
- •
{"errorMessage":"EOrder:Order minimum not met","event":"addOrderStatus","status":"error"}
Cancelar un pedido
Una vez establecida una conexión WebSocket autenticada (o preferiblemente reutilizada una conexión existente), se puede cancelar un pedido enviando un mensaje como el siguiente:
- •
{"event":"cancelOrder", "token":"s74Ajl83it0dNNKcF072NJ5wDmLTGIceaCbV96eWbFg", "txid":["OJZ3DI-IU6QC-ME7TVE"]}
Luego se recibirá una respuesta que indicará el estado de la solicitud (si la cancelación fue aceptada o rechazada). Para un pedido que fue cancelado con éxito, la respuesta indicará un estado de ok y será similar a la siguiente:
- •
{"event":"cancelOrderStatus","status":"ok"}
Para una solicitud de cancelación que fue rechazada, la respuesta indicará un estado de error, junto con un mensaje de error que indicará el motivo del rechazo (ID de pedido no válido, etc.), como el siguiente rechazo para una solicitud de cancelación de un pedido que ya había sido cancelado:
- •
{"errorMessage":"EOrder:Unknown order","event":"cancelOrderStatus","status":"error"}
Tenga en cuenta que, a diferencia del endpoint CancelOrder de la API REST, es posible especificar múltiples ID de órdenes en un único mensaje de cancelación de WebSocket. Los ID de órdenes que se van a cancelar deben incluirse como entradas separadas dentro del array txid, de la siguiente manera:
- •
{"event":"cancelOrder", "token":"c4JjTNHSurKmWDsnrGaCxIuCOa4FurCZK2ppktvT2Yo", "txid":["OLVCRZ-DNKJI-VRTZKY","O67X6E-PBGSR-GU23R5","OECCDC-T2R4V-52CR7T"]}