Fundos

Fundos ICVM 555

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/fundos

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

Lista de campos:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanho
codigo_fundoCódigo ANBIMAChave de identificação do fundo na ANBIMAAlfanumérico – Comprimento fixo6
nome_fantasiaNome fantasia do fundoNome pelo qual o fundo é conhecidoAlfanumérico – Comprimento variável40
nome_fantasia_2Nome fantasia do fundoNome pelo qual o fundo é conhecidoAlfanumérico – Comprimento variável200
cnpj_fundoCNPJCNPJ do FundoAlfanumérico – Comprimento variável14
classe_anbimaClasse ANBIMAA 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ável20
situacao_atualSituação atual do FundoIndicador 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 fixo1
data_inicio_divulgacao_cotaData de início de divulgação de cotas do fundoRepresenta a primeira data de registro de série histórica (dados periódicos)DataYYYY-MM-DD
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contextoData/horaYYYY-MM-DD HH:MI:SS

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Páginapage=1NãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos?page=1
Quantidade de fundos por páginasize=1000NãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos?page=1&size=1000
Obs. 1: Se página e quantidade de registros não forem informados na consulta, por padrão são retornados os primeiros 1.000 fundos, ordenados pelo código do fundo, na página 0.
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 FeedInformaçãoDescriçãoInformação EsperadaTamanho
codigo_fundoCódigo ANBIMAChave de identificação do fundo na ANBIMAAlfanumérico – Comprimento fixo6
nome_fantasiaNome fantasia do fundoNome pelo qual o fundo é conhecidoAlfanumérico – Comprimento variável40
nome_fantasia_2Nome fantasia do fundoNome pelo qual o fundo é conhecidoAlfanumérico – Comprimento variável200
razao_socialRazão socialRazão social do fundoAlfanumérico – Comprimento variável150
cnpj_fundoCNPJCNPJ do FundoAlfanumérico – Comprimento variável14
codigo_isinISINModelo de International Securities Identification Number. Código para identificação dos fundos de investimento, fornecido pela B3, quando este é registrado na referida bolsa como ativoAlfanumérico – Comprimento variável12
data_primeiro_aporteData do primeiro aporte do fundoData em que foi feito o primeiro aporte no fundoDataYYYY-MM-DD
data_inicioData de inicio do
fundo
Data de inicio do fundoDataYYYY-MM-DD
classe_anbimaClasse ANBIMAA 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_anbimaTipo ANBIMAEste 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 ativosAlfanumérico – Comprimento variável 40
classe_cvmClasse CVMA 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_cvmSubclasse CVMA 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_fundoComposiçã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
benchmarkBenchmarkEste campo indica o índice de referência de desempenho do fundoAlfanumérico – Comprimento variável 20
investimento_exteriorInvestimento no exteriorIndica 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 555Alfanumérico – Comprimento variável [Até 100%, > 67%, Não se Aplica, Até 20 %, Até 40 %]20
credito_privadoCrédito privadoIndica 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 fixo20
tipo_investidorTipo de investidorRestriçã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_investidorCaracterística do investidorNo 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_aberturaCota de aberturaA 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 fixo1
permite_alavancagemFundo permite alavancagemO 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 fixo20
aberto_estatutariamenteAberto estatutariamenteOs 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 fixo1
tributacao_alvoTributação alvoIndica o tratamento tributário perseguido pelo fundo para efeito de cobrança de imposto de renda do cotistaAlfanumérico – Comprimento variável[Longo Prazo, Curto Prazo, Renda Variável, Indefinido, ND, Não Aplicável]50
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contextoData/horaYYYY-MM-DD HH:MI:SS
situacao_atualSituação atual do FundoIndicador 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 fixo1
multigestorMultigestorIndica se o fundo é multigestor (investe em outros fundos), espelho, feeder ou nenhuma das opçõesAlfanumérico – Comprimento variável20
aplicacao_automaticaAplicação automáticaIndica se o fundo permite que o cotista realize aplicações ou resgates automáticos de valores de suas contas no mesmoAlfanumérico – Comprimento variável20
foco_atuacaoFoco de atuaçãoIndica o principal foco de atuação do fundoAlfanumérico – Comprimento variável20
esgESG – 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 fixo1
fundo_adaptado_icvm_175Fundo Adaptado a CVM 175Informa 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 fixo1
data_fundo_adaptado_icvm_175Data do fundo adaptado a CVM 175Se o fundo já for adaptado a CVM 175, informada a data na qual ocorreuDataYYYY-MM-DD
responsabilidade_ltdaResponsabilidade LimitadaInforma se o fundo possui responsabilidade limitadaAlfanumérico – Comprimento variável50
previdenciaPrevidênciaCaso o fundo seja de Previdência, indica a modalidade a qual se trataAlfanumérico – Comprimento variável20
data_encerramento_fundoData de encerramento do fundoData 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”DataYYYY-MM-DD

