Colocar ordens - addOrder
Cancelar ordens - cancelOrder
A negociação (colocar e cancelar ordens) através da WebSocket API v1 é fornecida pelos endpoints addOrder e cancelOrder. Semelhante à negociação através da REST API, o endpoint addOrder é utilizado para colocar novas ordens, e o endpoint cancelOrder é utilizado para cancelar ordens existentes (abertas).
Uma vez estabelecida uma ligação à WebSocket API, as ordens podem ser colocadas e canceladas através dos seguintes passos:
obter um token de autenticação através do endpoint GetWebSocketsToken da REST API (uma vez obtido um token válido, o mesmo token pode ser utilizado para múltiplos pedidos de addOrder/cancelOrder),
enviar o pedido apropriado de addOrder/cancelOrder,
receber uma resposta indicando se o pedido foi bem-sucedido ou não.
A nossa documentação da WebSocket API fornece a especificação completa para o endpoint addOrder, incluindo o formato JSON que deve ser utilizado, juntamente com descrições de cada campo obrigatório e opcional.
Como exemplo, a seguinte mensagem JSON colocaria uma nova ordem para comprar 0,25 ETH/EUR a um preço limite de 150 €:
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
Assumindo que a ordem acima foi colocada com sucesso (fundos suficientes disponíveis no saldo da conta, etc.), a seguinte mensagem JSON seria recebida em resposta:
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}
A nossa documentação da WebSocket API fornece a especificação completa para o endpoint cancelOrder, incluindo o formato JSON que deve ser utilizado, juntamente com descrições de cada campo obrigatório e opcional.
Ao contrário da REST API, o endpoint cancelOrder da WebSocket API pode ser utilizado para cancelar múltiplas ordens simultaneamente, especificando cada ID de ordem (ou referência de utilizador) no array txid.
Como exemplo, a seguinte mensagem JSON cancelaria qualquer ordem aberta com os IDs de ordem correspondentes:
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
Assumindo que as ordens foram canceladas com sucesso, a seguinte mensagem JSON seria recebida em resposta:
{
"event": "cancelOrderStatus",
"status": "ok"
}