Indústria de FIDCs e histórico

Consulte um mês ou a série completa numa única operação REST/MCP. Os agregados usam os marts que alimentam /industria, publicados previamente. Nenhuma requisição calcula o mercado consultando fundo a fundo.

Endpoints e ferramentas

O parâmetro indicador aceita resumo (padrão: PL, PL médio, quantidade), fluxos (captação, resgates, amortizações e fluxo líquido), segmentos, ativos, prazos, rentabilidade, concentracao, anbima, anbima/segmentos, distribuicao-pl, participantes e concentracao-top. Cada chamada seleciona um indicador e retorna toda sua série disponível na janela. Para obter todos os recortes, consulte cada indicador; o endpoint permanece o mesmo, com 1 crédito por consulta.

participantes contém gestores, administradores e custodiantes, quantidades, PL e ranks. concentracao-top contém os 12 primeiros fundos/classes com risco por mês, conforme o quadro da página, com o rank recalculado no universo selecionado. PDD e inadimplência por ANBIMA já estão nos campos de anbima.

Ferramentas MCP: consultar_industria, ranking_gestoras_industria, comparar_periodos_industria. Elas chamam exclusivamente as operações públicas do gateway; não há taxa MCP adicional.

Autenticação: Authorization: Bearer SUA_CHAVE, com o escopo funds:read; OAuth MCP herda o mesmo escopo e limites.

Período e universo

• month=YYYY-MM: competência exata, sem substituição pelo mês mais recente.
• from=YYYY-MM&to=YYYY-MM: intervalo inclusivo, máximo 120 meses.
• months=1|12|36|120&to=YYYY-MM: quantidade de competências encerrada em to; sem to, o último mês do agregado de PL no universo selecionado é a âncora. Padrão: 12 meses.
• Não combine month com intervalo, nem from com months.
• include_fic_fidc=true é o padrão. FIC-FIDCs também são FIDCs. false exclui-os com a mesma regra mensal durante todo o intervalo.
• include_partial=true é o padrão. false remove meses identificados como parciais e potencialmente parciais por recência, registrando-os separadamente.
• Ranking: metric=pl|captacao|saida_liquida, limit=1..100, offset=0..10000. Limite e offset se aplicam a cada mês. Siga data.pagination.next_offset até has_more=false para obter todas as gestoras. Empates compartilham rank; documento e nome estabilizam a ordem.
• Comparação: from_a/to_a/from_b/to_b; a janela que contém os dois períodos também deve caber em 120 meses e no histórico do plano.

curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://api.fidcs.com.br/v1/industria?indicador=resumo&months=120&include_fic_fidc=true"

curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://api.fidcs.com.br/v1/industria/gestoras/ranking?month=2025-08&metric=captacao&limit=20"

curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://api.fidcs.com.br/v1/industria/comparacao?from_a=2024-09&to_a=2025-08&from_b=2025-09&to_b=2026-08&include_fic_fidc=false"

Resposta, cobertura e atualização

data.items contém observações com month e os campos originais dos marts; meta.sources, meta.units e meta.methodology descrevem origem e cálculo. Valores monetários em BRL; share_* são frações; rentabilidade, *_perc_pl e top*_pr usam pontos percentuais.

data.coverage contém requested e covered (início, fim e quantidade), available_months, missing_months, partial_months, excluded_partial_months, unknown_completeness_months e by_month. Ausência de linha resulta em lista vazia ou lacuna, sem inserir observações com zero. updated_at é a publicação da projeção agregada, não a data de envio de cada informe CVM. A presença de meses consecutivos não certifica completude dos informes.

Existem observações desde janeiro de 2013; a cobertura efetiva varia por indicador, universo e competência. A API retorna toda a janela solicitada disponível até o limite do contrato, informando as lacunas. Meses posteriores ao mês UTC menos dois são potencialmente parciais; essa regra de recência não comprova completude dos meses antigos.

Metodologia e limites de interpretação

data.quality_warnings e coverage.quality_warning_months sinalizam fluxos acima de dez vezes o PL do recorte. É um diagnóstico heurístico, sem apagar ou corrigir valores da fonte. Ausência de aviso não certifica qualidade. A amortização de setembro de 2021 tem magnitude anômala nos marts; confira o informe original antes de interpretar. Comparações devolvem fluxos null em períodos com aviso; PL final permanece o valor do mês exato.

PL agregado não é exposição econômica consolidada. Somar PL de fundos investidores e investidos pode contar capital duas vezes. Excluir FIC-FIDCs reduz uma fonte de duplicidade, mas não certifica consolidação. Não subtraímos posições em cotas do PL e não aplicamos look-through nesses agregados.

O filtro mantém a classificação mensal por denominação do mart de PL de /industria: padrões COTAS DE F, FIC-FIDC, FIC FIDC ou EM COTAS. Não equivale à classificação de carteiras CDA. Sem FIC, somente entidades/mês classificadas como não FIC entram. A regra pode não reconhecer nomes sem esses padrões.

Numeradores, denominadores, estatísticas e ranks usam o mesmo universo. Captação líquida = captação − resgates pagos − amortizações. Saída líquida = −fluxo líquido; resgate pendente aparece separado. Zeros já normalizados pelos marts são preservados, sem transformar meses inteiros ausentes em zero.

Rentabilidade usa séries sênior, mezanino e subordinada com retorno não nulo, não zero e módulo até 50 pontos percentuais; estatísticas não ponderadas por PL, conforme o mart. Não são retorno investível da indústria. Concentração usa uma observação por classe/mês/tipo, posição 1, e médias de fundos/classes.

ANBIMA e vínculos de gestoras usam o cadastro disponível atualmente aplicado ao histórico; não certificam a classificação ou gestora vigentes no mês histórico.

Comparações somam fluxos somente quando existem todos os meses e campos do período e não há meses parciais conhecidos. Lacunas devolvem null. PL compara o último mês exato de cada intervalo, nunca a soma mensal. Delta = B − A; variação relativa = delta / abs(A), null quando A é zero. A completude dos informes continua explicitamente desconhecida.

Créditos, autenticação e erros

Todas as operações exigem Bearer e escopo funds:read, com limites de saldo, requisições/minuto e histórico do plano. O custo fixo vem da política pública, também no OpenAPI e em Minha conta. 120 meses são uma operação, não 120 cobranças. Mesma chave, operação e filtros permitem reutilização por 15 minutos; offset/limit do ranking não geram novo débito nesse período. Rate limit continua contando cada chamada.

Não repita 4xx sem corrigir. Registre X-Request-Id. Filtros desconhecidos e repetidos são recusados.

Exemplos MCP

• “Como evoluiu o PL da indústria nos últimos 120 meses?” → consultar_industria(recurso="resumo", meses=120).
• “Compare a captação e os resgates dos últimos dois anos.” → dois intervalos de 12 meses em comparar_periodos_industria.
• “Quais gestoras mais captaram em determinado mês?” → ranking_gestoras_industria com metrica="captacao" e mes="2025-08".
• “Como mudou a composição da carteira da indústria?” → consultar_industria(recurso="ativos", meses=24).

Informe o universo e preserve ressalvas, lacunas, períodos e fontes na resposta da IA.