# FIDCs.com.br API — documentação para agentes de IA > API REST de dados públicos de FIDCs, fundos, ações B3, companhias CVM, CRI/CRA, títulos públicos e macroeconomia. Preserve identidade, competência, unidade, versão e fonte de cada recurso. Somente leitura, respostas JSON. Este arquivo é gerado automaticamente do contrato OpenAPI. Contrato público: https://developers.fidcs.com.br/openapi.json · Documentação: https://developers.fidcs.com.br ## Começo rápido - **URL base:** `https://api.fidcs.com.br` - **Autenticação:** header `Authorization: Bearer `. O usuário cria a chave em https://fidcs.com.br/minha-conta/api. Nunca coloque a chave na URL, no frontend ou em repositório; leia de uma variável de ambiente (ex.: `FIDCS_API_KEY`). - **Fluxo recomendado:** 1. Resolva o fundo pelo CNPJ: `GET /v1/resolve?cnpj=12813212000177` → devolve `fund_id` e `class_ids`. 2. Para listas e filtros (gestora, PL, inadimplência), use `GET /v1/screening` ou `GET /v1/fundos`. 3. Veja os meses disponíveis da classe: `GET /v1/classes/{class_id}/cobertura`. 4. Consulte o recurso desejado com `class_id`. Séries aceitam o intervalo `from`/`to` e consultas mensais aceitam `month`, sempre no formato `AAAA-MM`. - **Agentes conversacionais** (Claude, ChatGPT) também podem usar o servidor MCP `https://api.fidcs.com.br/mcp`, com login OAuth e o mesmo saldo. ## Ferramentas MCP e créditos REST e MCP usam o mesmo saldo, sem taxa adicional pelo conector. Custos por recurso estão no OpenAPI e em /pricing. | Ferramenta | Uso | Créditos | | --- | --- | --- | | `buscar_fidc` | Busca por nome ou resolve CNPJ, código CVM ou código ANBIMA. | 1 crédito por chamada/página | | `listar_fundos` | Lista fundos por gestora, administrador, situação, tipo, PL e inadimplência. | 1 crédito por chamada/página | | `consultar_fundo` | Consulta o cadastro, as classes ou os participantes de um fundo já identificado. | 1 crédito por chamada/página | | `consultar_cobertura` | Informa quais recursos e competências existem para uma classe. | 1 crédito por chamada/página | | `buscar_documentos` | Pesquisa o catálogo de documentos públicos da classe e do fundo relacionado. | 1 crédito por chamada/página | | `ler_documento` | Lê 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_snapshot` | Caminho 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_recurso` | Consulta 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_demonstrativo` | Obtém o demonstrativo mensal. | 10 créditos por consulta; páginas incluídas por 15 min | | `consultar_serie_diaria` | Cotas, 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_cdi` | Série diária do CDI, Banco Central SGS 12. | 1 crédito por consulta; páginas incluídas por 15 min | | `consultar_informes_estruturados` | Linhas dos informes CVM: FII mensal/trimestral/anual e FIP trimestral/quadrimestral. | 1 crédito por chamada/página | | `buscar_companhias` | Busca companhias por nome ou CNPJ; sem filtro lista o universo documental. | 1 crédito por chamada/página | | `consultar_companhia` | Use codigo_cvm retornado por buscar_companhias. | 1 crédito por chamada/página | | `consultar_fre` | Consulta tabelas ou linhas FRE por CNPJ da companhia. | 1 crédito por chamada/página | | `buscar_contas_contabeis` | Pesquisa 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_acoes` | Listagem por papel B3/CVM, filtros por companhia, setor, classe, categoria e indicador. | 1 crédito por chamada/página | | `consultar_acao` | Histó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_emissoes` | Busca certificados por tipo, CNPJ da securitizadora, nome e competência. | 1 crédito por chamada/página | | `consultar_emissao` | Perfil, informes completos, séries e participantes do certificado exato. | 1 crédito por chamada/página | | `consultar_carteira_ativos` | Posiçõ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_desempenho` | Retornos 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_publicos` | Uma rota para curva por data ou histórico por ticker. | 1 crédito por chamada/página | | `consultar_macroeconomia` | SGS 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_benchmark` | Fechamentos 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_industria` | PL, fluxos, composição, prazos, rentabilidade, concentração e ANBIMA. | 1 crédito por consulta; páginas incluídas por 15 min | | `ranking_gestoras_industria` | Gestoras 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_industria` | Uma 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 | Para cotações de ações, use consultar_acao com recurso=precos, por exemplo PETR4. Títulos públicos usa consultar_titulos_publicos. BOVA11 é proxy de ETF, não o Ibovespa oficial. Novas ferramentas podem aparecer automaticamente no conector. Uma conversa já aberta pode manter contexto anterior; se negar uma ferramenta publicada, confira o catálogo e teste em uma conversa nova. ## Regras para usar os dados corretamente - **Ações.** buscar_acoes localiza o papel; consultar_acao com recurso=precos retorna o histórico diário B3 por ticker/ISIN, inclusive PETR4. São preços não ajustados; unit_close_price é BRL por ação e OHLC divide por quote_factor. Cada página custa 1 crédito; total pode ser null até o final. Fundamentos vêm do ETL; proventos separam direitos, pagamentos e ações corporativas. Não some capitalização repetida entre classes. DFP/ITR/IPE/FRE usam código CVM/CNPJ da companhia. - **Crédito privado.** Identifique CRI/CRA por tipo + CNPJ da securitizadora + código. Informes preservam carteira, balanço, prazos e fluxos em dados; fonte, versão e unidades acompanham os valores. Taxas e ratings reportados não são marcação de mercado ou rating atual. DFIN/termos não têm vínculo canônico geral por certificado. - **CDA e desempenho.** CDA exige classe e mês explícitos, todas as páginas e consultas separadas de fundos investidos no mesmo mês. Posições confidenciais podem faltar. Desempenho exige source_series_id quando ambíguo e preserva frequency, window_context e motivos de indisponibilidade. Retornos/risco são frações; Sharpe é índice. - **Tesouro e macro.** Títulos públicos: curva por date ou histórico por ticker; taxas anuais em fração e PU em BRL. SGS 11 é Selic efetiva em % ao dia; 432 meta Selic em % ao ano; 433 IPCA em % de variação mensal. Preserve frequência e unidade. BOVA11 é proxy de ETF em BRL por cota, não Ibovespa oficial nem retorno total ajustado. - **Indústria.** Use as rotas /v1/industria ou as ferramentas consultar_industria, ranking_gestoras_industria e comparar_periodos_industria. Uma série inteira de até 120 meses usa uma operação, com month, from/to ou months/to. FIC-FIDCs estão incluídos por padrão; include_fic_fidc=false exclui-os em todo o período. Informe o universo. PL agregado pode conter dupla contagem de investidores e investidos e não é exposição consolidada. data.coverage informa lacunas, parciais e completude desconhecida; updated_at é publicação do agregado. Rankings paginam por mês em data.pagination.next_offset. Não faça uma chamada por mês. ANBIMA usa cadastro atual aplicado ao histórico. Comparações somam fluxos, usam PL final e devolvem null quando há meses/campos ausentes. - **Identidade.** Um fundo pode ter várias classes. Use `fund_id` nas rotas de fundo (cadastro, classes, participantes) e `class_id` nas rotas mensais e analíticas da classe. Ambos são UUIDs persistentes retornados por `/v1/resolve` ou `/v1/fundos`. Nunca invente nem reaproveite IDs numéricos antigos: resolva de novo pelo CNPJ. - **Competência.** Meses são `AAAA-MM` (ex.: `2026-07`). Antes de pedir uma série, consulte a cobertura da classe para saber quais meses existem. Não misture competências diferentes numa mesma comparação. - **Envelope.** Toda resposta tem `data` (o conteúdo) e `meta` (`request_id`, `as_of`, `row_count`, `sources` e, quando houver, `pagination`, `billing` e `analysis`). Preserve as fontes de `meta.sources` ao citar números. - **Paginação.** Em coleções, siga `meta.pagination.next_cursor` (ou `next_offset`) repetindo exatamente os mesmos filtros até `has_more=false`. Uma página não é a lista completa. Reaproveite as páginas já recebidas para contar ou exportar; não reinicie a busca. - **Unidades.** Campos `*_ratio` são frações: multiplique por 100 antes de mostrar como percentual. Campos `*_brl` estão em reais. - **Ausência não é zero.** `null`, `unavailable` ou seção não reportada significam dado ausente, não valor zero. Não preencha lacunas com estimativas. - **Inadimplência.** A razão usa `inadimplente_brl / direitos_creditorios_brl`. `carteira_total_brl` não é sinônimo de direitos creditórios. Quando presentes, `receivables` e `receivables_definitions` distinguem bruto, líquido e PDD. Composição por faixa de atraso (>30, >90) não é roll rate. - **Reconciliação.** `mismatch` sinaliza diferença entre fontes, não fraude nem reclassificação. - **Snapshot.** Leia `metric_definitions` para saber o que cada métrica significa antes de interpretá-la. - **Cálculos.** Prefira `meta.analysis` para variações e agregados já calculados sobre o período completo. - **FIC-FIDC.** Não misture fundos diretos com FIC-FIDCs; use o Raio-X para olhar através das cotas investidas. - **Documentos.** Liste os documentos da classe antes de baixar o arquivo original. - **Nunca invente** valores, documentos ou fontes que não vieram na resposta. ## Créditos e limites (política 2026-10-14-public-catalog) Cada operação tem um custo fixo em créditos, indicado em cada endpoint abaixo. REST e MCP usam o mesmo saldo. - A assinatura Premium inclui **500 créditos por mês**, renovados no aniversário da assinatura, sem acumular. - Recargas avulsas somam à franquia, são usadas depois dela e não expiram: | Pacote | Preço | | --- | --- | | 1.000 créditos | R$ 50 | | 5.000 créditos | R$ 200 | | 15.000 créditos | R$ 500 | - Erros da plataforma (5xx) e parâmetros inválidos (400/422) são estornados. Outros erros após reserva, como 404, continuam cobrados. - Nos endpoints com navegação incluída, repetir ou paginar a mesma consulta com a mesma chave e filtros por até 15 minutos não cobra de novo. Consulte a lista de operações em https://api.fidcs.com.br/pricing. - Há limite de chamadas por minuto. Ao receber 429, respeite `Retry-After` antes de tentar de novo. ## Erros, retries e cache | Status | Significado | O que fazer | | --- | --- | --- | | 400 | Parâmetros inválidos | Corrija antes de repetir | | 401 | Chave ausente, inválida ou revogada | Verifique o header `Authorization` | | 404 | Entidade, competência ou recurso não encontrado | Confira IDs e a cobertura | | 429 | Saldo insuficiente ou limite de chamadas atingido | Respeite `Retry-After`; não repita em loop | | 5xx | Falha da plataforma | Tente de novo com backoff exponencial | Registre o header `X-Request-Id` para suporte. Não repita automaticamente erros 4xx. ## Aliases legados - GET /v1/classes/{class_id}/caracteristicas-anbima → /v1/classes/{class_id}: 1 créditos, conforme o recurso canônico. - GET /v1/classes/{class_id}/medidas → /v1/classes/{class_id}/indicadores: 2 créditos, conforme o recurso canônico. - GET /v1/classes/{class_id}/investidores/historico → /v1/classes/{class_id}/investidores: 3 créditos, conforme o recurso canônico. ## Índice de endpoints - **Indústria:** Indicadores históricos da indústria (`GET /v1/industria`); Compare Periods (`GET /v1/industria/comparacao`); Manager Ranking (`GET /v1/industria/gestoras/ranking`) - **Ações:** Buscar ações B3 (`GET /v1/acoes`); Consultar perfil da ação (`GET /v1/acoes/{ticker}`); Consultar preços e evidências da ação (`GET /v1/acoes/{ticker}/{recurso}`) - **Companhias:** Buscar companhias CVM (`GET /v1/companhias`); Listar demonstrativos DFP/ITR (`GET /v1/companhias/{cvm_code}/demonstrativos`); Consultar linhas contábeis DFP/ITR (`GET /v1/companhias/{cvm_code}/demonstrativos/{statement_id}/linhas`); Pesquisar documentos IPE da companhia (`GET /v1/companhias/{cvm_code}/documentos`); Obter documento original da companhia (`GET /v1/companhias/{cvm_code}/documentos/arquivo`); Consultar indicadores contábeis da companhia (`GET /v1/companhias/{cvm_code}/indicadores`); Consultar série anual contábil (`GET /v1/companhias/{cvm_code}/serie-anual`); Consultar dicionário de contas contábeis (`GET /v1/companhias/contas-contabeis`); Listar tabelas FRE (`GET /v1/companhias/fre/{cnpj}`); Consultar registros FRE (`GET /v1/companhias/fre/{cnpj}/{table_id}/linhas`) - **Crédito privado:** Buscar emissões CRI/CRA (`GET /v1/emissoes`); Consultar emissão CRI/CRA (`GET /v1/emissoes/{tipo}/{cnpj}/{codigo}`); Consultar informes, séries e participantes (`GET /v1/emissoes/{tipo}/{cnpj}/{codigo}/{recurso}`) - **Séries diárias:** Consultar série diária do fundo (`GET /v1/series-diarias/{cnpj}`); Consultar desempenho calculado do fundo (`GET /v1/series-diarias/{cnpj}/desempenho`); Listar identidades da série diária (`GET /v1/series-diarias/{cnpj}/identidades`) - **Informes estruturados:** Consultar informes FII/FIP (`GET /v1/informes-estruturados/{cnpj}`) - **Títulos públicos:** Consultar curva e histórico do Tesouro (`GET /v1/titulos-publicos`) - **Macroeconomia e benchmarks:** Consultar histórico BOVA11 (`GET /v1/benchmarks/{benchmark}/serie-diaria`); Consultar CDI diário (`GET /v1/benchmarks/cdi/serie-diaria`); Consultar séries macroeconômicas BCB (`GET /v1/macroeconomia/{serie_id}`) - **Descoberta:** Resolver um identificador (`GET /v1/resolve`); Consultar catálogo da API (`GET /v1/schema`); Consultar meses disponíveis (`GET /v1/classes/{class_id}/cobertura`); Consultar disponibilidade periódica (`GET /v1/classes/{class_id}/disponibilidade-periodica`) - **Cadastro:** Buscar fundos FIDC (`GET /v1/fundos`); Consultar cadastro da classe (`GET /v1/classes/{class_id}`); Listar participantes da classe (`GET /v1/classes/{class_id}/participantes`); Listar subclasses ANBIMA (`GET /v1/classes/{class_id}/subclasses`); Listar subclasses CVM (`GET /v1/classes/{class_id}/subclasses-cvm`); Consultar cadastro do fundo (`GET /v1/fundos/{fund_id}`); Listar classes do fundo (`GET /v1/fundos/{fund_id}/classes`); Listar participantes do fundo (`GET /v1/fundos/{fund_id}/participantes`); Filtrar o universo de fundos (`GET /v1/screening`) - **Visão geral:** Consultar indicadores históricos (`GET /v1/classes/{class_id}/indicadores`); Consultar fotografia mensal (`GET /v1/classes/{class_id}/snapshot`) - **Carteira:** Consultar carteira ativo a ativo (CDA) (`GET /v1/classes/{class_id}/carteira/ativos`); Consultar concentração de cedentes (`GET /v1/classes/{class_id}/carteira/concentracao-cedentes`); Consultar estrutura da carteira (`GET /v1/classes/{class_id}/carteira/estrutura`); Consultar inadimplência (`GET /v1/classes/{class_id}/carteira/inadimplencia`); Consultar faixas de atraso (`GET /v1/classes/{class_id}/carteira/inadimplencia/faixas`); Consultar PDD (`GET /v1/classes/{class_id}/carteira/pdd`); Consultar prazos da carteira (`GET /v1/classes/{class_id}/carteira/prazos`); Consultar carteira por segmento (`GET /v1/classes/{class_id}/carteira/segmentos`); Consultar substituições e recompras (`GET /v1/classes/{class_id}/carteira/substituicoes-recompras`) - **Cotas e rentabilidade:** Consultar cotas (`GET /v1/classes/{class_id}/cotas`); Consultar operações com cotas (`GET /v1/classes/{class_id}/cotas/operacoes`); Consultar rentabilidade (`GET /v1/classes/{class_id}/rentabilidade`) - **Demonstrativo:** Consultar demonstrativo mensal (`GET /v1/classes/{class_id}/demonstrativo`) - **Investidores:** Listar fundos investidores (`GET /v1/classes/{class_id}/investidores`) - **FIC-FIDC:** Listar FIDCs investidos (`GET /v1/classes/{class_id}/carteira/fundos`); Consultar Raio-X FIC-FIDC (`GET /v1/classes/{class_id}/raio-x`) - **Operação:** Pesquisar documentos da classe (`GET /v1/classes/{class_id}/documentos`); Obter documento original (`GET /v1/classes/{class_id}/documentos/arquivo`); Verificar saúde do serviço (`GET /health`); Consultar créditos e limites (`GET /pricing`) ## Indústria ### Indicadores históricos da indústria `GET /v1/industria` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Um indicador por consulta, com a série inteira até 120 meses. Selecione indicador; month, from/to ou months/to definem o período. FIC-FIDCs incluídos por padrão. Custo fixo em /pricing. Cobertura e metodologia acompanham a resposta; PL pode ter dupla contagem. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `indicador` | query | não | string | — | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | | `months` | query | não | integer | — | | `include_fic_fidc` | query | não | boolean | — | | `include_partial` | query | não | boolean | — | ```bash curl "https://api.fidcs.com.br/v1/industria" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "items": [ {} ], "coverage": { "requested": { "from": "string", "to": "string", "months": 1 }, "covered": { "from": "string", "to": "string", "months": 1 }, "available_months": [ "2026-07" ], "missing_months": [ "2026-07" ], "partial_months": [ "2026-07" ], "excluded_partial_months": [ "2026-07" ], "unknown_completeness_months": [ "2026-07" ], "quality_warning_months": [ "2026-07" ], "by_month": [ {} ] }, "updated_at": "2026-07-31", "universe": { "include_fic_fidc": true, "name": "com_fic_fidc" }, "pagination": {}, "quality_warnings": [ {} ] }, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Compare Periods `GET /v1/industria/comparacao` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Compara fluxos somados e PL final de dois intervalos dentro de uma janela de 120 meses. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `from_a` | query | sim | string | — | | `to_a` | query | sim | string | — | | `from_b` | query | sim | string | — | | `to_b` | query | sim | string | — | | `include_fic_fidc` | query | não | boolean | — | | `include_partial` | query | não | boolean | — | ```bash curl "https://api.fidcs.com.br/v1/industria/comparacao?from_a=2024-09&to_a=2025-08&from_b=2025-09&to_b=2026-08" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "items": [ {} ], "coverage": { "requested": { "from": "string", "to": "string", "months": 1 }, "covered": { "from": "string", "to": "string", "months": 1 }, "available_months": [ "2026-07" ], "missing_months": [ "2026-07" ], "partial_months": [ "2026-07" ], "excluded_partial_months": [ "2026-07" ], "unknown_completeness_months": [ "2026-07" ], "quality_warning_months": [ "2026-07" ], "by_month": [ {} ] }, "updated_at": "2026-07-31", "universe": { "include_fic_fidc": true, "name": "com_fic_fidc" }, "pagination": {}, "quality_warnings": [ {} ] }, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Manager Ranking `GET /v1/industria/gestoras/ranking` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Ranking histórico por mês; navegação por offset preserva universo e período. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `metric` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `offset` | query | não | integer | — | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | | `months` | query | não | integer | — | | `include_fic_fidc` | query | não | boolean | — | | `include_partial` | query | não | boolean | — | ```bash curl "https://api.fidcs.com.br/v1/industria/gestoras/ranking" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "items": [ {} ], "coverage": { "requested": { "from": "string", "to": "string", "months": 1 }, "covered": { "from": "string", "to": "string", "months": 1 }, "available_months": [ "2026-07" ], "missing_months": [ "2026-07" ], "partial_months": [ "2026-07" ], "excluded_partial_months": [ "2026-07" ], "unknown_completeness_months": [ "2026-07" ], "quality_warning_months": [ "2026-07" ], "by_month": [ {} ] }, "updated_at": "2026-07-31", "universe": { "include_fic_fidc": true, "name": "com_fic_fidc" }, "pagination": {}, "quality_warnings": [ {} ] }, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Ações ### Buscar ações B3 `GET /v1/acoes` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Papeis B3/CVM com filtros por setor, classe e indicador. Comparação na mesma release; não somar capitalização repetida entre classes. Não são cotações em tempo real. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `q` | query | não | string | Busca parcial por nome do fundo, CNPJ, gestor ou administrador. | | `cnpj` | query | não | string | CNPJ com 14 dígitos; pontuação é aceita. | | `sector` | query | não | string | — | | `share_class` | query | não | string | — | | `category` | query | não | string | — | | `archived` | query | não | boolean | — | | `metric` | query | não | string | — | | `minimum` | query | não | number | — | | `maximum` | query | não | number | — | | `sort` | query | não | string | — | | `direction` | query | não | string | — | | `release_id` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/acoes" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar perfil da ação `GET /v1/acoes/{ticker}` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Perfil por ticker e ISIN exatos, cotação e indicadores da release publicada. Ausências permanecem null; preços não ajustados. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `ticker` | path | sim | string | — | | `isin` | query | não | string | — | | `release_id` | query | não | string | — | ```bash curl "https://api.fidcs.com.br/v1/acoes/PETR4" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar preços e evidências da ação `GET /v1/acoes/{ticker}/{recurso}` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Recursos precos, fundamentos, proventos e acionistas. Preços diários B3 por ticker/ISIN; OHLC divide por quote_factor e unit_close_price é BRL por ação. Cada página custa 1 crédito; total é null até a última página. Fundamentos são calculados pelo ETL. Proventos separam direitos, pagamentos e ações corporativas. Acionistas usa snapshot FRE e percentuais em %, não frações. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `ticker` | path | sim | string | — | | `recurso` | path | sim | string | — | | `isin` | query | não | string | — | | `from_date` | query | não | string | — | | `to_date` | query | não | string | — | | `release_id` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/acoes/PETR4/precos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Companhias ### Buscar companhias CVM `GET /v1/companhias` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Universo de companhias e identificadores públicos. Use código CVM da companhia, não código de fundo, nas consultas contábeis e documentais. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cnpj` | query | não | string | CNPJ com 14 dígitos; pontuação é aceita. | | `q` | query | não | string | Busca parcial por nome do fundo, CNPJ, gestor ou administrador. | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/companhias" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Listar demonstrativos DFP/ITR `GET /v1/companhias/{cvm_code}/demonstrativos` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Períodos e versões DFP/ITR por companhia. Use statement_id para abrir linhas da demonstração exata; não misture consolidado/individual ou revisões. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cvm_code` | path | sim | string | Código CVM do fundo, classe ou subclasse. | | `dataset` | query | não | string | — | | `consolidation` | query | não | string | — | | `statement_type` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/companhias/9512/demonstrativos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar linhas contábeis DFP/ITR `GET /v1/companhias/{cvm_code}/demonstrativos/{statement_id}/linhas` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Linhas do demonstrativo escolhido com escala monetária, rubrica, período e fonte. Preserve moeda/escala e separação de consolidado/individual. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cvm_code` | path | sim | string | Código CVM do fundo, classe ou subclasse. | | `statement_id` | path | sim | string | — | ```bash curl "https://api.fidcs.com.br/v1/companhias/9512/demonstrativos//linhas" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Pesquisar documentos IPE da companhia `GET /v1/companhias/{cvm_code}/documentos` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Catálogo de documentos oficiais por companhia e filtros temporais. Buscar o catálogo não significa ler o PDF. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cvm_code` | path | sim | string | Código CVM do fundo, classe ou subclasse. | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/companhias/9512/documentos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Obter documento original da companhia `GET /v1/companhias/{cvm_code}/documentos/arquivo` · 5 créditos Cobrança por chamada/página, sem navegação incluída. Arquivo oficial da companhia pela identidade documental exata. REST e leitura MCP compartilham o custo; não há taxa adicional por transporte. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cvm_code` | path | sim | string | Código CVM do fundo, classe ou subclasse. | | `document_id` | query | sim | string | — | ```bash curl "https://api.fidcs.com.br/v1/companhias/9512/documentos/arquivo?document_id=%3Cdocument_id%3E" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json "string" ``` ### Consultar indicadores contábeis da companhia `GET /v1/companhias/{cvm_code}/indicadores` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Contas selecionadas da demonstração por período, dataset e consolidação. Valores são da fonte e da revisão escolhida; não recalcule múltiplos de ações nesta rota. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cvm_code` | path | sim | string | Código CVM do fundo, classe ou subclasse. | | `dataset` | query | não | string | — | | `consolidation` | query | não | string | — | | `year` | query | não | integer | — | | `statement_type` | query | não | string | — | | `data_release_id` | query | não | string | — | | `include_derived` | query | não | boolean | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/companhias/9512/indicadores" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar série anual contábil `GET /v1/companhias/{cvm_code}/serie-anual` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Exercícios completos de uma rubrica DRE com origem e revisão. Não some acumulados ITR para formar exercícios anuais. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cvm_code` | path | sim | string | Código CVM do fundo, classe ou subclasse. | | `indicator` | query | sim | string | — | | `consolidation` | query | não | string | — | ```bash curl "https://api.fidcs.com.br/v1/companhias/9512/serie-anual?indicator=%3Cindicator%3E" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar dicionário de contas contábeis `GET /v1/companhias/contas-contabeis` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Catálogo de rubricas CVM por dataset, demonstrativo e consolidação. Use os códigos da fonte para selecionar indicadores e séries; não invente equivalência de contas. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `q` | query | não | string | Busca parcial por nome do fundo, CNPJ, gestor ou administrador. | | `dataset` | query | não | string | — | | `year` | query | não | integer | — | | `statement_type` | query | não | string | — | | `consolidation` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/companhias/contas-contabeis" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Listar tabelas FRE `GET /v1/companhias/fre/{cnpj}` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Tabelas disponíveis na revisão do formulário de referência da companhia. Preserve período, revisão e fonte. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cnpj` | path | sim | string | CNPJ com 14 dígitos; pontuação é aceita. | | `section` | query | não | string | — | | `year` | query | não | integer | — | | `data_release_id` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/companhias/fre/33000167000101" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar registros FRE `GET /v1/companhias/fre/{cnpj}/{table_id}/linhas` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Linhas da tabela FRE escolhida, com campos e unidades reportados. Não confunda percentuais da fonte com frações; preserve versões. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cnpj` | path | sim | string | CNPJ com 14 dígitos; pontuação é aceita. | | `table_id` | path | sim | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/companhias/fre/33000167000101//linhas" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Crédito privado ### Buscar emissões CRI/CRA `GET /v1/emissoes` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Certificados por tipo, CNPJ da securitizadora, nome e competência. A identidade é tipo + CNPJ + código; cobertura pode ser parcial. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `tipo` | query | não | string | — | | `cnpj` | query | não | string | CNPJ com 14 dígitos; pontuação é aceita. | | `q` | query | não | string | Busca parcial por nome do fundo, CNPJ, gestor ou administrador. | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/emissoes" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar emissão CRI/CRA `GET /v1/emissoes/{tipo}/{cnpj}/{codigo}` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Perfil do certificado exato na competência. Taxas e ratings são reportados pela fonte, não marcação de mercado nem rating atual. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `tipo` | path | sim | string | — | | `cnpj` | path | sim | string | CNPJ com 14 dígitos; pontuação é aceita. | | `codigo` | path | sim | string | — | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/emissoes/CRI/12813212000177/" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar informes, séries e participantes `GET /v1/emissoes/{tipo}/{cnpj}/{codigo}/{recurso}` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Recursos informes, series e participantes do certificado. Balanço, carteira, prazos e fluxos permanecem em dados. Preserve versão, source_sha256 e unidades; DFIN/termos não têm vínculo canônico geral por certificado. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `tipo` | path | sim | string | — | | `cnpj` | path | sim | string | CNPJ com 14 dígitos; pontuação é aceita. | | `codigo` | path | sim | string | — | | `recurso` | path | sim | string | — | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | | `source_sha256` | query | não | string | — | ```bash curl "https://api.fidcs.com.br/v1/emissoes/CRI/12813212000177//informes" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Séries diárias ### Consultar série diária do fundo `GET /v1/series-diarias/{cnpj}` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Cotas diárias e métricas da identidade escolhida. Se houver ambiguidade, descubra source_series_id em identidades; não una séries distintas. Páginas do mesmo intervalo incluídas por 15 minutos. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cnpj` | path | sim | string | CNPJ com 14 dígitos; pontuação é aceita. | | `subclass_source_id` | query | não | string | — | | `from_date` | query | não | string | — | | `to_date` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | | `calculation_release_id` | query | não | string | — | | `source_series_id` | query | não | string | — | ```bash curl "https://api.fidcs.com.br/v1/series-diarias/12813212000177" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar desempenho calculado do fundo `GET /v1/series-diarias/{cnpj}/desempenho` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Retornos, volatilidade, drawdown e Sharpe calculados pelo ETL. source_series_id obrigatório quando ambíguo; frequency daily ou monthly. Retornos/risco são frações; Sharpe é índice. Preserve window_context e motivos de indisponibilidade. Paginação incluída por 15 minutos. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cnpj` | path | sim | string | CNPJ com 14 dígitos; pontuação é aceita. | | `source_series_id` | query | não | string | — | | `frequency` | query | não | string | — | | `from_date` | query | não | string | — | | `to_date` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/series-diarias/12813212000177/desempenho" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Listar identidades da série diária `GET /v1/series-diarias/{cnpj}/identidades` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Origens e identificadores source_series_id disponíveis para o CNPJ. Cadastro não certifica existência de observações no período. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cnpj` | path | sim | string | CNPJ com 14 dígitos; pontuação é aceita. | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/series-diarias/12813212000177/identidades" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Informes estruturados ### Consultar informes FII/FIP `GET /v1/informes-estruturados/{cnpj}` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Linhas da revisão exata de informes FII mensais, trimestrais e anuais e FIP trimestrais/quadrimestrais. Preserve dataset, ano, versão e source_sha256; paginação por cursor. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cnpj` | path | sim | string | CNPJ com 14 dígitos; pontuação é aceita. | | `dataset` | query | sim | string | — | | `year` | query | sim | integer | — | | `source_sha256` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/informes-estruturados/12813212000177?dataset=DFP&year=%3Cyear%3E" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Títulos públicos ### Consultar curva e histórico do Tesouro `GET /v1/titulos-publicos` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Curva por date ou histórico por ticker. Datas de intervalo exigem ticker; date seleciona a última cotação até a data. Taxas anuais em fração e PU em BRL; compra, venda e preço indicativo são distintos. Sem interpolação sintética. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `ticker` | query | não | string | — | | `date` | query | não | string | — | | `from_date` | query | não | string | — | | `to_date` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/titulos-publicos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Macroeconomia e benchmarks ### Consultar histórico BOVA11 `GET /v1/benchmarks/{benchmark}/serie-diaria` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Fechamentos B3 não ajustados de BOVA11, em BRL por cota. É proxy de ETF, não série oficial do Ibovespa nem retorno total. Siga next_cursor; total pode ser null até a última página. Paginação incluída por 15 minutos. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `benchmark` | path | sim | string | — | | `from_date` | query | não | string | — | | `to_date` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/benchmarks/bova11/serie-diaria" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar CDI diário `GET /v1/benchmarks/cdi/serie-diaria` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Série canônica do CDI com intervalo from_date/to_date. Preserve unidade, frequência e fonte; páginas do mesmo intervalo incluídas por 15 minutos. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `from_date` | query | não | string | — | | `to_date` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/benchmarks/cdi/serie-diaria" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar séries macroeconômicas BCB `GET /v1/macroeconomia/{serie_id}` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. SGS 11 Selic efetiva (% ao dia), 432 meta Selic (% ao ano) e 433 IPCA (% de variação mensal). Preserve unidade e frequência; não anualizar nem converter silenciosamente. CDI usa sua rota própria. Paginação incluída por 15 minutos. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `serie_id` | path | sim | string | — | | `from_date` | query | não | string | — | | `to_date` | query | não | string | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/macroeconomia/433" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Descoberta ### Resolver um identificador `GET /v1/resolve` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Aceita CNPJ, código CVM ou ANBIMA e devolve fundos e classes compatíveis sem escolher silenciosamente quando houver ambiguidade. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `cnpj` | query | não | string | CNPJ com 14 dígitos; pontuação é aceita. | | `cvm_code` | query | não | string | Código CVM do fundo, classe ou subclasse. | | `anbima_code` | query | não | string | Código ANBIMA da classe ou subclasse. | ```bash curl "https://api.fidcs.com.br/v1/resolve" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "query": { "cnpj": "12813212000177" }, "resolution": "multiple", "identity_status": "persistent_registry", "funds": [ { "fund_id": "e18a9ac1-552c-47c4-969a-ec94344d7d0f", "cvm_code": 210091, "cnpj": "12813212000177", "name": "RNX FUNDO DE INVESTIMENTO EM DIREITOS CREDITÓRIOS MULTISSETORIAL", "status": "Em Funcionamento Normal", "fund_type": "FIDC", "valid_from": "2011-03-09", "valid_to": null, "matched_as": "fund_cnpj", "class_ids": [ "b2e1079e-53ab-4306-acc6-905c37ed1021" ] } ], "classes": [ { "class_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "fund_id": "e18a9ac1-552c-47c4-969a-ec94344d7d0f", "cvm_code": 30090, "cnpj": "12813212000177", "name": "RNX FIDC", "status": "Em Funcionamento Normal", "class_type": "Classe", "valid_from": "2011-03-09", "valid_to": null, "matched_as": "class_cnpj" } ] }, "meta": { "request_id": "951d0479-8a56-4b4a-82c0-60229ae046fb", "data_release": null, "as_of": null, "row_count": 2, "identity_status": "persistent_registry", "sources": [ { "provider": "CVM", "dataset": "cadastro_fundos" } ] } } ``` ### Consultar catálogo da API `GET /v1/schema` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Lista entidades, recursos publicados, campos, unidades, fontes e recursos planejados. ```bash curl "https://api.fidcs.com.br/v1/schema" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar meses disponíveis `GET /v1/classes/{class_id}/cobertura` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Informa a cobertura independente de cada recurso. Um mês disponível em cotas pode não existir em carteira ou demonstrativo. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/classes//cobertura" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "entity_id": "string", "resources": [ { "resource": "string", "available": true, "first_month": "2026-07", "last_month": "2026-07", "month_count": 1, "months": [ "2026-07" ] } ] }, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar disponibilidade periódica `GET /v1/classes/{class_id}/disponibilidade-periodica` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Cobertura efetiva por fonte e competência. A existência cadastral da classe não comprova entrega de informes. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/classes//disponibilidade-periodica" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Cadastro ### Buscar fundos FIDC `GET /v1/fundos` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Pesquisa somente o universo classificado como FIDC. Use o `next_cursor` retornado para buscar a página seguinte com os mesmos filtros. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `q` | query | não | string | Busca parcial por nome do fundo, CNPJ, gestor ou administrador. | | `cnpj` | query | não | string | CNPJ com 14 dígitos; pontuação é aceita. | | `status` | query | não | string | Situação cadastral, sem diferenciar maiúsculas e minúsculas. | | `manager` | query | não | string | Trecho do nome do gestor. | | `administrator` | query | não | string | Trecho do nome do administrador. | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/fundos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "fund_id": "e18a9ac1-552c-47c4-969a-ec94344d7d0f", "cvm_code": 210091, "cnpj": "12813212000177", "name": "RNX FUNDO DE INVESTIMENTO EM DIREITOS CREDITÓRIOS MULTISSETORIAL DE RESPONSABILIDADE LIMITADA", "status": "Em Funcionamento Normal", "fund_type": "FIDC", "manager": "OURO PRETO GESTÃO DE RECURSOS S.A.", "administrator": "QI CORRETORA DE TÍTULOS E VALORES MOBILIÁRIOS S.A.", "registered_at": "2010-11-29", "started_at": "2011-03-09", "cancelled_at": null, "ended_at": null, "fiscal_year_end_at": "2027-07-31", "registered_patrimony_brl": 441241722.73, "active": true, "classes": [ { "class_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "cvm_code": 30090, "cnpj": "12813212000177", "name": "RNX FIDC", "status": "Em Funcionamento Normal" } ] } ], "meta": { "request_id": "951d0479-8a56-4b4a-82c0-60229ae046fb", "data_release": null, "as_of": null, "row_count": 1, "sources": [ { "provider": "CVM", "dataset": "cadastro_fundos" } ], "universe_filter": { "fund_type": "FIDC" }, "pagination": { "limit": 25, "has_more": false, "next_cursor": null } } } ``` ### Consultar cadastro da classe `GET /v1/classes/{class_id}` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Devolve cadastro, situação, classificação e vínculo da classe com seu fundo. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/classes/" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "class_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "fund_id": "e18a9ac1-552c-47c4-969a-ec94344d7d0f", "cvm_code": "string", "cnpj": "12813212000177", "name": "RNX FIDC", "fund_name": "RNX FIDC", "status": "available", "class_type": "string", "classification": "string", "anbima_classification": "string", "registered_at": "string", "constituted_at": "string", "started_at": "string", "status_since": "available", "condominium_form": "string", "exclusive": "string", "target_audience": "string" }, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Listar participantes da classe `GET /v1/classes/{class_id}/participantes` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Devolve participantes próprios da classe e relações herdadas do fundo com o escopo explicitado. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/classes//participantes" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "role": "administrator", "name": "RNX FIDC", "document": "string", "applies_to": [ "fund" ] } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Listar subclasses ANBIMA `GET /v1/classes/{class_id}/subclasses` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Lista subclasses identificadas pela fonte ANBIMA; não confundir com séries mensais de cotas. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/classes//subclasses" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "subclass_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "class_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "anbima_code": "string", "cvm_code": "string", "name": "RNX FIDC", "status": "available", "activity_started_at": "string", "first_subscription_at": "string", "class_cnpj": "12813212000177", "fund_cnpj": "12813212000177", "category": "string", "type": "string", "focus": "string", "investor_type": "string", "investor_characteristic": "string", "opening_share": "string", "minimum_initial_subscription_brl": 743280099.39, "redemption_payment_days": 1, "adapted_to_rcvm_175": "string" } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Listar subclasses CVM `GET /v1/classes/{class_id}/subclasses-cvm` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Subclasses cadastradas segundo a CVM/RCVM 175. Este cadastro é distinto das subclasses ANBIMA e não comprova informes disponíveis. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/classes//subclasses-cvm" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar cadastro do fundo `GET /v1/fundos/{fund_id}` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Devolve os dados cadastrais do registro de fundo identificado por `fund_id`. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `fund_id` | path | sim | string | UUID persistente do fundo, obtido em `/v1/fundos` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/fundos/" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "fund_id": "e18a9ac1-552c-47c4-969a-ec94344d7d0f", "cvm_code": "string", "cnpj": "12813212000177", "name": "RNX FIDC", "status": "available", "fund_type": "string", "registered_at": "string", "started_at": "string", "cancelled_at": "string", "ended_at": "string", "administrator_since": "string", "fiscal_year_end_at": "string", "rcvm175_adapted_at": "string", "registered_patrimony_brl": 743280099.39 }, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Listar classes do fundo `GET /v1/fundos/{fund_id}/classes` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Devolve as classes relacionadas ao fundo e seus `class_id`, necessários nas rotas analíticas. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `fund_id` | path | sim | string | UUID persistente do fundo, obtido em `/v1/fundos` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/fundos//classes" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "class_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "fund_id": "e18a9ac1-552c-47c4-969a-ec94344d7d0f", "cvm_code": "string", "cnpj": "12813212000177", "name": "RNX FIDC", "status": "available", "class_type": "string", "registered_at": "string", "started_at": "string" } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Listar participantes do fundo `GET /v1/fundos/{fund_id}/participantes` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Devolve gestor e administrador declarados no cadastro do fundo. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `fund_id` | path | sim | string | UUID persistente do fundo, obtido em `/v1/fundos` ou `/v1/resolve`. | ```bash curl "https://api.fidcs.com.br/v1/fundos//participantes" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "role": "administrator", "name": "RNX FIDC", "document": "string", "applies_to": [ "fund" ] } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Filtrar o universo de fundos `GET /v1/screening` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Combina gestora, administrador, situação e tipo. Use fund_type=fidc e status=pre_operacional para o cadastro completo de pré-operacionais. Para renda fixa com PL acima de R$100 milhões, use fund_type=renda_fixa e nav_gt=100000000. Inadimplência acima de 10%: delinquency_gt=0.10. Filtros numéricos consultam o universo mensal; meta.month informa a competência. Siga meta.pagination.next_cursor com os mesmos filtros até has_more=false. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `fund_type` | query | não | string | Universo: all, fidc ou renda_fixa (exclui previdência RF). | | `manager` | query | não | string | Trecho do nome da gestora. | | `administrator` | query | não | string | Trecho do nome do administrador. | | `status` | query | não | string | Situação CVM ou alias: pre_operacional, normal, cancelado, liquidacao. | | `q` | query | não | string | Trecho do nome no recorte mensal; no cadastro também busca CNPJ e participantes. | | `nav_gt` | query | não | number | PL estritamente maior que este valor, em reais (BRL). | | `delinquency_gt` | query | não | number | Inadimplência estritamente maior, em fração: 0.10 significa 10%. | | `month` | query | não | string | Competência YYYY-MM; ausente, usa o mês mais recente com dados do indicador/tipo. | | `limit` | query | não | integer | Quantidade por página. Padrão 50; máximo 1.000. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | | `include_risk_context` | query | não | boolean | — | ```bash curl "https://api.fidcs.com.br/v1/screening" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "fund_id": "e18a9ac1-552c-47c4-969a-ec94344d7d0f", "cnpj": "12813212000177", "cvm_code": "string", "name": "RNX FIDC", "status": "available", "fund_type": "string", "manager": "string", "administrator": "string", "registered_at": "string" } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Visão geral ### Consultar indicadores históricos `GET /v1/classes/{class_id}/indicadores` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Série mensal reconciliada de patrimônio líquido e número de investidores. Sem intervalo, usa a janela histórica padrão. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//indicadores" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "reporting_date": "2026-07-31", "nav_brl": 743280099.39, "investor_count": 1 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar fotografia mensal `GET /v1/classes/{class_id}/snapshot` · 5 créditos Cobrança por chamada/página, sem navegação incluída. Consolida uma competência e compara apenas com o mês-calendário anterior. `receivables_brl` preserva o bruto calculado; `receivables` distingue bruto, líquido informado e PDD, com reconciliação aritmética. Valores ausentes não são zero. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//snapshot" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "class_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "month": "2026-07", "previous_month": "2026-06", "nav_brl": 758500000, "nav_previous_brl": 746900000, "nav_variation_ratio": 0.0155, "investor_count": 41, "investor_count_previous": 39, "investor_count_delta": 2, "delinquency_ratio": 0.0639, "delinquency_previous_ratio": 0.0612, "delinquency_variation_pp": 0.27, "pdd_brl": 43400000, "pdd_ratio": 0.0572, "subordination_with_mezzanine_ratio": 0.284, "subordination_without_mezzanine_ratio": 0.191, "subordination_previous_ratio": 0.279, "subordination_variation_pp": 0.5, "receivables_brl": 679600000, "positive_segment_count": 3, "series_with_profitability_count": 2 }, "meta": { "request_id": "951d0479-8a56-4b4a-82c0-60229ae046fb", "data_release": "2026-07", "as_of": "2026-07", "row_count": 1, "sources": [ { "provider": "CVM", "dataset": "informe_mensal_fidc" } ] } } ``` ## Carteira ### Consultar carteira ativo a ativo (CDA) `GET /v1/classes/{class_id}/carteira/ativos` · 1 crédito Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Posições públicas CDA da classe em month explícito, sem truncar linhas ou converter null em zero. Siga next_cursor; páginas da mesma chave/classe/mês incluídas por 15 minutos. Posições confidenciais podem faltar; fundos investidos exigem consultas separadas no mesmo mês. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `month` | query | sim | string | Competência exata no formato `YYYY-MM`. | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `cursor` | query | não | string | Cursor opaco retornado em `meta.pagination.next_cursor`. Reutilize os mesmos filtros. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/ativos?month=2026-07" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": {}, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar concentração de cedentes `GET /v1/classes/{class_id}/carteira/concentracao-cedentes` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Histórico mensal de concentração Top 1, Top 3, Top 5 e HHI quando disponíveis. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/concentracao-cedentes" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "type": "string", "position": 1, "cedent_document": "string", "share_ratio": 0.0639, "top1_ratio": 0.0639, "top3_ratio": 0.0639, "top5_ratio": 0.0639, "hhi": 743280099.39, "cedent_count": 1 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar estrutura da carteira `GET /v1/classes/{class_id}/carteira/estrutura` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Hierarquia da carteira. Para composição patrimonial, DCs líquidos informados = i2a+i2b; carteira total = i2. Não some pais e filhos. `meta.receivables_by_month` reconcilia bruto-PDD-líquido por competência; `mismatch` não prova fraude nem mudança metodológica. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/estrutura" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "code": "string", "name": "RNX FIDC", "parent_code": "string", "value_brl": 743280099.39, "total_type": "string", "order": 1 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar inadimplência `GET /v1/classes/{class_id}/carteira/inadimplencia` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Histórico mensal de inadimplência. `direitos_creditorios_brl` é o bruto calculado, não o líquido nem a carteira total. O índice histórico preserva (a.2.1+b.2.1+a.3+b.3)/bruto; a.5/b.5 não entra no numerador. `receivables` explicita bruto, líquido, PDD e reconciliação. As faixas de atraso têm rota própria. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/inadimplencia" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "carteira_total_brl": 743280099.39, "direitos_creditorios_brl": 680560578.74, "adimplente_brl": 636204913.69, "inadimplente_brl": 43396927.97, "inadimplencia_ratio": 0.0637664439076764, "receivables": { "gross_calculated_brl": 680560578.74, "net_reported_brl": 663090848.1, "pdd_brl": 17469730.64, "reconciliation": { "status": "matched", "difference_brl": 0, "reason": null } } } ], "meta": { "request_id": "example-rnx-2026-07", "data_release": null, "as_of": "2026-07", "row_count": 1, "sources": [ { "provider": "CVM", "dataset": "inf_mensal_fidc" } ], "receivables_definitions": { "version": "receivables-v1", "gross_calculated_brl": "Soma i.2.a.1 a i.2.a.5 + i.2.b.1 a i.2.b.5, antes da PDD.", "net_reported_brl": "Soma dos totais informados i.2.a + i.2.b, após provisões.", "pdd_brl": "Soma i.2.a.11 + i.2.b.11; valor da provisão em BRL.", "reconciliation": { "formula": "gross_calculated_brl - pdd_brl - net_reported_brl", "tolerance_brl": 0.01, "meaning": "Conferência aritmética, não auditoria nem prova de reenquadramento." }, "legacy_gross_aliases": [ "direitos_creditorios_brl" ], "composition_basis": "Para a composição da estrutura patrimonial, use líquido informado e carteira total i.2 da mesma competência. Segmentos têm perímetro próprio.", "historical_ratios": "Fórmulas preservadas: inadimplencia_ratio usa (a.2.1+b.2.1+a.3+b.3) / bruto; não inclui a.5/b.5 no numerador. pdd_ratio usa PDD / bruto. Ambas são frações. Adimplente + inadimplente não esgota necessariamente o bruto. Não derive líquido, não remova rubricas para fechar diferenças e não conclua mudança metodológica apenas pela reconciliação." } } } ``` ### Consultar faixas de atraso `GET /v1/classes/{class_id}/carteira/inadimplencia/faixas` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Atrasos cumulativos estritamente maiores que overdue_days; não some linhas. ratio_denominator_brl explicita o total das dez faixas exclusivas V/VI (a vencer + inadimplente), distinto do bruto do quadro I. Ratios históricos preservados. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `month` | query | sim | string | Competência exata no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/inadimplencia/faixas?month=2026-07" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "overdue_days": 1, "ratio_denominator_brl": 0.0639, "delinquent_brl": 743280099.39, "delinquent_ratio": 0.0639 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar PDD `GET /v1/classes/{class_id}/carteira/pdd` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Histórico mensal de PDD. `pdd_ratio` preserva PDD/bruto calculado em fração. `receivables` separa o bruto do líquido informado e confere bruto-PDD-líquido, sem corrigir os valores publicados. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/pdd" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "pdd_brl": 743280099.39, "pdd_ratio": 0.0639, "receivables": { "gross_calculated_brl": 743280099.39, "net_reported_brl": 743280099.39, "pdd_brl": 743280099.39, "reconciliation": { "status": "matched", "difference_brl": null, "reason": null } } } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar prazos da carteira `GET /v1/classes/{class_id}/carteira/prazos` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Distribuição mensal dos direitos creditórios por faixa de vencimento. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/prazos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "bucket_code": "string", "bucket_name": "RNX FIDC", "performing_brl": 743280099.39, "delinquent_brl": 743280099.39, "total_brl": 743280099.39, "delinquent_ratio": 0.0639, "prepaid_brl": 743280099.39 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar carteira por segmento `GET /v1/classes/{class_id}/carteira/segmentos` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Distribuição mensal dos direitos creditórios por segmento econômico informado à CVM. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/segmentos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "segment_code": "string", "segment_name": "RNX FIDC", "value_brl": 743280099.39, "portfolio_total_brl": 743280099.39, "ratio": 0.0639 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar substituições e recompras `GET /v1/classes/{class_id}/carteira/substituicoes-recompras` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Histórico mensal de substituições e recompras. receivables_net_reported_brl é o líquido informado i2a+i2b, denominador dos ratios; receivables_brl permanece como alias legado líquido nesta rota, diferente do bruto no snapshot. Não equivale automaticamente a índices contratuais ajustados. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/substituicoes-recompras" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "substitution_brl": 743280099.39, "repurchase_brl": 743280099.39, "receivables_brl": 743280099.39, "receivables_net_reported_brl": 743280099.39, "substitution_ratio": 0.0639, "repurchase_ratio": 0.0639 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Cotas e rentabilidade ### Consultar cotas `GET /v1/classes/{class_id}/cotas` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Histórico de PL, quantidade e valor por série. `series_id` é contextual enquanto não houver ID canônico da CVM. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//cotas" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "reporting_date": "2026-07-31", "month": "2026-07", "series_id": "string", "share_class_type": "string", "series_code": "string", "series_label": "string", "series_nav_brl": 743280099.39, "senior_nav_brl": 743280099.39, "mezzanine_nav_brl": 743280099.39, "subordinated_nav_brl": 743280099.39, "total_nav_brl": 743280099.39, "subordination_with_mezzanine_ratio": 0.0639, "subordination_without_mezzanine_ratio": 0.0639 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar operações com cotas `GET /v1/classes/{class_id}/cotas/operacoes` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Histórico de captações, resgates e amortizações por série ou tipo de cota. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//cotas/operacoes" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "reporting_date": "2026-07-31", "month": "2026-07", "series_id": "string", "share_class_type": "string", "series_code": "string", "series_label": "string", "subscriptions_shares": 743280099.39, "subscriptions_brl": 743280099.39, "paid_redemptions_shares": 743280099.39, "paid_redemptions_brl": 743280099.39, "pending_redemptions_shares": 743280099.39, "pending_redemptions_brl": 743280099.39, "amortization_per_share_brl": 743280099.39, "amortization_brl": 743280099.39, "net_flow_brl": 743280099.39, "outflows_brl": 743280099.39, "subscription_outlier_removed": true, "subscription_original_brl": 743280099.39, "manager_reference_nav_brl": 743280099.39 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar rentabilidade `GET /v1/classes/{class_id}/rentabilidade` · 2 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Rentabilidade mensal, CDI e métricas relativas; pode ser filtrada por `series_id`. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | | `series_id` | query | não | string | Identificador contextual da série retornado pelas rotas de cotas. | ```bash curl "https://api.fidcs.com.br/v1/classes//rentabilidade" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "series_id": "string", "share_class_type": "string", "series_label": "string", "expected_return_pct": 743280099.39, "realized_return_pct": 743280099.39, "monthly_cdi_pct": 743280099.39, "business_days": 1, "realized_cdi_pct": 743280099.39, "expected_cdi_pct": 743280099.39, "realized_cdi_plus_pct": 743280099.39, "expected_cdi_plus_pct": 743280099.39, "realized_return_since_inception_pct": 743280099.39, "realized_return_ytd_pct": 743280099.39, "expected_return_since_inception_pct": 743280099.39, "cdi_since_inception_pct": 743280099.39, "cdi_ytd_pct": 743280099.39, "realized_cdi_plus_since_inception_pct": 743280099.39, "expected_cdi_plus_since_inception_pct": 743280099.39, "realized_cdi_plus_ytd_pct": 743280099.39, "expected_cdi_plus_ytd_pct": 743280099.39 } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Demonstrativo ### Consultar demonstrativo mensal `GET /v1/classes/{class_id}/demonstrativo` · 10 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Devolve o demonstrativo CVM linha a linha para `month`. Não há fallback nem histórico completo nesta rota. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//demonstrativo" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "reporting_entity_id": "string", "month": "2026-07", "cnpj": "12813212000177", "fund_name": "RNX FIDC", "status": "available", "sections": [ { "id": "string", "label": "string", "description": "string", "order": 1, "status": "available", "row_count": 1 } ], "rows": [ { "id": "string", "section_id": "string", "code": "string", "label": "string", "parent_code": "string", "level": 1, "unit": "string", "value_type": "currency", "row_type": "value", "order": 1, "series_key": "string", "position_key": "string", "value": "string" } ] }, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Investidores ### Listar fundos investidores `GET /v1/classes/{class_id}/investidores` · 3 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Use `month` para uma competência ou `from`/`to` para o histórico de fundos identificados em carteiras públicas. Não representa todos os cotistas. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | | `from` | query | não | string | Primeira competência do intervalo, inclusive, no formato `YYYY-MM`. | | `to` | query | não | string | Última competência do intervalo, inclusive, no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//investidores" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "previous_month": "2026-07", "investor_cnpj": "12813212000177", "investor_name": "RNX FIDC", "investor_manager": "string", "investor_fund_type": "string", "investor_fund_type_label": "string", "position_brl": 743280099.39, "previous_position_brl": 743280099.39, "position_variation_brl": 743280099.39, "position_variation_pct": 743280099.39, "position_share_of_investor_nav_pct": 743280099.39, "position_share_of_invested_nav_pct": 743280099.39, "investor_nav_brl": 743280099.39, "invested_nav_brl": 743280099.39, "acquisitions_brl": 743280099.39, "sales_brl": 743280099.39, "movement": "string" } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## FIC-FIDC ### Listar FIDCs investidos `GET /v1/classes/{class_id}/carteira/fundos` · 5 créditos Páginas elegíveis incluídas por 15 minutos, na mesma chave e filtros. Posições diretas em FIDCs divulgadas na carteira pública da classe para uma competência exata. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//carteira/fundos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "month": "2026-07", "invested_cnpj": "12813212000177", "invested_fund_id": "e18a9ac1-552c-47c4-969a-ec94344d7d0f", "invested_class_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "invested_class_ids": [ "b2e1079e-53ab-4306-acc6-905c37ed1021" ], "identity_status": "unique_class", "invested_name": "RNX FIDC", "manager": "string", "administrator": "string", "status": "available", "position_brl": 743280099.39, "previous_position_brl": 743280099.39, "position_variation_brl": 743280099.39, "position_variation_pct": 743280099.39, "position_share_of_investor_nav_pct": 743280099.39, "investor_nav_brl": 743280099.39, "invested_nav_brl": 743280099.39, "acquisitions_brl": 743280099.39, "sales_brl": 743280099.39, "movement": "string", "subordination_ratio": 0.0639, "subordination_as_of": "string", "delinquency_ratio": 0.0639, "delinquency_as_of": "string", "pdd_ratio": 0.0639, "pdd_as_of": "string", "primary_segment_code": "string", "primary_segment_name": "RNX FIDC", "primary_segment_ratio": 0.0639, "segment_as_of": "string", "segments": [ { "code": "string", "name": "RNX FIDC", "ratio": 0.0639 } ], "anbima_type": "string" } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Consultar Raio-X FIC-FIDC `GET /v1/classes/{class_id}/raio-x` · 10 créditos Cobrança por chamada/página, sem navegação incluída. Agrega uma competência em resumo, concentrações, segmentos look-through e médias ponderadas. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `month` | query | não | string | Competência exata no formato `YYYY-MM`. | ```bash curl "https://api.fidcs.com.br/v1/classes//raio-x" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": { "class_id": "b2e1079e-53ab-4306-acc6-905c37ed1021", "month": "2026-07", "status": "available", "summary": { "total_fidc_assets": 1, "total_position_brl": 743280099.39, "total_position_pct_investor_nav": 743280099.39, "top3_pct_identified_positions": 743280099.39, "investor_nav_brl": 743280099.39, "residual_unidentified_brl": 743280099.39, "residual_unidentified_ratio": 0.0639 }, "manager_concentration": [ { "name": "RNX FIDC", "position_brl": 743280099.39, "identified_positions_ratio": 0.0639, "holding_count": 1, "invested_class_ids": [ "b2e1079e-53ab-4306-acc6-905c37ed1021" ] } ], "administrator_concentration": [ { "name": "RNX FIDC", "position_brl": 743280099.39, "identified_positions_ratio": 0.0639, "holding_count": 1, "invested_class_ids": [ "b2e1079e-53ab-4306-acc6-905c37ed1021" ] } ], "look_through_segments": [ { "segment_code": "string", "segment_name": "RNX FIDC", "portfolio_contribution_ratio": 0.0639, "covered_position_ratio": 0.0639, "component_count": 1 } ], "subordination": { "value": 743280099.39, "total_position_brl": 743280099.39, "covered_position_brl": 743280099.39, "covered_position_ratio": 0.0639, "holding_count": 1, "covered_holding_count": 1, "as_of": "string" }, "delinquency": { "value": 743280099.39, "total_position_brl": 743280099.39, "covered_position_brl": 743280099.39, "covered_position_ratio": 0.0639, "holding_count": 1, "covered_holding_count": 1, "as_of": "string" }, "pdd": { "value": 743280099.39, "total_position_brl": 743280099.39, "covered_position_brl": 743280099.39, "covered_position_ratio": 0.0639, "holding_count": 1, "covered_holding_count": 1, "as_of": "string" }, "anbima": [ { "type": "string", "position_brl": 743280099.39, "identified_positions_ratio": 0.0639, "holding_count": 1 } ], "block_status": {} }, "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ## Operação ### Pesquisar documentos da classe `GET /v1/classes/{class_id}/documentos` · 1 crédito Cobrança por chamada/página, sem navegação incluída. Lista documentos da classe e do fundo relacionado com tipo, data e link oficial da CVM, sem baixar o arquivo. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `document_type` | query | não | string | — | | `start_year` | query | não | integer | — | | `end_year` | query | não | integer | — | | `limit` | query | não | integer | Quantidade de itens na página. Padrão 25; máximo 100. | | `offset` | query | não | integer | — | ```bash curl "https://api.fidcs.com.br/v1/classes//documentos" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json { "data": [ { "document_id": "string", "scope": "class", "document_type": "string", "document_type_slug": "string", "category": "string", "document_date": "2026-07-31", "received_at": "string", "reference_year": 1, "file_name": "RNX FIDC", "source_url": "string" } ], "meta": { "request_id": "req_exemplo_01", "data_release": "2026-07-31", "as_of": "string", "row_count": 1, "sources": [ { "provider": "string", "dataset": "2026-07-31" } ], "field_sources": {}, "receivables_definitions": {}, "receivables_by_month": [ {} ] } } ``` ### Obter documento original `GET /v1/classes/{class_id}/documentos/arquivo` · 5 créditos Cobrança por chamada/página, sem navegação incluída. Baixa o PDF oficial sob demanda e o guarda no cache do R2 para as próximas leituras. | Parâmetro | Onde | Obrigatório | Tipo | Descrição | | --- | --- | --- | --- | --- | | `class_id` | path | sim | string | UUID persistente da classe, obtido em `/v1/fundos/{fund_id}/classes` ou `/v1/resolve`. | | `document_id` | query | sim | string | — | ```bash curl "https://api.fidcs.com.br/v1/classes//documentos/arquivo?document_id=%3Cdocument_id%3E" \ -H "Authorization: Bearer $FIDCS_API_KEY" ``` Exemplo de resposta (listas encurtadas): ```json "string" ``` ### Verificar saúde do serviço `GET /health` · grátis · sem autenticação Confirma que o processo HTTP está ativo. Não exige chave e não testa as fontes de dados. ```bash curl "https://api.fidcs.com.br/health" ``` Exemplo de resposta (listas encurtadas): ```json { "status": "available" } ``` ### Consultar créditos e limites `GET /pricing` · grátis · sem autenticação Publica a política vigente, os limites comuns de acesso e o custo fixo de cada operação. ```bash curl "https://api.fidcs.com.br/pricing" ``` Exemplo de resposta (listas encurtadas): ```json { "policy_version": "string", "unit": "string", "pricing_model": "string", "unused_credits_roll_over": true, "mcp_uses_underlying_rest_charge": true, "platform_errors_are_refunded": true, "consumer_errors_are_charged": true, "consumer_error_refund_statuses": [ 1 ], "paid_navigation": {}, "access_policy": { "history_months": 1, "requests_per_minute": 1, "rate_limit_scope": "string", "rate_limit_window": "string" }, "balance_policy": {}, "operations": [ { "operation": "string", "label": "string", "category": "string", "method": "string", "path": "string", "cost": 1, "reason": "string" } ] } ```