All
Filtrar por:
Como faço para depositar dinheiro na minha conta?
Eu preciso de ajuda com a verificação da conta
Por que não consigo acessar minha conta?
Há taxas de retirada de criptomoedas?
Eu preciso de ajuda para entrar na minha conta
Negociação via WebSocket API v1 - addOrder e cancelOrder
Última atualização: 1 de abril de 2025
- •
Realizando ordens - addOrder
- •
Cancelando ordens - cancelOrder
A negociação (realização e cancelamento de ordens) via WebSocket API v1 é fornecida pelos endpoints addOrder e cancelOrder. Semelhante à negociação via REST API, o endpoint addOrder é usado para realizar novas ordens, e o endpoint cancelOrder é usado para cancelar ordens existentes (abertas).
Uma vez que uma conexão com a WebSocket API tenha sido estabelecida, as ordens podem ser realizadas e canceladas através dos seguintes passos:
- 1
recuperar um token de autenticação via o endpoint GetWebSocketsToken da REST API (uma vez que um token válido tenha sido recuperado, o mesmo token pode ser usado para múltiplas requisições de addOrder/cancelOrder),
- 2
enviar a requisição apropriada de addOrder/cancelOrder,
- 3
receber uma resposta indicando se a requisição foi bem-sucedida ou não.
Realizando ordens - addOrder
Nossa documentação da WebSocket API fornece a especificação completa para o endpoint addOrder, incluindo o formato JSON que deve ser usado, juntamente com descrições de cada campo obrigatório e opcional.
Como exemplo, a seguinte mensagem JSON realizaria 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 realizada 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"
}
Cancelando ordens - cancelOrder
Nossa documentação da WebSocket API fornece a especificação completa para o endpoint cancelOrder, incluindo o formato JSON que deve ser usado, 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 usado para cancelar múltiplas ordens simultaneamente, especificando cada ID de ordem (ou referência de usuário) 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"
}