Skip to main content
POST
Criar ordem
Envie ask_id e quantity. A resposta segue o esquema Order. Campos da ordem: Ordens — Informações disponíveis. Dados do título em asset: Ativo.

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 única para esta requisição. Garante que retentativas não criem ordens duplicadas.

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 com sucesso

id
string<uuid>
required

Identificador único da ordem

type
enum<string>
required

Tipo da ordem

Available options:
sell
status
enum<string>
required

Status atual da ordem

Available options:
created,
reserved,
accepted,
processed,
transferred,
completed,
cancelled
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 do ativo na CETIP

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 utilizada na criação

asset
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