Prestadores de Serviço

Este contexto é compreendido pelos diferentes prestadores de serviço de um fundo. Estes prestadores podem ser:

PrestadorDescrição
AdministradorResponsável por todos os serviços relacionados ao funcionamento e manutenção do fundo
GestorResponsável pela gestão dos ativos do fundo
DistribuidorResponsável pelo relacionamento e vendas para com o investidor final
CustodianteResponsável por manter e guardar os ativos do fundo de investimento
Controlador de AtivosResponsável pela execução dos processos ligados ao controle dos ativos, bem como os procedimentos contábeis
Controlador de PassivosResponsável pela execução dos processos ligados ao controle dos passivos, bem como os procedimentos contábeis

Lista de campos prestadores:

Campo FeedInformaçãoDescriçãoDomínio/ Informação EsperadaTamanho
nomeNome do Prestador de ServiçoEste campo informa o nome dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores.Alfanumérico – Comprimento variável40
cnpjCNPJ do Prestador de ServiçoEste campo informa o cnpj dos prestadores de serviço do fundo. Ele será retornado para todos os prestadoresAlfanumérico – Comprimento variável14
principalGestor principalIndica 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 FeedInformaçãoDescriçãoDomínio/ Informação EsperadaTamanho
unidadeUnidade 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 fixo1
cobra_taxa_performanceCobra taxa performanceTaxa 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 fixo1
taxa_performance_nao_padronizadaTaxa de performance não padronizada (regras)Este campo define quais as regras de cobrança de taxa de performance do fundoAlfanumérico – variável500
taxa_compostaTaxa compostaEste 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 fixo1
taxa_entradaTaxa de entradaTaxa cobrada no momento da aplicação de recursos no fundoAlfanumérico – Comprimento variável40
taxa_saidaTaxa de saídaTaxa cobrada sobre o valor do resgateAlfanumérico – Comprimento variável40
taxa_maximaTaxa 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.DecimalTamanho 23 com 6 casas decimais
taxa_administracaoTaxa de administraçãoPercentual da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa explicitada no regulamento.DecimalTamanho 23 com 6 casas decimais
taxa_fixaTaxa fixaInforma o percentual de taxa fixa do fundo, caso se aplique.Alfanumérico – Comprimento variável23
periodicidade_cobranca_taxa_performancePeriodicidade de cobrança da taxa de performanceInforma a periodicidade em que a taxa de performance é cobradaNumérico19
descricao_taxa_performanceDescrição da taxa performanceDetalhamento da taxa de performanceAlfanumérico – variável500
data_inicio_vigencia_taxa_admData de início de vigência da Taxa de AdministraçãoIndica quando a Taxa de Administração começou a ser praticadaData/horaYYYY-MM-DD HH:MI:SS
data_atualizacaoData de atualizaçãoData em que houve a última atualização do contextoData/horaYYYY-MM-DD HH:MI:SS
data_referenciaData de ReferênciaData a qual os valores apresentados se referemData/horaYYYY-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 FeedInformaçãoDescriçãoDomínio/ Informação EsperadaTamanho
prazo_emissao_cotasPrazo para emissão de cotasPrazo (em dias) para conversão das cotas para efeito de aplicação de recursosAlfanumérico – Comprimento variável40
prazo_pagamento_resgatePrazo pagamento resgatePrazo para pagamento do resgate solicitado, ou seja, o número de dias após a data de solicitação do resgateAlfanumérico – Comprimento variável40
prazo_conversao_resgatePrazo de conversão do resgatePrazo 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çãoAlfanumérico – Comprimento variável40
carencia_inicial_primeiro_resgateCarência inicial para 1º resgateIndica 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érico19
carencia_ciclicaCarencia 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érico19
aplicacao_inicial_minimaAplicação inicial mínimaRefere-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.Decimal18
aplicacao_adicional_minimaAplicação adicional mínimaRefere-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.Decimal18
resgate_minimoResgate mínimoRefere-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.Decimal18
saldo_minimo_aplicado_ao_fundoSaldo mínimo aplicado ao fundoRefere-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 fundoDecimal18
divulgacao_cotaPeriodicidade de divulgação de cotaIndica 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ável10
data_inicio_divulgacao_cotaData de início de divulgação de cotas do fundoRepresenta a primeira data de registro de dados periódicos do fundoDataYYYY-MM-DD
data_referenciaData de ReferênciaData a qual os valores apresentados se referemData/horaYYYY-MM-DD HH:MI:SS
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contextoData/horaYYYY-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 FeedInformaçãoDescriçãoDomínio/ Informação EsperadaTamanho
urlURL do DocumentoEndereço eletrônico do arquivoAlfanumérico – Comprimento variável500
extensaoExtensão do DocumentoAs extensões de arquivos são sufixos que designam seu formato. Exemplos: txt, doc, pdf, exe, etc.Alfanumérico – Comprimento variável50
codigo_fundoCódigo ANBIMAChave de identificação do fundo na ANBIMAAlfanumérico – Comprimento fixo6
tipo_documentoTipo de DocumentoInforma o tipo de documento a qual o arquivo se refere. Exemplos: Regulamento, Auditoria, Assembleia, etc.Alfanumérico – Comprimento variável100
data_uploadData do UploadData em que o documento foi anexado ao fundoDataYYYY-MM-DD
data_referenciaData de ReferênciaData a qual os valores apresentados se referemData/horaYYYY-MM-DD HH:MI:SS
nome_arquivoNome do ArquivoNome do arquivoAlfanumérico – Comprimento variável255

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Código ANBIMAcodigoFundoSimGET  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 FeedInformaçãoDescriçãoDomínio/ Informação EsperadaTamanho
patrimonio_liquidoPatrimônio Líquido do FundoInforma 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.Decimal14
valor_cotaValor da Cota do FundoValor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo.Decimal17
captacaoCaptação (novos aportes)Valor total de novos aportes no fundo até a última data de registroDecimal14
resgateResgates (novos saques)Soma dos valores resgatados por cotistas e dos resgates de IRDecimal14
resgate_detalhamentoDetalhes dos resgatesDetalhe dos resgates realizadosObjeto JSON
numero_cotistasNúmero de CotistasNúmero total de investidores do fundoNumérico10
data_referenciaData de ReferênciaData a qual os valores apresentados se referemData/horaYYYY-MM-DD HH:MI:SS
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contextoData/horaYYYY-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 FeedInformaçãoTipo/TamanhoDescrição
resgates_irValor do IRNumérico (14)Valor do resgate do imposto de renda
resgates_cotistaValor 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/historico

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/historico

