Developers
Abrir no Claude
Abrir no ChatGPTGere sua chave
Crie a chave em Minha conta → API. O segredo completo aparece somente uma vez.
FIDCs.com.br · API de dados
Como usar a API FIDCs.com.br
Guia para consultar fundos, ações, companhias, crédito privado, títulos públicos e macroeconomia por REST ou MCP.
Ctrl K
Sem chave conectada · não salvamos no navegador
Começando
Comece aqui
A API organiza dados públicos da CVM, B3, BCB e outras fontes em contratos com identidade, período e unidades explícitas. Você pode consumir a mesma base de duas formas:
- Vou programar com RESTEndpoints HTTP, respostas JSON e exemplos em cURL, Python e JavaScript.
- Vou consultar com um agente via MCPFerramentas preparadas para Claude, ChatGPT e outros clientes compatíveis.
Para agentes de IA
Usando Claude Code, Cursor ou ChatGPT? Passe este arquivo para o agente.
Toda a API em um Markdown: regras de uso, autenticação, créditos, erros e todos os endpoints com exemplos. Atualizado automaticamente a partir do contrato.
https://developers.fidcs.com.br/llms-full.txtPrimeiro resultado
Sua primeira chamada em 30 segundos
Resolva o CNPJ do exemplo sorteado para esta visita. A chamada custa 1 crédito e não acontece antes do clique.
Exemplo FIDC desta visitaRNX FIDC
12.813.212/0001-77Exemplo para o Raio-XSolis Capital Antares FIC
CNPJ 34.780.531/0001-661 crédito
Aceita CNPJ, código CVM ou ANBIMA e devolve fundos e classes compatíveis sem escolher silenciosamente quando houver ambiguidade.
ParâmetroTipoObrigatórioDescrição
cnpjstringNãoCNPJ com 14 dígitos; pontuação é aceita.cvm_codestringNãoCódigo CVM do fundo, classe ou subclasse.anbima_codestringNãoCódigo ANBIMA da classe ou subclasse.1curl --request GET \2 --url 'https://api.fidcs.com.br/v1/resolve?cnpj=12813212000177' \3 -H "Authorization: Bearer SUA_CHAVE"Testar chamada
Custo por chamada/página. O cache técnico não altera a cobrança.
Segurança
Autenticação
Uma chave identifica a conta, aplica limites e debita os créditos da operação.
Envie no header
Use o padrão Bearer. Nunca coloque a chave na URL, no frontend da sua aplicação ou em um repositório.
Authorization: Bearer SUA_CHAVEModelo de dados
Identificadores
O CNPJ localiza a entidade; os códigos públicos da CVM e ANBIMA identificam fundo, classe e subclasse.
Exemplo atual: RNX FIDC
12.813.212/0001-77Melhor ponto de entrada quando você já conhece o fundo.
Retornado pelo resolverRegistro público usado nas rotas cadastrais do fundo.
Retornado pelo resolverRegistro público usado nas rotas mensais e analíticas.
quando disponívelComplementa a identidade sem substituir fundo ou classe.
Indústria de FIDCs
Até 120 meses em uma chamada
PL, fundos/classes, fluxos, carteira, prazos, rentabilidade, concentração, ANBIMA e rankings históricos.
GET /v1/industria/resumo?months=120&include_fic_fidc=trueEscolha month, from/to ou months/to. FIC-FIDCs estão incluídos por padrão; o mesmo universo se aplica ao período inteiro. A resposta informa cobertura, lacunas, meses parciais, atualização e metodologia. PL agregado pode ter dupla contagem e não representa exposição consolidada.
Histórico usa custo fixo por operação, até 120 meses. Não há uma cobrança por mês. Consulte os campos, erros, paginação de rankings e exemplos MCP no guia de indústria.
API REST
Endpoints disponíveis
62 operações publicadas a partir do contrato OpenAPI.
#EndpointRotaCréditos
1Indicadores históricos da indústriaGET /v1/industria12Compare PeriodsGET /v1/industria/comparacao13Manager RankingGET /v1/industria/gestoras/ranking14Buscar ações B3GET /v1/acoes15Consultar perfil da açãoGET /v1/acoes/{ticker}16Consultar preços e evidências da açãoGET /v1/acoes/{ticker}/{recurso}17Buscar companhias CVMGET /v1/companhias18Listar demonstrativos DFP/ITRGET /v1/companhias/{cvm_code}/demonstrativos19Consultar linhas contábeis DFP/ITRGET /v1/companhias/{cvm_code}/demonstrativos/{statement_id}/linhas110Pesquisar documentos IPE da companhiaGET /v1/companhias/{cvm_code}/documentos111Obter documento original da companhiaGET /v1/companhias/{cvm_code}/documentos/arquivo512Consultar indicadores contábeis da companhiaGET /v1/companhias/{cvm_code}/indicadores113Consultar série anual contábilGET /v1/companhias/{cvm_code}/serie-anual114Consultar dicionário de contas contábeisGET /v1/companhias/contas-contabeis115Listar tabelas FREGET /v1/companhias/fre/{cnpj}116Consultar registros FREGET /v1/companhias/fre/{cnpj}/{table_id}/linhas117Buscar emissões CRI/CRAGET /v1/emissoes118Consultar emissão CRI/CRAGET /v1/emissoes/{tipo}/{cnpj}/{codigo}119Consultar informes, séries e participantesGET /v1/emissoes/{tipo}/{cnpj}/{codigo}/{recurso}120Consultar série diária do fundoGET /v1/series-diarias/{cnpj}121Consultar desempenho calculado do fundoGET /v1/series-diarias/{cnpj}/desempenho122Listar identidades da série diáriaGET /v1/series-diarias/{cnpj}/identidades123Consultar informes FII/FIPGET /v1/informes-estruturados/{cnpj}124Consultar curva e histórico do TesouroGET /v1/titulos-publicos125Consultar histórico BOVA11GET /v1/benchmarks/{benchmark}/serie-diaria126Consultar CDI diárioGET /v1/benchmarks/cdi/serie-diaria127Consultar séries macroeconômicas BCBGET /v1/macroeconomia/{serie_id}128Resolver um identificadorGET /v1/resolve129Consultar catálogo da APIGET /v1/schema130Consultar meses disponíveisGET /v1/classes/{class_id}/cobertura131Consultar disponibilidade periódicaGET /v1/classes/{class_id}/disponibilidade-periodica132Buscar fundos FIDCGET /v1/fundos133Consultar cadastro da classeGET /v1/classes/{class_id}134Listar participantes da classeGET /v1/classes/{class_id}/participantes135Listar subclasses ANBIMAGET /v1/classes/{class_id}/subclasses136Listar subclasses CVMGET /v1/classes/{class_id}/subclasses-cvm137Consultar cadastro do fundoGET /v1/fundos/{fund_id}138Listar classes do fundoGET /v1/fundos/{fund_id}/classes139Listar participantes do fundoGET /v1/fundos/{fund_id}/participantes140Filtrar o universo de fundosGET /v1/screening141Consultar indicadores históricosGET /v1/classes/{class_id}/indicadores242Consultar fotografia mensalGET /v1/classes/{class_id}/snapshot543Consultar carteira ativo a ativo (CDA)GET /v1/classes/{class_id}/carteira/ativos144Consultar concentração de cedentesGET /v1/classes/{class_id}/carteira/concentracao-cedentes245Consultar estrutura da carteiraGET /v1/classes/{class_id}/carteira/estrutura246Consultar inadimplênciaGET /v1/classes/{class_id}/carteira/inadimplencia247Consultar faixas de atrasoGET /v1/classes/{class_id}/carteira/inadimplencia/faixas248Consultar PDDGET /v1/classes/{class_id}/carteira/pdd249Consultar prazos da carteiraGET /v1/classes/{class_id}/carteira/prazos250Consultar carteira por segmentoGET /v1/classes/{class_id}/carteira/segmentos251Consultar substituições e recomprasGET /v1/classes/{class_id}/carteira/substituicoes-recompras252Consultar cotasGET /v1/classes/{class_id}/cotas253Consultar operações com cotasGET /v1/classes/{class_id}/cotas/operacoes254Consultar rentabilidadeGET /v1/classes/{class_id}/rentabilidade255Consultar demonstrativo mensalGET /v1/classes/{class_id}/demonstrativo1056Listar fundos investidoresGET /v1/classes/{class_id}/investidores357Listar FIDCs investidosGET /v1/classes/{class_id}/carteira/fundos558Consultar Raio-X FIC-FIDCGET /v1/classes/{class_id}/raio-x1059Pesquisar documentos da classeGET /v1/classes/{class_id}/documentos160Obter documento originalGET /v1/classes/{class_id}/documentos/arquivo561Verificar saúde do serviçoGET /healthGrátis62Consultar créditos e limitesGET /pricingGrátisAliases legados: 3 rotas adicionais preservadas
Use a rota canônica em novas integrações. Custos e limites seguem o recurso correspondente.
GET /v1/classes/{class_id}/caracteristicas-anbima → /v1/classes/{class_id} · 1 créditos
GET /v1/classes/{class_id}/medidas → /v1/classes/{class_id}/indicadores · 2 créditos
GET /v1/classes/{class_id}/investidores/historico → /v1/classes/{class_id}/investidores · 3 créditos
Indústria3 operações
Ações3 operações
Companhias10 operações
Crédito privado3 operações
Séries diárias3 operações
Informes estruturados1 operação
Títulos públicos1 operação
Macroeconomia e benchmarks3 operações
Descoberta3 operações
Cadastro9 operações
Visão geral2 operações
Carteira9 operações
Cotas e rentabilidade3 operações
Demonstrativo1 operação
Investidores1 operação
FIC-FIDCSolis Capital Antares FIC · CNPJ 34.780.531/0001-662 operações
Operação4 operações
Contratos públicos
Dicionários e unidades
Preserve identidade, período, frequência, release e unidade antes de interpretar os valores.
O OpenAPI define parâmetros, enums e schemas; /v1/schema publica recursos, grãos, unidades e créditos. Companhias têm o dicionário /v1/companhias/contas-contabeis. Ausência não é zero; um cadastro não comprova dados no período.
Ações usam ticker/ISIN e preços B3 não ajustados. CRI/CRA usa tipo, securitizadora e código. CDA exige classe/mês. Retornos de fundos são frações; Sharpe é índice. Tesouro usa taxa anual em fração; SGS preserva percentuais e frequência. BOVA11 é proxy de ETF.
Ver o dicionário completo de identidades e unidadesAcesso antecipado
MCP — use os dados com agentes de IA
O agente escolhe a ferramenta, mas o dado e a cobrança continuam vindo da mesma API.
https://mcp.fidcs.com/mcpO piloto no Claude usa OAuth e não exige copiar uma chave. API key permanece como fallback para clientes que aceitam headers.
FerramentaUso e créditos
buscar_fidcBusca por nome ou resolve CNPJ, código CVM ou código ANBIMA.1 crédito por chamada/página
listar_fundosLista fundos por gestora, administrador, situação, tipo, PL e inadimplência.1 crédito por chamada/página
consultar_fundoConsulta o cadastro, as classes ou os participantes de um fundo já identificado.1 crédito por chamada/página
consultar_coberturaInforma quais recursos e competências existem para uma classe.1 crédito por chamada/página
buscar_documentosPesquisa o catálogo de documentos públicos da classe e do fundo relacionado.1 crédito por chamada/página
ler_documentoLê um PDF encontrado por buscar_documentos (informe class_id) ou por consultar_companhia recurso=documentos (informe codigo_cvm, sem class_id).5 créditos por chamada/página
consultar_snapshotCaminho preferencial para uma visão geral mensal da classe, com cadastro, carteira, cotas, rentabilidade e definições das métricas.5 créditos por chamada/página
consultar_recursoConsulta cadastro, carteira, cotas, rentabilidade, investidores ou raio-x.1 a 10 créditos, conforme o recurso por chamada/página; continuação elegível por 15 min
obter_demonstrativoObtém o demonstrativo mensal.10 créditos por consulta; páginas incluídas por 15 min
consultar_serie_diariaCotas, PL, retornos, volatilidade e MDD da série diária por CNPJ.1 crédito por chamada/página; continuação elegível por 15 min
consultar_cdiSérie diária do CDI, Banco Central SGS 12.1 crédito por consulta; páginas incluídas por 15 min
consultar_informes_estruturadosLinhas dos informes CVM: FII mensal/trimestral/anual e FIP trimestral/quadrimestral.1 crédito por chamada/página
buscar_companhiasBusca companhias por nome ou CNPJ; sem filtro lista o universo documental.1 crédito por chamada/página
consultar_companhiaUse codigo_cvm retornado por buscar_companhias.1 crédito por chamada/página
consultar_freConsulta tabelas ou linhas FRE por CNPJ da companhia.1 crédito por chamada/página
buscar_contas_contabeisPesquisa códigos e descrições de contas DFP/ITR, com filtros de ano, tipo de demonstrativo e consolidação.1 crédito por chamada/página
buscar_acoesListagem por papel B3/CVM, filtros por companhia, setor, classe, categoria e indicador.1 crédito por chamada/página
consultar_acaoHistórico diário de cotação de ações B3 por ticker, por exemplo PETR4: use recurso=precos, from_date/to_date opcionais e siga next_cursor até has_more=false.1 crédito por chamada/página
buscar_emissoesBusca certificados por tipo, CNPJ da securitizadora, nome e competência.1 crédito por chamada/página
consultar_emissaoPerfil, informes completos, séries e participantes do certificado exato.1 crédito por chamada/página
consultar_carteira_ativosPosições públicas CDA do CNPJ da classe em uma competência explícita.1 crédito por consulta; páginas incluídas por 15 min
consultar_desempenhoRetornos por janela, volatilidade, drawdown e Sharpe 12 meses calculados pelo ETL.1 crédito por consulta; páginas incluídas por 15 min
consultar_titulos_publicosUma rota para curva por data ou histórico por ticker.1 crédito por chamada/página
consultar_macroeconomiaSGS 11 Selic efetiva, 432 meta Selic e 433 IPCA mensal, da base canônica.1 crédito por consulta; páginas incluídas por 15 min
consultar_benchmarkFechamentos B3 de BOVA11, o proxy usado na comparação de bolsa do Luna.1 crédito por consulta; páginas incluídas por 15 min
consultar_industriaPL, fluxos, composição, prazos, rentabilidade, concentração e ANBIMA.1 crédito por consulta; páginas incluídas por 15 min
ranking_gestoras_industriaGestoras por PL, captação ou saída líquida (resgates+amortizações-captação).1 crédito por consulta; páginas incluídas por 15 min
comparar_periodos_industriaUma consulta compara fluxos somados e PL final de dois períodos, sem somar PL nem preencher lacunas.1 crédito por consulta; páginas incluídas por 15 min
“Mostre a inadimplência do RNX FIDC em julho de 2026 e explique o que o indicador representa.”
Ações: use consultar_acao com recurso=precos para o histórico de PETR4. Títulos públicos e BOVA11 têm ferramentas próprias. Uma conversa antiga pode manter contexto anterior ao catálogo novo; confira as ferramentas e teste em uma conversa nova.
Política 2026-10-14-public-catalog
Créditos e limites
REST e MCP consomem o mesmo saldo. Cada endpoint informa seu custo antes da execução.
O acesso permite 300 chamadas por minuto por chave e até 120 meses de histórico. Os limites são iguais para todas as contas, independentemente do saldo ou das recargas.
Premium inclui 500 créditos por ciclo, renovados no aniversário mensal da assinatura, sem acúmulo. Recargas não expiram. Consulte X-Credits-Cost e X-Credits-Refunded para o débito efetivo. Na indústria, filtros inválidos e falhas da fonte estornam a reserva; respostas vazias válidas têm o custo publicado.
Ações, CRI/CRA e Tesouro custam 1 crédito por chamada/página. CDA, desempenho, macro e BOVA11 custam 1 crédito por consulta, com páginas incluídas por 15 minutos na mesma chave e filtros. PETR4 em 15 páginas custa 15 créditos. Reutilizar cache técnico não torna uma chamada gratuita; confira o débito efetivo nos headers.
Operação
Erros, retries e cache
400Parâmetros inválidos — corrija antes de repetir.
401Chave ausente, inválida ou revogada.
404Entidade, competência ou recurso não encontrado.
429Saldo insuficiente ou limite de chamadas atingido.
5xxFalha da plataforma — tente novamente com backoff.
Registre o header X-Request-Id para suporte. Respeite Retry-After e não repita automaticamente erros 4xx.