API pública · MCP

Os dados das emissões, direto no seu sistema

Tudo que este site mostra sobre as operações da Liqi Securitizadora — séries, PU diário, garantias, documentos, cronograma de pagamentos, obrigações, relatórios mensais — disponível por API REST e por servidor MCP para agentes de IA. Crie uma conta, gere uma chave e comece.

Criar conta e gerar chave OpenAPI (JSON)

Crie sua conta

Nome, e-mail, senha e empresa. Confirmamos o e-mail antes de liberar as chaves. Cliente da Liqi? Entre com a mesma conta do Portal do Emissor.

Gere uma chave

No painel, crie uma chave liqipub_… válida por 1 ano. Ela aparece uma única vez — guarde em local seguro. Até 5 chaves ativas por conta.

Chame a API

Envie a chave no header X-API-Key. Limite de 60 requisições por minuto por chave; a resposta traz os headers X-RateLimit-*.

Autenticação

Base URL: https://api-fb.liqi.com.br/v1/emissoes

Toda chamada de dados precisa do header X-API-Key com a chave completa (liqipub_<prefixo>.<segredo>). Também aceitamos Authorization: Bearer <chave>, que é o formato que clientes MCP costumam enviar.

Chave ausente, revogada ou expirada devolve 401. Acima de 60 req/min por chave devolve 429 com retryAfter em segundos.

Todos os dados são somente leitura e idênticos ao que qualquer visitante vê neste site. Não há dados de investidores, contas bancárias nem operações privadas.

curl

# todas as operações
curl -s "https://api-fb.liqi.com.br/v1/emissoes/operacoes" \
  -H "X-API-Key: liqipub_SEU_PREFIXO.SEU_SEGREDO"

# uma operação específica
curl -s "https://api-fb.liqi.com.br/v1/emissoes/operacoes/CRBLUNQ01" \
  -H "X-API-Key: liqipub_SEU_PREFIXO.SEU_SEGREDO"

Endpoints

GET/v1/emissoes/operacoesListar operações

Todas as operações públicas (CR, CRI, CRA, debêntures) com séries, KPIs, PU atual e totais consolidados. É o mesmo conteúdo da página inicial deste site.

GET/v1/emissoes/operacoes/{ticker}Detalhe da operação

Séries, precificação (PU atual, D-1, D-2 e histórico), garantias, documentos públicos, cronograma de pagamentos, obrigações da devedora, participantes, assembleias, comunicados e dados on-chain.

ticker(path)ticker da operação (ex.: CRBLUNQ01), como aparece na URL do site

GET/v1/emissoes/operacoes/{ticker}/relatorio-mensal/mesesMeses com relatório mensal

Competências (YYYY-MM) que possuem relatório mensal, mais recente primeiro.

ticker(path)ticker da operação

GET/v1/emissoes/operacoes/{ticker}/relatorio-mensalRelatório mensal

Recorte público do relatório gerencial: concentração, aging, PDD, LTV, pré-pagamento e covenants. Sem month, devolve a posição atual.

ticker(path)ticker da operação
month(query)competência YYYY-MM (opcional)

GET/v1/emissoes/operacoes/{ticker}/estoqueEstoque simplificado

Estoque crédito a crédito anonimizado, paginado. Disponível só para operações com quantidade de contratos administrável; senão devolve available=false com um resumo agregado.

ticker(path)ticker da operação
page(query)página, a partir de 1 (opcional)
limit(query)itens por página, máximo 100 (opcional)

Os formatos de resposta estão descritos no documento OpenAPI. Valores monetários e datas vêm formatados em pt-BR (ex.: "R$ 1.234,56", "15/03/2026"); campos *Raw trazem o valor ISO quando existe.

Exemplos

Python

import requests

API = "https://api-fb.liqi.com.br/v1/emissoes"
HEADERS = {"X-API-Key": "liqipub_SEU_PREFIXO.SEU_SEGREDO"}