Lista de campos:

Campo FeedInformaçãoDescriçãoDomínio/ Informação EsperadaTamanho
descricaoDescriçãoTexto descritivo dos arquivos do fundoAlfanumérico – Comprimento variável
nomeNome do arquivoData em que a nota explicativa foi geradaAlfanumérico – Comprimento variável
dataData de referênciaAno correspondente da nota explicativaDataYYYY-MM-DD
urlURL do DocumentoEndereço eletrônico do arquivoAlfanumérico – Comprimento variável

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta

data
YYYY-MM-DDNãoGET 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 ArquivoFormato do nomeExemplo
anmovcotnome_data_hora_pacotedefundoanmovcot_20240115_175033_555.txt
anstatusnome_data_hora_pacotedefundoanstatus_20240115_175033_555.txt
anvlmesnome_data_hora_pacotedefundoanvlmes_20240115_175033_555.txt
cbtiponome_data_hora_pacotedefundocbtipo_20240115_175033_555.txt

Arquivo anmovcot:

A seguir o layout dos arquivos anmovcot

CampoFormatoDescrição
codigo_fundoNumérico 6 dígitos fixosCódigo do Fundo
data_referenciadd/mm/aaaa hh:mm:ssData de início de vigência para regra de movimentação do fundo.
aplicacao_inicial_minimaDecimal – Precisão 18/5
Exportação truncada em 2 casas
Valor mínimo para aplicação inicial 
aplicacao_adicional_minimaDecimal – Precisão 18/5
Exportação truncada em 2 casas
Valor mínimo para aplicação adicional 
resgate_minimoDecimal – Precisão 18/5
Exportação truncada em 2 casas
Valor mínimo para resgate do fundo 
saldo_minimo_aplicadoDecimal – Precisão 18/5
Exportação truncada em 2 casas
Valor mínimo de aplicação 
identificadorAlfanumérico 2 posiçõesIdentifica 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

