Visão Geral

A Liqi é a infraestrutura de tokenização de ativos financeiros para o mercado de capitais brasileiro. Nossa plataforma permite que securitizadoras, gestoras e fintechs emitam, distribuam e gerenciem títulos digitais (tokens) lastreados em direitos creditórios — tudo com registro em blockchain e conformidade regulatória.

Este portal de documentação cobre as quatro APIs que compõem o ecossistema Liqi.

Arquitetura de APIs

A Liqi expõe quatro superfícies de API distintas, cada uma projetada para um caso de uso específico:

API	Autenticação	Descrição
Public API	Nenhuma	Dados públicos de séries, patrimônios e ativos tokenizados. Ideal para dashboards, aggregators e integração de dados.
Developer API	API Key (`X-API-Key`)	Endpoints protegidos para parceiros que precisam consultar contratos blockchain, metadados on-chain e informações estendidas.
TIDC v1	RSA-SHA256	API de cessão de crédito e liquidação para originadores. Cada requisição é assinada digitalmente com chave RSA privada.
CaaS	JWT (EdDSA)	Crypto as a Service — execução de ordens, carteiras custodiadas, cotações e liquidação em exchanges centralizadas.

Text

+---------------------------+
                        |      Liqi Platform        |
                        |       api.liqi.com.br     |
                        +---------------------------+
                       /       |         |           \
              +-------+  +----+----+ +---+-----+ +---+------+
              |Public |  |Developer| | TIDC v1 | |   CaaS   |
              | API   |  |  API    | |         | |          |
              |No auth|  |API Key  | |RSA-SHA256| |  JWT    |
              +-------+  +---------+ +---------+ +----------+

Para quem é esta documentação

Esta documentação foi escrita para:

Desenvolvedores backend que precisam integrar suas plataformas com a Liqi via REST API
CTOs e arquitetos avaliando a infraestrutura técnica para tokenização de ativos
Parceiros e originadores que necessitam ceder créditos e receber notificações de liquidação via TIDC v1
Fintechs que desejam oferecer serviços de cripto custódia e trading via CaaS

Base URL

Todas as APIs compartilham o mesmo domínio base:

Text

https://api.liqi.com.br

As rotas são diferenciadas pelo prefixo do path:

API	Prefixo	Exemplo
Public API	`/public/`	`GET /public/tranches`
Developer API	`/developer/`	`GET /developer/contracts`
TIDC v1	`/tidc/v1/`	`POST /tidc/v1/credit-batches`
CaaS	`/v1/`	`POST /v1/auth/login`

Conceitos fundamentais

Antes de começar a integrar, é importante entender os conceitos centrais:

Patrimônio

Um patrimônio separado é a estrutura jurídica que isola ativos e passivos de uma operação de securitização. Cada patrimônio possui suas próprias contas bancárias, séries e ativos vinculados.

Série (Tranche)

Uma série é um título digital emitido dentro de um patrimônio. Cada série tem um ticker único (ex: ROB1SR06), uma classe de risco (Senior, Mezanino, Junior ou Única) e uma taxa de remuneração definida.

Token

Cada série é dividida em tokens — unidades fracionadas do título. Os tokens são registrados em blockchain (XDC Network) como NFTs usando o padrão ERC-721A.

TIDC

Token de Investimento em Direitos Creditórios — o instrumento financeiro regulado que representa a securitização de recebíveis na blockchain.

Próximos passos

Começando — Faça sua primeira chamada de API em menos de 5 minutos
Autenticação — Entenda os métodos de autenticação disponíveis
Public API — Explore os endpoints públicos sem autenticação
TIDC v1 — Integre cessão de crédito e liquidação
CaaS — Configure trading e custódia de criptoativos