Public APINo auth

Séries (Tranches)

Consulta de séries tokenizadas (tranches) emitidas pela Liqi. Esses endpoints retornam informações públicas sobre cada série, incluindo dados financeiros, cronogramas de pagamento e preço unitário atual.

Base URL

Todos os endpoints da Public API usam a base URL https://api.liqi.com.br. Nenhuma autenticação é necessária.

Listar Séries

GET/public/tranches

Retorna uma lista paginada de todas as séries ativas e públicas.

Query Parameters

Name	Type	Required	Description
`page`	integer	Optional	Número da página para paginação.(default: `1`)
`limit`	integer	Optional	Quantidade de registros por página.(default: `10`)
`status`	string	Optional	Filtrar por status da série: ACTIVE, CLOSED, FUNDRAISING.
`class`	string	Optional	Filtrar por classe: SENIOR, MEZZANINE, JUNIOR, SINGLE.
`patrimonyId`	uuid	Optional	Filtrar séries de um patrimônio específico.

Resposta

Retorna um objeto paginado contendo um array data de séries, o total de registros, a página atual e o limite.

Buscar Série por Ticker

GET/public/tranches/:ticker

Retorna os dados de uma série específica pelo seu ticker.

Path Parameters

Name	Type	Required	Description
`ticker`	string	Required	Ticker único da série. Ex: ROB1SR06, MLLR1SR01.

Resposta

Retorna os dados básicos da série, incluindo remuneração, quantidade de tokens, valor investido e datas de referência.

Ticker vs ID

O ticker é um identificador legível e único (ex: ROB1SR06). Prefira usá-lo em vez do UUID quando possível.

Detalhes Completos da Série

GET/public/tranches/:ticker/details

Retorna dados completos da série, incluindo patrimônio vinculado, preço unitário atual e resumo do cronograma.

Path Parameters

Name	Type	Required	Description
`ticker`	string	Required	Ticker único da série.

Resposta

Além dos dados básicos da série, inclui:

patrimony — dados do patrimônio separado (nome, CNPJ)
currentUnitPrice — PU sujo, PU limpo e juros do dia mais recente
paymentScheduleSummary — total de parcelas, parcelas pagas e próxima data de vencimento

Cronograma de Pagamentos

GET/public/tranches/:ticker/payment-schedule

Retorna o cronograma completo de pagamentos (juros e amortização) da série.

Path Parameters

Name	Type	Required	Description
`ticker`	string	Required	Ticker único da série.

Campos da Resposta

Cada entrada no array entries contem:

Name	Type	Required	Description
`installmentNumber`	integer	Required	Número sequencial da parcela (1, 2, 3...).
`dueDate`	date	Required	Data de vencimento no formato YYYY-MM-DD.
`status`	string	Required	Status da parcela: PENDING, CONFIRMED, PAID, OVERDUE, CANCELLED.
`interestPercentage`	decimal	Required	Percentual de juros a pagar nesta parcela (100 = 100%).
`principalPercentage`	decimal	Required	Percentual do principal a amortizar nesta parcela.
`interestValue`	decimal	Required	Valor de juros em R$ (total para todos os tokens).
`principalValue`	decimal	Required	Valor de amortização do principal em R$.
`totalValue`	decimal	Required	Valor total da parcela (juros + amortização) em R$.

Valores de parcelas PENDING

Os valores de parcelas com status PENDING são estimativas recalculadas diariamente com base no PU atual. Apenas parcelas PAID têm valores definitivos.

Exportar Cronograma (CSV)

GET/public/tranches/:ticker/payment-schedule/export

Exporta o cronograma de pagamentos da série em formato CSV.

Path Parameters

Name	Type	Required	Description
`ticker`	string	Required	Ticker único da série.

Resposta

Retorna um arquivo CSV com o header Content-Type: text/csv. O nome do arquivo segue o padrão cronograma-TICKER.csv.

As colunas são as mesmas do endpoint JSON: installmentNumber, dueDate, status, interestPercentage, principalPercentage, interestValue, principalValue, totalValue.

Referência de Valores

Status da Série

Valor	Descrição
`FUNDRAISING`	Série em captação, aceitando novos investimentos.
`ACTIVE`	Série ativa, com remuneração e pagamentos em andamento.
`CLOSED`	Série encerrada, todas as parcelas foram pagas.

Classe da Série

Valor	Descrição
`SENIOR`	Classe sênior, prioridade máxima no pagamento.
`MEZZANINE`	Classe mezanino, prioridade intermediária.
`JUNIOR`	Classe júnior, subordinada às demais.
`SINGLE`	Classe única, sem subordinação.

Tipo de Remuneração

Valor	Descrição
`PRE_FIXED`	Taxa fixa anual (ex: 18.57% a.a.).
`CDI`	Pós-fixado atrelado ao CDI + spread (ex: CDI + 3%).

