Skip to main content
POST
Criar ordem
Envie ask_id e quantity para comprar a partir de uma oferta. O header x-idempotency-key é obrigatório. Uma chave repetida devolve 201 com a ordem já existente. A resposta segue o esquema Order. Campos da ordem: Ordens — Informações disponíveis.

Authorizations

x-api-key
string
header
required

Chave de API gerada no painel da Liquiditi

Headers

x-idempotency-key
string
required

Chave de idempotência (1 a 200 caracteres). A resposta ecoa a mesma chave no header x-idempotency-key.

Required string length: 1 - 200

Body

application/json
ask_id
string<uuid>
required

Identificador da oferta no livro de ofertas

quantity
integer
required

Quantidade de títulos a reservar

Required range: x >= 1

Response

Ordem criada, ou ordem já existente para esta chave de idempotência

id
string<uuid>
required

Identificador único da ordem

type
enum<string>
required

Tipo da ordem. Criar ordem compra a partir de uma oferta; o valor exposto pela API é sell.

Available options:
sell
status
enum<string>
required

Status da ordem.

Available options:
created,
reserved,
accepted,
processed,
transferred,
completed,
failed
ask_id
string<uuid>
required

Identificador da oferta no livro de ofertas

quantity
integer
required

Quantidade de títulos

asset_code
string
required

Código CETIP do título

asset_type
enum<string>
required

Tipo do título (CDB, letras, CRIs/CRAs, debêntures)

Available options:
CDB,
LCI,
LCA,
LCD,
LF,
CRI,
CRA,
DEB
idempotency_key
string
required

Chave de idempotência enviada na criação

metadata
object
required
created_at
string<date-time>
required

Data e hora de criação da ordem

expected_liquidation_date
string<date>
required

Data prevista de liquidação

transitions
object[]
required

Histórico de transições de status da ordem