API de FIDC e FIP: carteira, risco e relatórios da CVM

FIDC e FIP caem no mesmo grupo de fundos estruturados e divulgam coisas bem diferentes. No FIDC a atenção vai para carteira de recebíveis, inadimplência e classes de cotas. O FIP publica capital, participações e investidores em relatórios periódicos.

Boa parte desses fundos não tem ticker na B3, então o CNPJ acaba sendo o identificador que funciona sempre. A brapi aceita cnpjs nas três rotas deste artigo.

Qual endpoint usar

A documentação de fundos liga cada rota ao schema OpenAPI atual e explica quando usar símbolo ou CNPJ.

Encontrar o fundo pelo CNPJ

Comece em /api/v2/funds/list. O filtro assetType aceita fidc e fip, e você pode passar cnpjs direto quando já conhece o cadastro.

curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/v2/funds/list?assetType=fidc&search=credito&limit=20"

Guarde o CNPJ como texto. Converter para inteiro come os zeros à esquerda e o identificador deixa de casar com a fonte.

Um mesmo CNPJ pode abrigar classes ou séries com características próprias. Agrupar tudo por CNPJ soma cotas que não são comparáveis. Preserve os campos de classe que vierem na resposta.

Consultar relatórios mensais de FIDC

/api/v2/funds/fidc/reports aceita cnpjs, symbols, intervalo de datas, paginação e ordenação, e devolve a coleção reports.

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['BRAPI_TOKEN']}"}
cnpj = os.environ["FUNDO_CNPJ"]

response = requests.get(
    "https://brapi.dev/api/v2/funds/fidc/reports",
    params={
        "cnpjs": cnpj,
        "startDate": "2026-01-01",
        "endDate": "2026-06-30",
        "sortOrder": "asc",
        "limit": 100,
    },
    headers=headers,
    timeout=30,
)
response.raise_for_status()

payload = response.json()
reports = payload["reports"]
pagination = payload["pagination"]

O relatório mensal reúne ativos, patrimônio, carteira, classe de cota e tipo de condomínio. Ordene pela data de referência, que é a competência do documento, e não pela data da chamada.

Pagine até cobrir o intervalo inteiro. Uma primeira página cheia parece uma série completa e quase nunca é.

Ler carteira e risco de FIDC

/api/v2/funds/fidc/portfolio organiza setores, vencimentos, inadimplência, faixas de risco, cotas, cotistas e cedentes, e aceita referenceDate para selecionar o mês.

curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/v2/funds/fidc/portfolio?cnpjs=SEU_CNPJ&referenceDate=2026-06-30"

Troque SEU_CNPJ por um valor válido. A chave principal da resposta é funds.

Concentração e inadimplência isoladas dizem pouco. Um percentual alto pode vir de carteira pequena, de um evento pontual ou de uma reclassificação. Compare meses consecutivos e confira qual denominador o documento usou.

Com cedentes vale o mesmo. Lista curta indica concentração e não diz nada sobre qualidade do crédito, que depende de prazo, garantia e subordinação.

Consultar relatórios de FIP

O endpoint /api/v2/funds/fip/reports aceita os mesmos identificadores e filtros de data, mais um reportType que seleciona trimestral ou quadrimestral.

response = requests.get(
    "https://brapi.dev/api/v2/funds/fip/reports",
    params={
        "cnpjs": cnpj,
        "reportType": "trimestral",
        "sortOrder": "desc",
        "limit": 20,
    },
    headers=headers,
    timeout=30,
)
response.raise_for_status()

fip_reports = response.json()["reports"]

Os relatórios trazem capital comprometido e integralizado, cotas, classes e composição de investidores, tudo em campos normalizados. Não espere cota diária aqui: o dado anda no ritmo do informe escolhido.

Misturar documentos trimestrais e quadrimestrais na mesma série sem marcar o tipo cria degraus falsos no gráfico. Os períodos são diferentes.

Preparar os dados para análise

Monte uma chave composta com CNPJ, classe, data de referência e tipo de relatório. Sem ela, registros legítimos parecem duplicados.

Conserve o JSON original junto. Campos regulatórios ganham seções novas, e uma transformação escrita há um ano descarta em silêncio o que ela não conhece.

null é dado ausente ou não aplicável. Zero afirma que a medida foi apurada e deu zero. Confundir os dois muda a média de uma carteira inteira.

Ao exibir valores monetários, leia a unidade no schema em vez de presumir reais inteiros. Percentuais e razões precisam de formatação própria.

Um fluxo curto e seguro

1. Descubra o fundo e confirme assetType.
2. Use CNPJ e classe como identificadores.
3. Escolha relatório ou carteira conforme a pergunta.
4. Alinhe todos os registros pela data de referência.
5. Preserve paginação, valores nulos e documento original.

Abra a referência de carteira de FIDC e valide seu primeiro CNPJ contra o schema publicado.