Pular para o conteúdo principal

fetchLimitOrders

GET 
/orders/limit/orders

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.

Lista as ordens a limite da sua conta, das mais recentes para as mais antigas. O escopo e sempre a conta da chave de API usada na requisicao.

O item da listagem e enxuto — sao os nove campos descritos abaixo. Ele nao traz a quantidade da ordem (amount / quoteAmount), nem os carimbos de disparo (triggerPrice, triggerExchange, triggeredAt), nem o motivo do encerramento. Para o detalhe completo de uma ordem, use o GET /orders/fetchOrder.

A listagem e eventualmente consistente. Ela le de uma base de consulta alimentada por replicacao, entao uma ordem criada agora pode levar alguns instantes para aparecer aqui — isso e comportamento esperado, nao falha. Para confirmar na hora o que acabou de ser criado, use o proprio retorno do POST /orders/limit/orders (que ja devolve a ordem inteira) ou consulte a ordem pelo GET /orders/fetchOrder, que le do registro e responde o estado atual.

Paginacao: percorra as paginas enquanto a resposta trouxer paginationToken, reenviando o valor recebido no parametro de mesmo nome. A ausencia do campo e o unico sinal de que acabou. O token so acompanha uma pagina que veio cheia (limit itens), entao uma pagina mais curta que o limit ja e a ultima; e quando o total e multiplo exato do limit, a chamada seguinte volta vazia e sem token. Trate o token como opaco: se voce alterar ou remontar o valor, ele e descartado em silencio e a consulta volta para a primeira pagina — o que faz o laco de paginacao nunca terminar.

Filtros se combinam (todos precisam bater). status aceita os atalhos ACTIVE (ordens que ainda podem executar) e FINALIZED (ordens que nao executam mais), ou uma lista de status separados por virgula, sempre em MAIUSCULAS. Valores individuais aceitos: OPEN, TRIGGERED, PROCESSING, CANCELLING, EXECUTED, CLOSED, EXPIRED, CANCELLED, REJECTED. Valor nao reconhecido em status e simplesmente ignorado: a resposta volta sem esse filtro, nao com erro.

Lista vazia e indisponibilidade sao coisas diferentes. 200 com orders: [] quer dizer que nao existe ordem para o filtro informado. 503 quer dizer que a consulta esta temporariamente indisponivel — nao ha informacao sobre as suas ordens nessa resposta, e a requisicao pode ser repetida.

Request​

Responses​

Pagina de ordens a limite. Lista vazia significa que nao ha ordem para o filtro informado. paginationToken vem apenas quando pode haver mais paginas.