Negociación con la WebSocket API v1 - addOrder y cancelOrder

Última actualización: 1 de abril de 2025
  • •

    Realizar órdenes - addOrder

  • •

    Cancelar órdenes - cancelOrder

La negociación (realizar y cancelar órdenes) a través de la WebSocket API v1 se proporciona mediante los addOrder y cancelOrder endpoints. De forma similar a la negociación a través de la REST API, el endpoint addOrder se utiliza para realizar nuevas órdenes, y el endpoint cancelOrder se utiliza para cancelar órdenes existentes (abiertas).

Una vez que se ha establecido una conexión a la WebSocket API, las órdenes se pueden realizar y cancelar siguiendo estos pasos:

  1. 1

    recuperar un token de autenticación a través del endpoint GetWebSocketsToken de la REST API (una vez que se ha recuperado un token válido, el mismo token se puede utilizar para múltiples solicitudes de addOrder/cancelOrder),

  2. 2

    enviar la solicitud adecuada de addOrder/cancelOrder,

  3. 3

    recibir una respuesta que indique si la solicitud fue exitosa o no.

Realizar órdenes - addOrder

Nuestra documentación de la WebSocket API proporciona la especificación completa para el endpoint addOrder, incluyendo el formato JSON que debe utilizarse, junto con descripciones de cada campo requerido y opcional.

Como ejemplo, el siguiente mensaje JSON realizaría una nueva orden para comprar 0,25 ETH/EUR a un precio límite de 150 €:

{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}

Suponiendo que la orden anterior se realizó con éxito (fondos suficientes disponibles en el saldo de la cuenta, etc.), se recibiría el siguiente mensaje JSON como respuesta:

{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}

Cancelar órdenes - cancelOrder

Nuestra documentación de la WebSocket API proporciona la especificación completa para el endpoint cancelOrder, incluyendo el formato JSON que debe utilizarse, junto con descripciones de cada campo requerido y opcional.

A diferencia de la REST API, el endpoint cancelOrder de la WebSocket API se puede utilizar para cancelar múltiples órdenes simultáneamente, especificando cada ID de orden (o referencia de usuario) en el array txid.

Como ejemplo, el siguiente mensaje JSON cancelaría cualquier orden abierta con los ID de orden coincidentes:

{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}

Suponiendo que las órdenes se cancelaron con éxito, se recibiría el siguiente mensaje JSON como respuesta:

{
"event": "cancelOrderStatus",
"status": "ok"
}

¿Necesitas más ayuda?