WebSocket API v1 - realizar y cancelar órdenes

Última actualización: More than 3 months ago

Nuestra WebSocket API v1 admite el trading a través de los endpoints addOrder y cancelOrder. El endpoint addOrder se utiliza para realizar nuevas órdenes y el endpoint cancelOrder se utiliza para cancelar órdenes existentes (abiertas).

Tanto addOrder como cancelOrder son endpoints 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 órdenes. 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 endpoints de trading.

Autenticación de WebSocket

Se puede recuperar un token de autenticación de WebSocket a través del endpoint GetWebSocketsToken de la REST API.

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 endpoints addOrder y cancelOrder se pueden utilizar indefinidamente (el token no caducará mientras se utilice para realizar y cancelar órdenes).

Ten en cuenta que la clave API que se utiliza para recuperar el token debe tener los permisos Modify Orders y Cancel/Close Orders, de lo contrario, la WebSocket API devolverá un error de permiso denegado.

Realizar una orden

Una vez establecida una conexión WebSocket autenticada, se puede realizar una orden 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"}

A continuación, se recibirá una respuesta que indicará el estado de la solicitud (si la orden fue aceptada o rechazada). Para una orden que fue aceptada y realizada 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 una orden que fue rechazada y no realizada, 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 una orden que no cumplía con el tamaño mínimo de orden:

  • •

    {"errorMessage":"EOrder:Order minimum not met","event":"addOrderStatus","status":"error"}

Cancelar una orden

Una vez establecida una conexión WebSocket autenticada (o preferiblemente reutilizando una conexión existente), se puede cancelar una orden enviando un mensaje como el siguiente:

  • •

    {"event":"cancelOrder", "token":"s74Ajl83it0dNNKcF072NJ5wDmLTGIceaCbV96eWbFg", "txid":["OJZ3DI-IU6QC-ME7TVE"]}

A continuación, se recibirá una respuesta que indicará el estado de la solicitud (si la cancelación fue aceptada o rechazada). Para una orden que fue cancelada 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 orden no válida, etc.), como el siguiente rechazo para una solicitud de cancelación de una orden que ya había sido cancelada:

  • •

    {"errorMessage":"EOrder:Unknown order","event":"cancelOrderStatus","status":"error"}

Ten en cuenta que, a diferencia del endpoint CancelOrder de la REST API, es posible especificar múltiples ID de orden en un solo mensaje de cancelación de WebSocket. Las ID de orden 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"]}

¿Necesita más ayuda?