Passer des ordres - addOrder
Annuler des ordres - cancelOrder
Le trading (passer et annuler des ordres) via l'API WebSocket v1 est fourni par les addOrder et cancelOrder points de terminaison. Similaire au trading via l'API REST, le point de terminaison addOrder est utilisé pour passer de nouveaux ordres, et le point de terminaison cancelOrder est utilisé pour annuler des ordres existants (ouverts).
Une fois qu'une connexion à l'API WebSocket a été établie, les ordres peuvent être passés et annulés via les étapes suivantes :
récupérer un jeton d'authentification via le point de terminaison REST API GetWebSocketsToken (une fois qu'un jeton valide a été récupéré, le même jeton peut être utilisé pour plusieurs requêtes addOrder/cancelOrder),
envoyer la requête appropriée addOrder/cancelOrder,
recevoir une réponse indiquant si la requête a réussi ou non.
Notre documentation de l'API WebSocket fournit la spécification complète pour le point de terminaison addOrder, y compris le format JSON qui doit être utilisé, ainsi que les descriptions de chaque champ requis et facultatif.
À titre d'exemple, le message JSON suivant placerait un nouvel ordre d'achat de 0,25 ETH/EUR à un prix limite de 150 € :
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
En supposant que l'ordre ci-dessus ait été passé avec succès (fonds suffisants disponibles sur le solde du compte, etc.), le message JSON suivant serait reçu en réponse :
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}
Notre documentation de l'API WebSocket fournit la spécification complète pour le point de terminaison cancelOrder, y compris le format JSON qui doit être utilisé, ainsi que les descriptions de chaque champ requis et facultatif.
Contrairement à l'API REST, le point de terminaison cancelOrder de l'API WebSocket peut être utilisé pour annuler plusieurs ordres simultanément, en spécifiant chaque ID d'ordre (ou référence utilisateur) dans le tableau txid.
À titre d'exemple, le message JSON suivant annulerait tout ordre ouvert avec les ID d'ordre correspondants :
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
En supposant que les ordres aient été annulés avec succès, le message JSON suivant serait reçu en réponse :
{
"event": "cancelOrderStatus",
"status": "ok"
}