Pular para o conteúdo principal

cancelLimitOrdersBatch

POST 

/orders/limit/orders/cancel

Disponibilidade: esta rota ainda nao esta ativa. O contrato abaixo esta publicado para voce preparar a integracao; a Liqi avisa quando a rota entrar em Sandbox e, depois, em Producao. Chamadas feitas antes disso respondem 404.

Pede o cancelamento de varias ordens a limite de uma vez.

O 202 e o aceite do pedido, nao a confirmacao de que ordens foram canceladas. A Liqi registra o pedido e o processa em seguida: as ordens abertas que casarem com o seletor passam a CANCELLED de forma assincrona. Duas consequencias praticas: a resposta nao diz quantas ordens foram atingidas, e um seletor que nao encontra nenhuma ordem aberta tambem responde 202 — pedido aceito, nada a cancelar. Para saber o resultado, consulte as ordens depois — GET /orders/limit/orders (eventualmente consistente) ou GET /orders/fetchOrder ordem a ordem. O lote nao gera evento no canal watchOrders: nesta entrega o canal nao publica as transicoes proprias da ordem a limite, entao o acompanhamento e por consulta REST.

Envie exatamente um seletor: symbol, orderIds ou profileId. Nenhum ou mais de um e recusado com 400 — nao existe "cancelar tudo" nesta rota, e combinar seletores seria ambiguo.

symbol atravessa clientes: cancela as ordens abertas daquele par em todos os profiles da conta. Para restringir a um cliente, use profileId; para escolher ordens especificas, use orderIds.

reason e opcional e acompanha o pedido em lote, sendo devolvido no 202; omitido, a Liqi usa um motivo padrao. Diferente do cancelamento unitario, no lote o motivo fica no pedido e nao em cada ordem atingida. Quem pediu o cancelamento e identificado pelo servidor a partir da chave de API — nao existe campo para isso na requisicao.

Request

Responses

Pedido aceito e registrado. Nao confirma que alguma ordem foi cancelada: o seletor e expandido depois, e um seletor sem nenhuma ordem aberta tambem chega aqui.