Lista Completa de Fundos
Esta API divulga a lista completa de fundos existentes na base do ANBIMA Feed com o resumo de seus respectivos dados.
As informações são disponibilizadas pela API com paginação (máximo de 1.000 registros por página). No retorno da API, além da lista de fundos, são informados o número total de fundos e o total de páginas.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v1/fundosO método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundosLista de campos:
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
codigo_fundo | Código ANBIMA | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 6 |
nome_fantasia | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
nome_fantasia_2 | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 200 |
cnpj_fundo | CNPJ | CNPJ do Fundo | Alfanumérico – Comprimento variável | 14 |
classe_anbima | Classe ANBIMA | A classificação ANBIMA busca agregar as diversas opções de carteira oferecidas por meio de fundos de investimento, de acordo com determinadas características do portfólio. Assim, ela leva em consideração as classes de ativos que compõem essa carteira, seus prazos e riscos, além dos estilos e estratégias de gestão. Os possíveis valores para este campo são: – Renda Fixa (RF) – Ações – Cambial – Multimercado (MM) – Previdência | Alfanumérico – Comprimento variável | 20 |
situacao_atual | Situação atual do Fundo | Indicador sobre o status atual do fundo quanto à novos aportes. Os possíveis valores para este campo são: A = Ativo E = Encerrado | Alfanumérico – Comprimento fixo | 1 |
data_inicio_divulgacao_cota | Data de início de divulgação de cotas do fundo | Representa a primeira data de registro de série histórica (dados periódicos) | Data | YYYY-MM-DD |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Página | page=1 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos?page=1 |
| Quantidade de fundos por página | size=1000 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos?page=1&size=1000 |
Obs. 2: A quantidade máxima de registros por página é 1.000.
Obs. 3: Caso seja informado um valor superior ao limite de páginas existentes, é retornado um erro ‘404 Not Found’.
Detalhes do Fundo
Esta API divulga os dados detalhados de um fundo específico.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v1/fundos/{codigoFundo}O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos/{codigoFundo}As informações presentes nesta API são divididas nos seguintes contextos:
Dados Cadastrais
Este contexto é compreendido pelos dados básicos de identificação de um fundo.
Lista de campos dados-cadastrais:
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
codigo_fundo | Código ANBIMA | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 6 |
nome_fantasia | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
nome_fantasia_2 | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 200 |
razao_social | Razão social | Razão social do fundo | Alfanumérico – Comprimento variável | 150 |
cnpj_fundo | CNPJ | CNPJ do Fundo | Alfanumérico – Comprimento variável | 14 |
codigo_isin | ISIN | Modelo de International Securities Identification Number. Código para identificação dos fundos de investimento, fornecido pela B3, quando este é registrado na referida bolsa como ativo | Alfanumérico – Comprimento variável | 12 |
data_primeiro_aporte | Data do primeiro aporte do fundo | Data em que foi feito o primeiro aporte no fundo | Data | YYYY-MM-DD |
data_inicio | Data de inicio do fundo | Data de inicio do fundo | Data | YYYY-MM-DD |
classe_anbima | Classe ANBIMA | A classificação ANBIMA busca agregar as diversas opções de carteira oferecidas por meio de fundos de investimento, de acordo com determinadas características do portfólio. Assim, ela leva em consideração as classes de ativos que compõem essa carteira, seus prazos e riscos, além dos estilos e estratégias de gestão. Os possíveis valores para este campo são: – Renda Fixa (RF) – Ações – Cambial – Multimercado (MM) – Previdência | Alfanumérico – Comprimento variável | 20 |
tipo_anbima | Tipo ANBIMA | Este campo busca explicitar o tipo de gestão e os riscos a ele associados, fazendo, sempre que possível, a analogia com gestão ativa ou indexada (passiva) para todas as classes de ativos | Alfanumérico – Comprimento variável | 40 |
classe_cvm | Classe CVM | A regulamentação da CVM organiza os fundos de investimento em quatro diferentes classes. Conforme Art. 108, ICVM 555. Os possíveis valores para este campo são: – Renda Fixa (RF) – Ações – Cambial – Multimercado (MM) | Alfanumérico – Comprimento variável | 20 |
subclasse_cvm | Subclasse CVM | A regulamentação da CVM organiza os fundos de investimento em algumas diferentes subclasses. Conforme Art. 108 e suas Subseções ICVM 555. Os possíveis valores para este campo são: – Referenciados – Curto Prazo – Dívida Externa – Ações BDR Nível 1 – Não se Aplica | Alfanumérico – Comprimento variável | 20 |
composicao_fundo | Composição do fundo | – FI: Fundo de Investimento: destina-se, em geral, a receber aplicações de investidores de acordo com seu público-alvo, objetivo e política de investimento. Um FI poderá aplicar até 100% em títulos e valores mobiliários de acordo com a legislação – FC: Fundo de Investimento em Cotas: deve apresentar um valor mínimo de sua carteira em cotas de fundos de investimento, de acordo com a instrução que o rege – FF: Fundo de Investimento Master: recebe aplicações exclusivamente de outros fundos. Neste caso, o público-alvo necessariamente será fundos de investimento e/ou fundos de investimento em cotas. Se o fundo aceitar aplicação tanto de fundos como de carteiras administradas, deverá ser classificado como FI, e não FF – FM: Fundo de Investimento em Cotas Master: fundo de investimento em cotas destinado a receber exclusivamente aplicação de outros fundos | Alfanumérico – Comprimento variável | 20 |
benchmark | Benchmark | Este campo indica o índice de referência de desempenho do fundo | Alfanumérico – Comprimento variável | 20 |
investimento_exterior | Investimento no exterior | Indica se o fundo investe em ativos financeiros negociados no exterior, de acordo com a política de investimento e respeitados os limites previstos no art. 101 da ICVM 555 | Alfanumérico – Comprimento variável [Até 100%, > 67%, Não se Aplica, Até 20 %, Até 40 %] | 20 |
credito_privado | Crédito privado | Indica se o fundo permite aplicação em percentual superior a 50% do patrimônio em ativos de crédito privado (art. 118 da ICVM 555) | Alfanumérico – Comprimento fixo | 20 |
tipo_investidor | Tipo de investidor | Restrição de investimento: tipo de investidor predominante. Os possíveis valores para este campo são: – Exclusivo (fundo constituído para receber aplicações exclusivamente de um único cotista, conforme art. 130 da ICVM 555. Esse campo deve estar coerente com a descrição do público-alvo constante no regulamento do fundo) – Reservado/restrito (grupo determinado de investidores, que tenham entre si vínculo familiar, societário ou pertençam a um mesmo grupo econômico, ou que, por escrito, determinem essa condição. Esse campo deve estar coerente com a descrição do público-alvo constante no regulamento do fundo) – Não há restrição (investidores que apresentam características diferentes de exclusivos e reservados/restritos) | Alfanumérico – Comprimento variável [Exclusivo, Não Há Restrição, Todos, ND, Reservado] | 20 |
caracteristica_investidor | Característica do investidor | No caso brasileiro, a Instrução nº 554/14, da CVM, que altera, entre outros normativos, a Instrução nº 539/13, divide os investidores em três grupos: investidores profissionais, investidores qualificados e os demais investidores, a quem podemos nos referir como investidores de varejo. Consideram-se investidores profissionais pessoas naturais ou jurídicas que possuam investimentos financeiros em valor superior a R$ 10.000.000,00 (dez milhões de reais) e que, adicionalmente, atestem por escrito sua condição de investidor profissional (art. 9º-A, ICVM 554) Consideram-se investidores qualificados pessoas naturais ou jurídicas que possuam investimentos financeiros em valor superior a R$ 1.000.000,00 (um milhão de reais) e que, adicionalmente, atestem por escrito sua condição de investidor qualificado (art. 9º-B, ICVM 554). Consideram-se investidores não qualificados aqueles que apresentam características diferentes de profissional e qualificado | Alfanumérico – Comprimento variável [Não, Inv. Qualificado, Inv. Profissional] | 20 |
cota_abertura | Cota de abertura | A Cota de abertura é aquela que é apurada e conhecida no início do dia. Já a cota de fechamento é aquela que é apurada e conhecida apenas no fechamento do dia, ou seja, após o encerramento dos mercados. Os possíveis valores para este campo são: S = Sim (cota de abertura) N = Não (cota de fechamento) | Alfanumérico – Comprimento fixo | 1 |
permite_alavancagem | Fundo permite alavancagem | O fundo é considerado alavancado sempre que existir possibilidade (diferente de zero) de perda superior ao patrimônio do fundo, desconsiderando-se casos de default nos ativos do fundo. | Alfanumérico – Comprimento fixo | 20 |
aberto_estatutariamente | Aberto estatutariamente | Os fundos de investimento podem ser organizados sob a forma de condomínio aberto ou fechado, conforme disposto no art. 4º da ICVM 555. Os possíveis valores para este campo são: S = aberto estatutariamente (os cotistas podem solicitar o resgate de suas cotas a qualquer tempo) N = fechado estatutariamente (os cotistas podem resgatar suas cotas ao término do prazo de duração do fundo) | Alfanumérico – Comprimento fixo | 1 |
tributacao_alvo | Tributação alvo | Indica o tratamento tributário perseguido pelo fundo para efeito de cobrança de imposto de renda do cotista | Alfanumérico – Comprimento variável[Longo Prazo, Curto Prazo, Renda Variável, Indefinido, ND, Não Aplicável] | 50 |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
situacao_atual | Situação atual do Fundo | Indicador sobre o status atual do fundo quanto à novos aportes. Os possíveis valores para este campo são: A = Ativo E = Encerrado | Alfanumérico – Comprimento fixo | 1 |
multigestor | Multigestor | Indica se o fundo é multigestor (investe em outros fundos), espelho, feeder ou nenhuma das opções | Alfanumérico – Comprimento variável | 20 |
aplicacao_automatica | Aplicação automática | Indica se o fundo permite que o cotista realize aplicações ou resgates automáticos de valores de suas contas no mesmo | Alfanumérico – Comprimento variável | 20 |
foco_atuacao | Foco de atuação | Indica o principal foco de atuação do fundo | Alfanumérico – Comprimento variável | 20 |
esg | ESG – Environmental, Social and Governance (Ambiental, Social e Governança Corporativa) | Indica se o fundo segue as práticas ESG. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Relacionado (R) | Alfanumérico – Comprimento fixo | 1 |
fundo_adaptado_icvm_175 | Fundo Adaptado a CVM 175 | Informa que o fundo está adaptado a CVM 175. Os possíveis valores para o campo são: S = Sim N = Não | Alfanumérico – Comprimento fixo | 1 |
data_fundo_adaptado_icvm_175 | Data do fundo adaptado a CVM 175 | Se o fundo já for adaptado a CVM 175, informada a data na qual ocorreu | Data | YYYY-MM-DD |
responsabilidade_ltda | Responsabilidade Limitada | Informa se o fundo possui responsabilidade limitada | Alfanumérico – Comprimento variável | 50 |
previdencia | Previdência | Caso o fundo seja de Previdência, indica a modalidade a qual se trata | Alfanumérico – Comprimento variável | 20 |
data_encerramento_fundo | Data de encerramento do fundo | Data em que o fundo foi encerrado e não é mais possível realizar aportes. Este campo é exibido apenas quando a situação atual do fundo for igual a “Encerrado” | Data | YYYY-MM-DD |
entidade_investimento_fins_tributarios | Entidade de investimento para fins tributários | Campo referente a tributação da lei 4.173. Os possíveis valores para o campo são: Sim Não Não se aplica | Alfanumérico – Comprimento variável | 50 |
95_por_cento_fundo_isento | 95% em fundos isentos de come-cotas | Campo referente a tributação da lei 4.173. Os possíveis valores para o campo são: Sim Não | Alfanumérico – Comprimento variável | 50 |
Prestadores de Serviço
Este contexto é compreendido pelos diferentes prestadores de serviço de um fundo. Estes prestadores podem ser:
| Prestador | Descrição |
| Administrador | Responsável por todos os serviços relacionados ao funcionamento e manutenção do fundo |
| Gestor | Responsável pela gestão dos ativos do fundo |
| Distribuidor | Responsável pelo relacionamento e vendas para com o investidor final |
| Custodiante | Responsável por manter e guardar os ativos do fundo de investimento |
| Controlador de Ativos | Responsável pela execução dos processos ligados ao controle dos ativos, bem como os procedimentos contábeis |
| Controlador de Passivos | Responsável pela execução dos processos ligados ao controle dos passivos, bem como os procedimentos contábeis |
Lista de campos prestadores:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
nome | Nome do Prestador de Serviço | Este campo informa o nome dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores. | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ do Prestador de Serviço | Este campo informa o cnpj dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores | Alfanumérico – Comprimento variável | 14 |
principal | Gestor principal | Indica se este prestador é o principal gestor do fundo. | Boolean (TRUE, FALSE) | 1 |
Taxas do Fundo
Aqui são detalhadas as informações referentes às taxas aplicadas em um fundo. Trazemos aqui os dados atuais (contexto: taxas) e a lista com o histórico de alterações de taxas (contexto: historico_taxas).
Lista de campos taxas e historico_taxas:
Lista de campos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
unidade | Unidade da taxa de administração | É a remuneração pelos serviços de administração, conforme art. 85 da ICVM 555. Os possíveis valores para este campo são: – Percentual (P) – Valor (V) – Misto (M) | Alfanumérico – Comprimento fixo | 1 |
cobra_taxa_performance | Cobra taxa performance | Taxa de performance é cobrada do cotista quando a rentabilidade do fundo supera a de um indicador de referência, conhecido como benchmark, e existe uma periodicidade mínima para sua cobrança. Os possíveis valores para o campo são: S = Sim (Cobra taxa) N = Não (Não cobra taxa) | Alfanumérico – Comprimento fixo | 1 |
taxa_performance_nao_padronizada | Taxa de performance não padronizada (regras) | Este campo define quais as regras de cobrança de taxa de performance do fundo | Alfanumérico – variável | 500 |
taxa_composta | Taxa composta | Este campo informa quando existe a possibilidade de as taxas cobradas pelos fundos investidos incidirem sobre o fundo objeto de cadastro. Os possíveis valores para o campo são: S = Sim (taxa incide sobre o fundo) N = Não (taxa não incide sobre o fundo) | Alfanumérico – Comprimento fixo | 1 |
taxa_entrada | Taxa de entrada | Taxa cobrada no momento da aplicação de recursos no fundo | Alfanumérico – Comprimento variável | 40 |
taxa_saida | Taxa de saída | Taxa cobrada sobre o valor do resgate | Alfanumérico – Comprimento variável | 40 |
taxa_maxima | Taxa de administração máxima | É o percentual máximo da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa máxima explicitada no regulamento. | Decimal | Tamanho 23 com 6 casas decimais |
taxa_administracao | Taxa de administração | Percentual da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa explicitada no regulamento. | Decimal | Tamanho 23 com 6 casas decimais |
taxa_fixa | Taxa fixa | Informa o percentual de taxa fixa do fundo, caso se aplique. | Alfanumérico – Comprimento variável | 23 |
periodicidade_cobranca_taxa_performance | Periodicidade de cobrança da taxa de performance | Informa a periodicidade em que a taxa de performance é cobrada | Numérico | 19 |
descricao_taxa_performance | Descrição da taxa performance | Detalhamento da taxa de performance | Alfanumérico – variável | 500 |
data_inicio_vigencia_taxa_adm | Data de início de vigência da Taxa de Administração | Indica quando a Taxa de Administração começou a ser praticada | Data/hora | YYYY-MM-DD HH:MI:SS |
data_atualizacao | Data de atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
data_referencia | Data de Referência | Data a qual os valores apresentados se referem | Data/hora | YYYY-MM-DD HH:MI:SS |
Movimentação de Cotas
Este contexto é compreendido pelas informações de aportes, resgates e demais movimentações de cotas em um fundo.
Lista de campos movimentacao:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
prazo_emissao_cotas | Prazo para emissão de cotas | Prazo (em dias) para conversão das cotas para efeito de aplicação de recursos | Alfanumérico – Comprimento variável | 40 |
prazo_pagamento_resgate | Prazo pagamento resgate | Prazo para pagamento do resgate solicitado, ou seja, o número de dias após a data de solicitação do resgate | Alfanumérico – Comprimento variável | 40 |
prazo_conversao_resgate | Prazo de conversão do resgate | Prazo entre o dia da solicitação do resgate das cotas e da efetivação da conversão, de acordo com o art. 37, inciso I, da ICVM 555, isto é, o número de dias após a data de solicitação | Alfanumérico – Comprimento variável | 40 |
carencia_inicial_primeiro_resgate | Carência inicial para 1º resgate | Indica se o fundo estabelece um período em que o investidor não pode resgatar os recursos aplicados no fundo.Carência inicial: prazo mínimo (em dias) a ser respeitado pelo cotista para efetuar resgate a partir de cada aplicação no fundo. | Numérico | 19 |
carencia_ciclica | Carencia ciclica (tempo entre resgates) | Carência cíclica: intervalo de tempo periódico (em dias) a ser respeitado pelo cotista entre um resgate e outro. | Numérico | 19 |
aplicacao_inicial_minima | Aplicação inicial mínima | Refere-se ao mínimo aceitável para efetuar aplicações/movimentação e para manter-se no fundo. Aplicação inicial: mínimo de aporte para ingresso no fundo. | Decimal | 18 |
aplicacao_adicional_minima | Aplicação adicional mínima | Refere-se ao mínimo aceitável para efetuar aplicações/movimentação e para manter-se no fundo. Aplicação adicional: mínimo para aplicações posteriores. | Decimal | 18 |
resgate_minimo | Resgate mínimo | Refere-se ao mínimo aceitável para efetuar aplicações/movimentação e para manter-se no fundo. Resgate: mínimo para retirada de recursos. | Decimal | 18 |
saldo_minimo_aplicado_ao_fundo | Saldo mínimo aplicado ao fundo | Refere-se ao mínimo aceitável para efetuar aplicações/movimentação e para manter-se no fundo. Saldo mínimo: valor mínimo para permanência no fundo | Decimal | 18 |
divulgacao_cota | Periodicidade de divulgação de cota | Indica a periodicidade com a qual o administrador do fundo se responsabiliza por atualizar as informações periódicas. Os possíveis valores para este campo são: – DIARIA – SEMANAL – MENSAL – ANUAL | Alfanumérico – Comprimento variável | 10 |
data_inicio_divulgacao_cota | Data de início de divulgação de cotas do fundo | Representa a primeira data de registro de dados periódicos do fundo | Data | YYYY-MM-DD |
data_referencia | Data de Referência | Data a qual os valores apresentados se referem | Data/hora | YYYY-MM-DD HH:MI:SS |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Documentos do Fundo
Este contexto exibe as informações da documentação existente para o fundo. Atualmente, apenas o regulamento é disponibilizado pela ANBIMA.
Lista de campos documentos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
url | URL do Documento | Endereço eletrônico do arquivo | Alfanumérico – Comprimento variável | 500 |
extensao | Extensão do Documento | As extensões de arquivos são sufixos que designam seu formato. Exemplos: txt, doc, pdf, exe, etc. | Alfanumérico – Comprimento variável | 50 |
codigo_fundo | Código ANBIMA | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 6 |
tipo_documento | Tipo de Documento | Informa o tipo de documento a qual o arquivo se refere. Exemplos: Regulamento, Auditoria, Assembleia, etc. | Alfanumérico – Comprimento variável | 100 |
data_upload | Data do Upload | Data em que o documento foi anexado ao fundo | Data | YYYY-MM-DD |
data_referencia | Data de Referência | Data a qual os valores apresentados se referem | Data/hora | YYYY-MM-DD HH:MI:SS |
nome_arquivo | Nome do Arquivo | Nome do arquivo | Alfanumérico – Comprimento variável | 255 |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Código ANBIMA | codigoFundo | Sim | GET https://api.anbima.com.br/feed/fundos/v1/fundos/546356 |
Série Histórica
Este contexto apresenta os dados periódicos de um fundo da última data disponível (PL e cota).
Lista de campos serie_historica:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
patrimonio_liquido | Patrimônio Líquido do Fundo | Informa o patrimônio líquido do fundo no dia. O patrimônio líquido é calculado pela soma do valor de todos os títulos e do valor em caixa, menos as obrigações do fundo, inclusive aquelas relativas à sua administração. | Decimal | 14 |
valor_cota | Valor da Cota do Fundo | Valor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo. | Decimal | 17 |
captacao | Captação (novos aportes) | Valor total de novos aportes no fundo até a última data de registro | Decimal | 14 |
resgate | Resgates (novos saques) | Soma dos valores resgatados por cotistas e dos resgates de IR | Decimal | 14 |
resgate_detalhamento | Detalhes dos resgates | Detalhe dos resgates realizados | Objeto JSON | |
numero_cotistas | Número de Cotistas | Número total de investidores do fundo | Numérico | 10 |
data_referencia | Data de Referência | Data a qual os valores apresentados se referem | Data/hora | YYYY-MM-DD HH:MI:SS |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Lista de campos resgate_detalhamento
Este contexto é compreendido pelos diferentes prestadores de serviço de um fundo. Estes prestadores podem ser:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
resgates_ir | Valor do IR | Numérico (14) | Valor do resgate do imposto de renda |
resgates_cotista | Valor dos resgates de cotistas | Numérico (14) | Valor de resgates realizados pelos cotistas |
Histórico de Dados Cadastrais
Este endpoint divulga 4 arquivos de texto, extensão “.txt” no qual é possível consultar os histórico de dados cadastrais.
Diferente do endpoint Detalhes do Fundo, responsável somente pela última informação cadastral de cada campo do fundo, nos arquivos é possível verificar a vigência das informações dos campos.
A divulgação dos dados desse endpoint teve início em 15/01/2024
Para acessá-la, deve-se utilizar a seguinte URI:
https://[ambiente]/feed/fundos/v1/fundos/historicoO método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos/historicoLista de campos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
descricao | Descrição | Texto descritivo dos arquivos do fundo | Alfanumérico – Comprimento variável | – |
nome | Nome do arquivo | Data em que a nota explicativa foi gerada | Alfanumérico – Comprimento variável | – |
data | Data de referência | Ano correspondente da nota explicativa | Data | YYYY-MM-DD |
url | URL do Documento | Endereço eletrônico do arquivo | Alfanumérico – Comprimento variável | – |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
data | YYYY-MM-DD | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos/historico?data=2024-01-15 |
Arquivos
Abaixo uma relação dos arquivos presentes no endpoint:
| Nome do Arquivo | Formato do nome | Exemplo |
| anmovcot | nome_data_hora_pacotedefundo | anmovcot_20240115_175033_555.txt |
| anstatus | nome_data_hora_pacotedefundo | anstatus_20240115_175033_555.txt |
| anvlmes | nome_data_hora_pacotedefundo | anvlmes_20240115_175033_555.txt |
| cbtipo | nome_data_hora_pacotedefundo | cbtipo_20240115_175033_555.txt |
Arquivo anmovcot:
A seguir o layout dos arquivos anmovcot
| Campo | Formato | Descrição |
codigo_fundo | Numérico 6 dígitos fixos | Código do Fundo |
data_referencia | dd/mm/aaaa hh:mm:ss | Data de início de vigência para regra de movimentação do fundo. |
aplicacao_inicial_minima | Decimal – Precisão 18/5 Exportação truncada em 2 casas | Valor mínimo para aplicação inicial |
aplicacao_adicional_minima | Decimal – Precisão 18/5 Exportação truncada em 2 casas | Valor mínimo para aplicação adicional |
resgate_minimo | Decimal – Precisão 18/5 Exportação truncada em 2 casas | Valor mínimo para resgate do fundo |
saldo_minimo_aplicado | Decimal – Precisão 18/5 Exportação truncada em 2 casas | Valor mínimo de aplicação |
identificador | Alfanumérico 2 posições | Identifica o preenchimento do campo. VAZIO – Não NA – Não se aplica ND – Não disponível NI – Não informado VL – Valor |
Arquivo anstatus:
A seguir o layout dos arquivos anstatus
| Campo | Formato | Descrição |
codigo_fundo | Numérico 6 dígitos fixos | Código do Fundo |
status | Alfanumérico até 40 posições | Diversos |
opcoes_status | Alfanumérico até 20 posições | Diversos |
dataini | dd/mm/aaaa hh:mm:ss | Data de inicio de vigência do status do fundo |
datafim | dd/mm/aaaa hh:mm:ss | Data de fim de vigência do status do fundo. Caso este status esteja vigente, este campo é vazio. |
Arquivo anvlmes:
A seguir o layout dos arquivos anvlmes
| Campo | Formato | Descrição |
codigo_fundo | Numérico 6 dígitos fixos | Código do Fundo |
mes | Numérico 2 dígitos fixo | Informa o mês da data da informação |
ano | Numérico 4 dígitos fixo | Informa o ano da data da informação |
patrimonio_liquido | Decimal – Precisão 14/2 separado por vírgula | Data de inicio de vigência do status do fundo |
valor_cota | Decimal – Precisão 17/9 separado por vírgula | Data de fim de vigência do status do fundo. Caso este status esteja vigente, este campo é vazio. |
rentmes | Decimal – Precisão 13/7 | Rentabilidade acumulada do fundo no mês |
rentano | Decimal – Precisão 13/7 | Rentabilidade acumulada do fundo no ano |
codtipo | Numérico até 4 dígitos | Código do tipo de fundo |
Arquivo cbtipo:
A seguir o layout dos arquivos cbtipo
| Campo | Formato | Descrição |
codtipo | Numérico até 4 dígitos | Código do tipo de fundo |
descricao | Alfanumérico até 40 posições | Descrição do tipo de fundo |
sigla | Alfanumérico até 6 posições | Sigla do tipo de fundo |
dataini | dd/mm/aaaa hh:mm:ss | Data de inicio de vigência do tipo de fundo |
datafim | dd/mm/aaaa hh:mm:ss | Data de fim de vigência do tipo de fundo. Se o tipo estiver ativo este campo não é preenchido |
Notas Explicativas do Fundo
Esta API divulga a lista de notas explicativas do fundo. Estas notas explicativas indicam eventos relevantes que ocorreram no fundo e foram registrados na base da ANBIMA.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v1/fundos/{codigoFundo}/notas-explicativasO método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos/{codigoFundo}/notas-explicativasLista de campos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
descricao | Descrição | Texto da nota explicativa | Alfanumérico – Comprimento variável | 80 |
data_referencia | Data de referência | Data em que a nota explicativa foi gerada | Data/hora | YYYY-MM-DD HH:MI:SS |
ano_divulgacao | Ano | Ano correspondente da nota explicativa | Alfanumérico – Comprimento variável | 4 |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Código ANBIMA | codigoFundo | Sim | GET https://api.anbima.com.br/feed/fundos/v1/fundos/546356/notas-explicativas |
Série Histórica do Fundo
Esta API divulga exibe uma lista com todo o histórico (diário) de dados periódicos do fundo (PL e cota).
Periodicidade de divulgação: Diária
Horário: A partir das 19h30
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v1/fundos/{codigoFundo}/serie-historicaO método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos/{codigoFundo}/serie-historicaLista de campos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
patrimonio_liquido | Patrimônio Líquido do Fundo | Informa o patrimônio líquido do fundo no dia. O patrimônio líquido é calculado pela soma do valor de todos os títulos e do valor em caixa, menos as obrigações do fundo, inclusive aquelas relativas à sua administração | Decimal | 14 |
valor_cota | Valor da Cota do Fundo | Valor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo | Decimal | 17 |
captacao | Captação (novos aportes) | Valor total de novos aportes no fundo até a última data de registro | Decimal | 14 |
resgate | Resgates (novos saques) | Soma dos valores resgatados por cotistas e dos resgates de IR | Decimal | 14 |
resgate_detalhamento | Detalhes dos resgates | Detalhe dos resgates realizados | Objeto JSON | |
numero_cotistas | Número de Cotistas | Número total de investidores do fundo | Numérico | 10 |
data_referencia | Data de Referência | Data a qual os valores apresentados se referem | Data/hora | YYYY-MM-DD HH:MI:SS |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Lista de campos resgate_detalhamento
Este contexto é compreendido pelos diferentes prestadores de serviço de um fundo. Estes prestadores podem ser:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
resgates_ir | Valor do IR | Numérico (14) | Valor do resgate do imposto de renda |
resgates_cotista | Valor dos resgates de cotistas | Numérico (14) | Valor de resgates realizados pelos cotistas |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Código ANBIMA | codigoFundo | Sim | GET https:// api.anbima.com.br/feed/fundos/v1/fundos/546356/serie-historica |
| Data inicial da consulta | data-inicio=yyyy-MM-dd | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos/546356/serie-historica?data-inicio=2019-11-19&data-fim=2020-11-14 |
| Data final da consulta | data-fim=yyyy-MM-dd | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos/546356/serie-historica?data-inicio=2019-11-19&data-fim=2020-11-14 |
Obs. 2: O período máximo permitido por consulta será de 5 anos (60 meses).
Obs. 3: Caso o período informado na consulta ultrapasse o range de 5 anos, será retornado um erro ‘400 Bad Request’.
Obs. 4: Se o utilizador inserir uma data inicial superior a data fim, é feita a substituição das mesmas e invertida a inicial pela final. Caso a data inicial esteja nula, será considerada a data referente a 1 ano anterior à data fim informada. Se por outro lado, for inserida a data inicial e a final estiver nula, esta última é considerada a data fim que compreende o período de 5 anos a partir da data informada.
Obs. 5: Os dados de série histórica são exibidos por ordem descendente da data de referência (do mais novo ao mais antigo registro).
Fundos Instituição
Esse endpoint divulga a lista completa de instituições na base do ANBIMA Feed.
A relação entre instituições primária e secundária não represente o conceito de conglomerado, ela é autodeclaratória para o fim dos rankings ANBIMA de fundos de investimentos.
As informações são disponibilizadas pela API com paginação (máximo de 1.000 registros por página).
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v1/fundos-instituicaoO método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos-instituicaoLista de campos:
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
nome | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ | CNPJ do fundo | Alfanumérico – Comprimento variável | 14 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N – Não | Alfanumérico – Comprimento fixo | 1 |
Lista de campos instituicoes_secundarias :
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
nome | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ | CNPJ do fundo | Alfanumérico – Comprimento variável | 14 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N – Não | Alfanumérico – Comprimento fixo | 1 |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Página | page=1 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-instituicao?page=1 |
| Quantidade de fundos por página | size=1000 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-instituicao?page=1&size=1000 |
Obs. 2: A quantidade máxima de registros por página é 1.000.
Obs. 3: Caso seja informado um valor superior ao limite de páginas existentes, é retornado um erro ‘404 Not Found’.
Detalhes dos Fundos Instituição
Este endpoint divulga os dados detalhados de uma instituição específica mediante o fornecimento de um CNPJ.
A relação entre instituições primária e secundária não represente o conceito de conglomerado, ela é autodeclaratória para o fim dos rankings ANBIMA de fundos de investimentos.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v1/fundos-instituicao/{CNPJ}O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos-instituicao/{CNPJ}Lista de campos:
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
nome | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ | CNPJ do fundo | Alfanumérico – Comprimento variável | 14 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N – Não | Alfanumérico – Comprimento fixo | 1 |
Lista de campos instituicoes_secundarias :
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
nome | Nome fantasia da Instituição primária | Nome pelo qual a instituição é conhecido | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ | CNPJ da Instituição | Alfanumérico – Comprimento variável | 14 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N – Não | Alfanumérico – Comprimento fixo | 1 |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| CNPJ Instituição | CNPJ | Sim | GET https:// api.anbima.com.br/feed/fundos/v1/fundos-instituicao/22222222000122 |