Skip to main content
POST
/
orders
Criar ordem
curl --request POST \
  --url https://api.liquiditi.com.br/v1/orders \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "ask_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "quantity": 2
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "sell",
  "status": "created",
  "ask_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "quantity": 123,
  "asset_code": "<string>",
  "asset_type": "CDB",
  "idempotency_key": "<string>",
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "CDB",
    "name": "<string>",
    "cetip_code": "<string>",
    "maturity_date": "2023-12-25",
    "grace_date": "2023-12-25",
    "asset_indexer": "<string>",
    "interest_redemption_type": "<string>",
    "redemption_type": "<string>",
    "issuer": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "expected_liquidation_date": "2023-12-25",
  "transitions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "transitioned_at": "2023-11-07T05:31:56Z",
      "status": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developer.liquiditi.com.br/llms.txt

Use this file to discover all available pages before exploring further.

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