CampoFormatoDescrição
codigo_fundoNumérico 6 dígitos fixosCódigo do Fundo
statusAlfanumérico até 40 posiçõesDiversos
opcoes_statusAlfanumérico até 20 posiçõesDiversos
datainidd/mm/aaaa hh:mm:ssData de inicio de vigência do status do fundo 
datafimdd/mm/aaaa hh:mm:ssData 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

CampoFormatoDescrição
codigo_fundoNumérico 6 dígitos fixosCódigo do Fundo
mesNumérico 2 dígitos fixoInforma o mês da data da informação
anoNumérico 4 dígitos fixoInforma o ano da data da informação
patrimonio_liquidoDecimal – Precisão 14/2 separado por vírgulaData de inicio de vigência do status do fundo 
valor_cotaDecimal – Precisão 17/9 separado por vírgulaData de fim de vigência do status do fundo. Caso este status esteja vigente, este campo é vazio. 
rentmesDecimal – Precisão 13/7Rentabilidade acumulada do fundo no mês 
rentanoDecimal – Precisão 13/7Rentabilidade acumulada do fundo no ano 
codtipoNumérico até 4 dígitosCódigo do tipo de fundo 

Arquivo cbtipo:

A seguir o layout dos arquivos cbtipo

CampoFormatoDescrição
codtipoNumérico até 4 dígitosCódigo do tipo de fundo 
descricaoAlfanumérico até 40 posiçõesDescrição do tipo de fundo 
siglaAlfanumérico até 6 posiçõesSigla do tipo de fundo
datainidd/mm/aaaa hh:mm:ssData de inicio de vigência do tipo de fundo 
datafimdd/mm/aaaa hh:mm:ssData 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-explicativas

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}/notas-explicativas

Lista de campos:

Campo FeedInformaçãoDescriçãoDomínio/ Informação EsperadaTamanho
descricaoDescriçãoTexto da nota explicativaAlfanumérico – Comprimento variável80
data_referenciaData de referênciaData em que a nota explicativa foi geradaData/horaYYYY-MM-DD HH:MI:SS
ano_divulgacaoAnoAno correspondente da nota explicativaAlfanumérico – Comprimento variável4

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Código ANBIMAcodigoFundoSimGET  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-historica

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}/serie-historica