ops = requests.get(f"{API}/operacoes", headers=HEADERS, timeout=30).json()
for card in ops["cards"]:
    print(card["name"], card["status"], card["kpis"][0]["value"])

detalhe = requests.get(f"{API}/operacoes/CRBLUNQ01", headers=HEADERS, timeout=30).json()
for serie in detalhe["series"]:
    print(serie["ticker"], serie["remuneracao"], serie["dataVencimento"])

JavaScript / TypeScript

const API = "https://api-fb.liqi.com.br/v1/emissoes";
const headers = { "X-API-Key": "liqipub_SEU_PREFIXO.SEU_SEGREDO" };

const ops = await fetch(`${API}/operacoes`, { headers }).then((r) => r.json());
console.log(ops.stats, ops.cards.length);

const detalhe = await fetch(`${API}/operacoes/CRBLUNQ01`, { headers }).then((r) => r.json());
console.log(detalhe.precificacao, detalhe.documents);

Servidor MCP para agentes de IA

As mesmas consultas estão disponíveis como ferramentas Model Context Protocol (transporte Streamable HTTP, sem estado). Conecte o Claude, o Cursor ou qualquer cliente MCP e pergunte em linguagem natural: "qual o PU atual da CR Blue?", "quais operações vencem em 2027?".

Endpoint: https://api-fb.liqi.com.br/v1/emissoes/mcp

Ferramenta	Entrada
`listar_operacoes` Lista todas as operações públicas com séries, KPIs e PU atual.	—
`obter_operacao` Detalhe completo de uma operação.	ticker
`listar_meses_relatorio` Competências com relatório mensal disponível.	ticker
`obter_relatorio_mensal` Relatório mensal público da operação.	ticker, month?
`obter_estoque` Estoque crédito a crédito anonimizado, paginado.	ticker, page?, limit?

Claude Desktop / claude_desktop_config.json

{
  "mcpServers": {
    "liqi-emissoes": {
      "type": "http",
      "url": "https://api-fb.liqi.com.br/v1/emissoes/mcp",
      "headers": { "Authorization": "Bearer liqipub_SEU_PREFIXO.SEU_SEGREDO" }
    }
  }
}

Claude Code

claude mcp add --transport http liqi-emissoes https://api-fb.liqi.com.br/v1/emissoes/mcp \
  --header "Authorization: Bearer liqipub_SEU_PREFIXO.SEU_SEGREDO"

Teste rápido com curl (JSON-RPC)

curl -s https://api-fb.liqi.com.br/v1/emissoes/mcp \
  -H "Authorization: Bearer liqipub_SEU_PREFIXO.SEU_SEGREDO" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"obter_operacao","arguments":{"ticker":"CRBLUNQ01"}}}'

Limites e boas práticas

Com que frequência os dados mudam?

PU e cronograma são recalculados diariamente; documentos e comunicados entram assim que publicados. O campo generatedAt diz quando a resposta foi montada. Uma consulta a cada poucos minutos é mais do que suficiente — não há cache do nosso lado, cada chamada custa uma leitura completa.

Posso usar em produção?

Sim. A chave vale por 365 dias e pode ser revogada a qualquer momento no painel. Guarde o segredo em variável de ambiente, nunca em código versionado. Se vazar, revogue e gere outra.

Sou cliente da Liqi (emissor). Preciso de outra conta?

Não. Entre no painel com o mesmo e-mail e senha do Portal do Emissor. Para dados privados da sua operação (parcelas, extratos, cessões), use a API do Portal do Emissor, que tem chaves próprias.

Esses dados valem como informação oficial?

São os mesmos dados de transparência exibidos neste site, mantidos pela securitizadora conforme a Resolução CVM 160. Os documentos oficiais (termo de securitização, relatórios do agente fiduciário) continuam sendo a fonte primária.

Acessar o painelDúvidas ou limites maiores: [email protected]