Listar Séries

cURL

curl -X GET "https://api.liqi.com.br/public/tranches?page=1&limit=10" \
  -H "Accept: application/json"

200Lista paginada de séries

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "ticker": "ROB1SR06",
      "name": "Roberta Senior 06",
      "status": "ACTIVE",
      "visibility": "PUBLIC",
      "class": "SENIOR",
      "remunerationType": "PRE_FIXED",
      "remunerationPercentagePerYear": "18.57",
      "tokenQuantity": "20000",
      "unitPrice": "100.00",
      "totalValue": "500000.00",
      "investedAmount": "442112.42",
      "remunerationStartDate": "2024-06-01",
      "maturityDate": "2025-06-01",
      "patrimonyId": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "createdAt": "2024-05-15T10:30:00.000Z"
    }
  ],
  "total": 45,
  "page": 1,
  "limit": 10
}

Buscar por Ticker

cURL

curl -X GET "https://api.liqi.com.br/public/tranches/ROB1SR06" \
  -H "Accept: application/json"

200Dados da série

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "ticker": "ROB1SR06",
  "name": "Roberta Senior 06",
  "status": "ACTIVE",
  "class": "SENIOR",
  "remunerationType": "PRE_FIXED",
  "remunerationPercentagePerYear": "18.57",
  "dayCountBasis": "CIVIL",
  "tokenQuantity": "20000",
  "unitPrice": "100.00",
  "totalValue": "500000.00",
  "investedAmount": "442112.42",
  "remunerationStartDate": "2024-06-01",
  "maturityDate": "2025-06-01",
  "patrimonyId": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
  "patrimonyName": "Patrimonio Roberta",
  "createdAt": "2024-05-15T10:30:00.000Z"
}

Detalhes Completos

cURL

curl -X GET "https://api.liqi.com.br/public/tranches/ROB1SR06/details" \
  -H "Accept: application/json"

200Detalhes completos da série

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "ticker": "ROB1SR06",
  "name": "Roberta Senior 06",
  "status": "ACTIVE",
  "class": "SENIOR",
  "remunerationType": "PRE_FIXED",
  "remunerationPercentagePerYear": "18.57",
  "dayCountBasis": "CIVIL",
  "tokenQuantity": "20000",
  "unitPrice": "100.00",
  "totalValue": "500000.00",
  "investedAmount": "442112.42",
  "remunerationStartDate": "2024-06-01",
  "maturityDate": "2025-06-01",
  "patrimony": {
    "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "name": "Patrimonio Roberta",
    "cnpj": "12.345.678/0001-90"
  },
  "currentUnitPrice": {
    "dateCalc": "2025-01-15",
    "unitPrice": "103.45678900",
    "nominalValue": "100.00000000",
    "interestJ": "3.45678900"
  },
  "paymentScheduleSummary": {
    "totalInstallments": 12,
    "paidInstallments": 7,
    "nextDueDate": "2025-02-01"
  }
}

Cronograma de Pagamentos

cURL

curl -X GET "https://api.liqi.com.br/public/tranches/ROB1SR06/payment-schedule" \
  -H "Accept: application/json"

200Lista de parcelas do cronograma

{
  "ticker": "ROB1SR06",
  "entries": [
    {
      "installmentNumber": 1,
      "dueDate": "2024-07-01",
      "status": "PAID",
      "interestPercentage": "100.00",
      "principalPercentage": "0.00",
      "interestValue": "6836.12",
      "principalValue": "0.00",
      "totalValue": "6836.12"
    },
    {
      "installmentNumber": 2,
      "dueDate": "2024-08-01",
      "status": "PAID",
      "interestPercentage": "100.00",
      "principalPercentage": "0.00",
      "interestValue": "6836.12",
      "principalValue": "0.00",
      "totalValue": "6836.12"
    },
    {
      "installmentNumber": 12,
      "dueDate": "2025-06-01",
      "status": "PENDING",
      "interestPercentage": "100.00",
      "principalPercentage": "100.00",
      "interestValue": "6836.12",
      "principalValue": "442112.42",
      "totalValue": "448948.54"
    }
  ]
}

Exportar CSV

cURL

curl -X GET "https://api.liqi.com.br/public/tranches/ROB1SR06/payment-schedule/export" \
  -H "Accept: text/csv" \
  -o cronograma-ROB1SR06.csv

200Arquivo CSV

installmentNumber,dueDate,status,interestPercentage,principalPercentage,interestValue,principalValue,totalValue
1,2024-07-01,PAID,100.00,0.00,6836.12,0.00,6836.12
2,2024-08-01,PAID,100.00,0.00,6836.12,0.00,6836.12
...
12,2025-06-01,PENDING,100.00,100.00,6836.12,442112.42,448948.54