Lista de campos:

Campo FeedInformaçãoDescriçãoDomínio/ Informação EsperadaTamanho
patrimonio_liquidoPatrimônio Líquido do FundoInforma 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çãoDecimal14
valor_cotaValor da Cota do FundoValor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundoDecimal17
captacaoCaptação (novos aportes)Valor total de novos aportes no fundo até a última data de registroDecimal14
resgateResgates (novos saques)Soma dos valores resgatados por cotistas e dos resgates de IRDecimal14
resgate_detalhamentoDetalhes dos resgatesDetalhe dos resgates realizadosObjeto JSON
numero_cotistasNúmero de CotistasNúmero total de investidores do fundoNumérico10
data_referenciaData de ReferênciaData a qual os valores apresentados se referemData/horaYYYY-MM-DD HH:MI:SS
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contextoData/horaYYYY-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 FeedInformaçãoTipo/TamanhoDescrição
resgates_irValor do IRNumérico (14)Valor do resgate do imposto de renda
resgates_cotistaValor dos resgates de
cotistas
Numérico (14)Valor de resgates realizados pelos
cotistas 

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Código ANBIMAcodigoFundoSimGET https:// api.anbima.com.br/feed/fundos/v1/fundos/546356/serie-historica
Data inicial da consultadata-inicio=yyyy-MM-ddNãoGET 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 consultadata-fim=yyyy-MM-ddNãoGET https://api.anbima.com.br/feed/fundos/v1/fundos/546356/serie-historica?data-inicio=2019-11-19&data-fim=2020-11-14
Obs. 1: Se data início e fim não forem determinadas na consulta, serão retornados os registros dos últimos 5 anos.
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-instituicao

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

Lista de campos:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanho
nomeNome fantasia do fundoNome pelo qual o fundo é conhecidoAlfanumérico – Comprimento variável40
cnpjCNPJCNPJ do fundoAlfanumérico – Comprimento variável14
instituicao_primariaS/NInforma se a instituição é primária.
S = Sim
N – Não
Alfanumérico – Comprimento fixo1

Lista de campos instituicoes_secundarias :

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanho
nomeNome fantasia do fundoNome pelo qual o fundo é conhecidoAlfanumérico – Comprimento variável40
cnpjCNPJCNPJ do fundoAlfanumérico – Comprimento variável14
instituicao_primariaS/NInforma se a instituição é primária.
S = Sim
N – Não
Alfanumérico – Comprimento fixo1

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Páginapage=1NãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-instituicao?page=1
Quantidade de fundos por páginasize=1000NãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-instituicao?page=1&size=1000
Obs. 1: Se página e quantidade de registros não forem informados na consulta, por padrão são retornados os primeiros 1.000 resultados, ordenados pelo nome da instituição, na página 0.
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 FeedInformaçãoDescriçãoInformação EsperadaTamanho
nomeNome fantasia do fundoNome pelo qual o fundo é conhecidoAlfanumérico – Comprimento variável40
cnpjCNPJCNPJ do fundoAlfanumérico – Comprimento variável14
instituicao_primariaS/NInforma se a instituição é primária.
S = Sim
N – Não
Alfanumérico – Comprimento fixo1

Lista de campos instituicoes_secundarias :

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanho
nomeNome fantasia da Instituição primáriaNome pelo qual a instituição é conhecidoAlfanumérico – Comprimento variável40
cnpjCNPJCNPJ da InstituiçãoAlfanumérico – Comprimento variável14
instituicao_primariaS/NInforma se a instituição é primária.
S = Sim
N – Não
Alfanumérico – Comprimento fixo1

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
CNPJ InstituiçãoCNPJSimGET https:// api.anbima.com.br/feed/fundos/v1/fundos-instituicao/22222222000122