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
- 202
- 400
- 404
- 500
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.
Corpo invalido: nenhum seletor, mais de um seletor, orderIds sem identificador utilizavel, ou corpo que nao e JSON valido.
Conta nao identificada pela chave de API.
Falha interna. O pedido pode nao ter sido registrado; reenvie a requisicao.