createLimitOrder
POST/orders/limit/orders
Cria uma ordem a limite: a ordem fica registrada e aberta, e so executa se o mercado atingir o preco que voce definiu em limitPrice, dentro do prazo de validade.
A ordem so executa dentro da faixa de execucao da conta. A faixa tem a largura da tolerancia de preco da conta (percentual maior que 0 e ate 50%; o padrao e 1%): a compra executa entre limitPrice × (1 − tolerancia) e limitPrice, e a venda entre limitPrice e limitPrice × (1 + tolerancia). Preco pior que o limitPrice nunca executa, e preco melhor que o alvo alem da tolerancia tambem nao: uma compra com limitPrice bem acima do mercado fica OPEN ate o preco entrar na faixa ou o prazo vencer. Detalhes no guia Ordem a Limite — faixa de execucao.
Execucao por cotacao RFQ. Quando o preco entra na faixa, a Liqi cria uma cotacao RFQ pelo melhor preco dentro da faixa e executa a ordem por ela, como uma ordem RFQ: a exchange confere o preco cotado com a tolerancia de slippage do RFQ, para os dois lados. Recusa antes do preenchimento devolve a ordem para OPEN, e ela pode disparar de novo. A ordem executada traz o objeto RFQ no GET /orders/fetchOrder, e e por ele que se liquida. Detalhes no guia Ordem a Limite — execucao por cotacao RFQ.
O retorno e imediato (201) e vem com status: OPEN — a ordem foi registrada, nao executada. A execucao acontece depois, quando o preco e atingido. Guarde o orderId devolvido aqui: e por ele que a ordem e acompanhada e cancelada.
Pre-requisito: a ordem a limite precisa estar habilitada na sua conta. Enquanto nao estiver, a rota responde 403. Solicite a habilitacao ao suporte informando o prazo maximo de validade que pretende usar — e esse limite que vale nas validacoes abaixo.
Quantidade — o campo depende do lado da ordem. Compra (side: buy) exige quoteAmount (valor na moeda de cotacao do par, por exemplo BRL). Venda (side: sell) exige amount (quantidade de cripto). Sempre exatamente um dos dois, e o que corresponde ao lado: enviar os dois, nenhum, ou o campo do outro lado e recusado com 400.
Prazo de validade — envie no maximo um dos dois: expiresInDays (dias a partir de agora) ou expiresAt (momento absoluto, epoch em segundos). Sem nenhum dos dois, vale o prazo padrao configurado na sua conta. Nos tres casos o prazo e limitado pelo prazo maximo da conta; passar desse maximo e recusado com 400.
timeInForce aceita somente GTD (good till date): a ordem vale ate expirar. Omitir o campo assume GTD.
Reserva de saldo (venda): uma ordem de venda (side: sell) reserva o saldo do ativo base ja na criacao — o amount (quantidade da cripto) sai de free para used na carteira e fica bloqueado enquanto a ordem esta aberta. Sem saldo livre suficiente para reservar, a ordem nao abre e termina em REJECTED por saldo insuficiente. O saldo reservado e consumido na execucao e devolvido se a ordem encerra sem executar (EXPIRED/CANCELLED/REJECTED). A compra (side: buy) nao reserva saldo. Detalhes no guia Ordem a Limite — status finais e retry.
Idempotencia pelo id, resolvida de forma assincrona. O id que voce envia e a sua chave de idempotencia, e e ele que vira o orderId da ordem. Reenviar o mesmo id nao devolve erro na hora: a requisicao repetida tambem responde 201 com status: OPEN. A duplicata e identificada em seguida e encerrada em REJECTED, ficando de pe apenas uma ordem. O motivo (id ja existente) fica registrado para auditoria, mas nenhum endpoint devolve esse texto hoje: o que o cliente le e o status da ordem. Ou seja: o reenvio e seguro (nao duplica a ordem), mas o 201 nao e confirmacao de que aquela chamada foi a que sobreviveu — para saber o desfecho, consulte a ordem pelo orderId.
Request
Responses
- 201
- 400
- 403
- 404
- 500
Ordem a limite registrada e aberta.
Corpo invalido. Campo obrigatorio ausente, profileId com caractere fora de letras, numeros, espaco e hifen (Invalid Profile), symbol fora do formato BASE/QUOTE com letras sem acento e numeros, side diferente de buy/sell, limitPrice nao positivo, amount e quoteAmount juntos (ou nenhum dos dois), campo de quantidade que nao corresponde ao lado (quoteAmount ausente na compra, amount ausente na venda), expiresAt e expiresInDays juntos, prazo no passado ou acima do maximo da sua conta, ou valor abaixo do minimo configurado para o par. Na compra o valor comparado e o quoteAmount (Field `quoteAmount` is below the minimum of R$6.00 for BTC/BRL); na venda, amount x limitPrice (Order value (amount x limitPrice) R$3.50 is below the minimum of R$6.00 for BTC/BRL).
Ordem a limite recusada. Limit order is not enabled for this account: a ordem a limite nao esta habilitada na sua conta; solicite a habilitacao ao suporte. Profile buy order disabled / Profile sell order disabled: o lado da ordem (compra ou venda) esta desativado no profile informado.
Conta nao identificada pela chave de API.
Falha interna. A ordem pode nao ter sido registrada; reenvie a requisicao.