API Websocket de trading - addOrder et cancelOrder
  • Placer des ordres - addOrder
  • Annuler des ordres - cancelOrder
Le trading (placer et annuler des ordres) via l'API WebSocket est géré par les endpoints addOrder et cancelOrder. De façon similaire à l'API REST, l'endpoint addOrder est utilisé pour placer de nouveaux ordres, et l'endpoint cancelOrder est utilisé pour annuler des ordres existants (ouverts).
Une fois qu'une connexion à l'API WebSocket a été établie, des ordres peuvent être placés et annulés en suivant les étapes suivantes:
  1. 1.
    récupérez un token d'authentification via l'endpoint GetWebSocketsToken de l'API REST (une fois qu'un token valdie a été récupéré, le même token peut être utilisé pour plusieurs requêtes addOrder/cancelOrder),
  2. 2.
    envoyez la requête appropriée addOrder/cancelOrder,
  3. 3.
    recevez une réponse indiquant si la requête a été succès ou non.

Placer des ordres - addOrder

Notre documentation pour l'API WebSocket fournit une spécification complète pour l'endpoint addOrder, incluant le format JSON qui doit être utilisé, accompagné des descriptions de chaque champ requis et optionnel.
Par exemple, le message JSON suivant placerait un nouvel ordre afin d'acheter 0.25 ETH/EUR à un prix à cours limité de 150EUR:
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
Assumant que l'ordre ci-dessus a été placé avec succès (des fonds suffisants disponibles dans le solde de compte, etc.), le message JSON suivant serait reçu comme réponse:
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}

Annuler des ordres - cancelOrder

Notre documentation pour l'API WebSocket fournit une spécification complète pour l'endpoint cancelOrder, incluant le format JSON qui doit être utilisé, accompagné des descriptions de chaque champ requis et optionnel.
Contrairement à l'API REST, l'endpoint cancelOrder de l'API WebSocket peut être utilisé afin d'annuler de multiples ordres simultanément en spécifiant l'ID d'ordre (ou référence utilisateur) dans le tableau txid.
Par exemple, le message JSON suivant permettrait d'annuler tout ordre ouvert avec les IDs d'ordre associés:
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
Assumant que les ordres ont été annulés avec succès, le message JSON suivant sera reçu en réponse:
{
"event": "cancelOrderStatus",
"status": "ok"
}