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
API WebSocket v1 - realizando e cancelando ordens
Última atualização: 1 de abr. de 2025
Nossa API WebSocket v1 oferece suporte a negociações por meio dos endpoints addOrder e cancelOrder. O endpoint addOrder é usado para fazer novos pedidos e o endpoint cancelOrder é usado para cancelar pedidos existentes (abertos).
Ambos addOrder e cancelOrder são endpoints privados, o que significa que eles só podem ser acessados por meio de uma conexão WebSocket autenticada.
Uma conexão inicial deve ser feita com a URL WebSocket autenticada wss://ws-auth.kraken.com/ , que pode então ser mantida aberta indefinidamente enquanto os pedidos são feitos e cancelados. Uma única conexão WebSocket foi projetada para suportar várias solicitações, portanto, não é necessário (nem recomendado) conectar/desconectar para cada chamada aos endpoints de negociação.
Autenticação WebSocket
Um token de autenticação WebSocket pode ser recuperado por meio do endpoint GetWebSocketsToken da API REST.
Uma vez que um token tenha sido recuperado, uma conexão pode ser feita com a URL WebSocket privada wss://ws-auth.kraken.com/ e os endpoints addOrder e cancelOrder podem então ser usados indefinidamente (o token não expirará enquanto estiver sendo usado para fazer e cancelar pedidos).
Observe que a chave de API usada para recuperar o token deve ter as permissões Modify Orders e Cancel/Close Orders, caso contrário, um erro de permissão negada será recebido da API WebSocket.
Fazendo um pedido
Uma vez estabelecida uma conexão WebSocket autenticada, um pedido pode ser feito enviando uma mensagem como a seguinte:
- •
{"event":"addOrder", "token":"nT9n23/7oLdq+bNHNMNJ4VvF1hiHhjTnPOaCMiB1GJ0", "pair":"XBT/USD", "type":"buy", "ordertype":"limit", "price":"9857", "volume":"0.002", "leverage":"5", "userref":"8874657"}
Uma resposta será então recebida indicando o status da solicitação (se o pedido foi aceito ou rejeitado). Para um pedido que foi aceito e feito com sucesso, a resposta indicará um status de ok e será semelhante ao seguinte:
- •
{"descr":"buy 0.00200000 XBTUSD @ limit 9857.0 with 5:1 leverage","event":"addOrderStatus","status":"ok","txid":"OPOUJF-BWKCL-FG5DQL"}
Para um pedido que foi rejeitado e não feito, a resposta indicará um status de erro, juntamente com uma mensagem de erro indicando o motivo da rejeição (argumentos inválidos, fundos insuficientes, etc.), como a seguinte rejeição para um pedido que não atendeu ao tamanho mínimo do pedido:
- •
{"errorMessage":"EOrder:Order minimum not met","event":"addOrderStatus","status":"error"}
Cancelando um pedido
Uma vez estabelecida uma conexão WebSocket autenticada (ou, preferencialmente, uma conexão existente reutilizada), um pedido pode ser cancelado enviando uma mensagem como a seguinte:
- •
{"event":"cancelOrder", "token":"s74Ajl83it0dNNKcF072NJ5wDmLTGIceaCbV96eWbFg", "txid":["OJZ3DI-IU6QC-ME7TVE"]}
Uma resposta será então recebida indicando o status da solicitação (se o cancelamento foi aceito ou rejeitado). Para um pedido que foi cancelado com sucesso, a resposta indicará um status de ok e será semelhante ao seguinte:
- •
{"event":"cancelOrderStatus","status":"ok"}
Para uma solicitação de cancelamento que foi rejeitada, a resposta indicará um status de erro, juntamente com uma mensagem de erro indicando o motivo da rejeição (ID de pedido inválido, etc.), como a seguinte rejeição para uma solicitação de cancelamento de um pedido que já havia sido cancelado:
- •
{"errorMessage":"EOrder:Unknown order","event":"cancelOrderStatus","status":"error"}
Observe que, ao contrário do endpoint CancelOrder da API REST, é possível especificar vários IDs de pedido em uma única mensagem de cancelamento do WebSocket. Os IDs de pedido a serem cancelados devem ser incluídos como entradas separadas dentro do array txid, da seguinte forma:
- •
{"event":"cancelOrder", "token":"c4JjTNHSurKmWDsnrGaCxIuCOa4FurCZK2ppktvT2Yo", "txid":["OLVCRZ-DNKJI-VRTZKY","O67X6E-PBGSR-GU23R5","OECCDC-T2R4V-52CR7T"]}