Fundos

APIs de Fundos

Fundos Estruturados

Lista Completa de Fundos

Esta API divulga a lista completa de fundos estruturados (FIDC, FII e FIP) e suas respectivas classes/séries de cota 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 300 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-estruturados

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-estruturados

Lista de campos fundo:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
cnpj_fundoCNPJCNPJ do Fundo.Alfanumérico – Comprimento variável14FIDC
FII
FIP
razao_socialRazão SocialRazão Social do Fundo.Alfanumérico – Comprimento variável150FIDC
FII
FIP
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:
– FIDC
– FII
– FIP
Alfanumérico – Comprimento variável20FIDC
FII
FIP

Lista de campos classes_serie_cota:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
codigo_anbimaCódigo ANBIMAChave de identificação da classe/série de cota do fundo na ANBIMA.Alfanumérico – Comprimento fixo6
FIDC
FII
FIP
nome_fantasiaNome FantasiaNome pelo qual o fundo é conhecido.Alfanumérico – Comprimento variável40FIDC
FII
FIP
tipo_classe_cotaTipo Classe de CotaInforma a classe de cota do fundo estruturado a qual os dados se referem. Exemplo: Sênior, Mezanino, Subordinada, 1, 2, A, B, etc.Alfanumérico – Comprimento variável15FIDC
FII
FIP
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-DDFIDC
FII
FIP
situacao_atualSituação atual do FundoIndicador sobre o status atual quanto à novos aportes. Os possíveis valores para este campo são:
A = Ativo
E = Encerrado
Alfanumérico – Comprimento fixo1FIDC
FII
FIP
data_encerramentoData 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-DDFIDC
FII
FIP
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contexto.Data/horaYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Classe ANBIMAclasse-anbima=FIP classe-anbima=FII classe-anbima=FIDCNãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?classe-anbima=FIP&classe-anbima=FII
Páginapage=1NãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?page=1
Quantidade de fundos por páginasize=1000NãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?page=1&size=300
Obs. 1: Se página e quantidade de registros não forem informados na consulta, por padrão são retornados os primeiros 300 fundos, ordenados pelo código do fundo, na página 0.
Obs. 2: A quantidade máxima de registros por página é 300.

Detalhes do Fundo

Esta API divulga os dados detalhados de um fundo estruturado e de suas respectivas classes/séries de cota.

Para acessá-la, deve-se utilizar a seguinte URI:

https://[ambiente]/feed/fundos/v1/fundos-estruturados/{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/{CNPJ}

As informações presentes nesta API são divididas nos seguintes contextos:

Dados Cadastrais

Este contexto (dados-cadastrais) é compreendido pelos dados básicos de identificação de um fundo.

Lista de campos fundo:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
cnpj_fundoCNPJCNPJ do Fundo.Alfanumérico – Comprimento variável14FIDC
FII
FIP
razao_socialRazão SocialRazão Social do Fundo.Alfanumérico – Comprimento variável150FIDC
FII
FIP
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:
– FIDC
– FII
– FIP
Alfanumérico – Comprimento variável20FIDC
FII
FIP
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 ativos.Alfanumérico – Comprimento variável40FIDC
FII
FIP
categoria_anbimaCategoria ANBIMANeste nível os fundos são classificados conforme o tipo de gestão.Alfanumérico – Comprimento variável20FIDC
FII
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ável40FIDC
FII
FIP
classe_cvmClasse CVMEste campo informa a qual classe CVM o fundo faz parte.Alfanumérico – Comprimento variável20FIDC
FII
foco_atuacaoFoco de AtuaçãoIndica o principal foco de atuação do fundo.Alfanumérico – Comprimento variável20FIDC
FII
prazo_duracaoPrazo de duração do FundoInforma o prazo de duração do fundo caso ele seja determinado.Alfanumérico – Comprimento variável50FIDC
FII
cota_aberturaCota 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 fixo1FIDC
FII
FIP
tributacao_alvoTributação AlvoIndica 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]
50FIDC
FII
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contexto.Data/horaYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Lista de campos classes_serie_cota:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
codigo_anbimaCódigo ANBIMAChave de identificação da classe/série de cota do fundo na ANBIMA.Alfanumérico – Comprimento fixo6FIDC
FII
FIP
nome_fantasiaNome FantasiaNome pelo qual o fundo é conhecido.Alfanumérico – Comprimento variável40FIDC
FII
FIP
tipo_classe_cotaTipo Classe de CotaInforma a classe de cota do fundo estruturado a qual os dados se referem. Exemplo: Sênior, Mezanino, Subordinada, 1, 2, A, B, etc.Alfanumérico – Comprimento variável15FIDC
FII
FIP
data_primeiro_aporteData do Primeiro Aporte no FundoData em que foi feito o primeiro aporte no fundo.DataYYYY-MM-DDFIDC
FII
FIP
data_inicio_divulgacao_cotaData Início de Divulgação de CotaRepresenta a primeira data de registro de série histórica (dados periódicos) da classe de cota do fundo.DataYYYY-MM-DDFIDC
FII
FIP
data_encerramentoData de Encerramento do FundoData em 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-DDFIDC
FII
FIP
situacao_atualSituação atual do FundoIndicador sobre o status atual quanto à novos aportes. Os possíveis valores para este campo são:
A = Ativo
E = Encerrado
Alfanumérico – Comprimento fixo1FIDC
FII
FIP
restritoRestrito?Informa se este fundo é restrito, ou seja, se possui limitação para a quantidade de cotistas que podem aportar capital.Alfanumérico – Comprimento variável20FIDC
FII
FIP
investidor_qualificadoInvestidor Qualificado?Informa se este fundo permite apenas investidores qualificados. Os possíveis valores para este campo são:
S = Sim
N = Não
Alfanumérico – Comprimento variável1FIDC
FII
FIP
benchmarkBenchmarkEste campo indica o índice de referência de desempenho do fundo.Alfanumérico – Comprimento variável20FIP
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contexto.Data/horaYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Prestadores de Serviço

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

PrestadorDescriçãoClasse ANBIMA
AdministradorResponsável por todos os serviços relacionados ao funcionamento e manutenção do fundo.FIDC
FII
FIP
GestorResponsável pela gestão dos ativos do fundo.FIDC
FII
FIP
CustodianteResponsável por manter e guardar os ativos do fundo.FIDC
FII
FIP
Controlador de AtivosResponsável pela execução dos processos ligados ao controle dos ativos, bem como os procedimentos contábeis.FIDC
FII
FIP
Controlador de PassivosResponsável pela execução dos processos ligados ao controle dos passivos, bem como os procedimentos contábeis.FIDC
FII
Auditor IndependenteResponsável por analisar as contas e as operações do fundo e, de forma independe, emitir um parecer.FIDC
FII

Lista de campos fundo:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
nomeNome do Prestador de ServiçoEste campo informa o nome fantasia dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores.Alfanumérico – Comprimento variável40FIDC
FII
FIP
cnpjCNPJ do Prestador de ServiçoEste campo informa o CNPJ dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores.Alfanumérico – Comprimento variável14FIDC
FII
FIP
principalGestor PrincipalIndica se este prestador é o principal gestor do fundo.Boolean (TRUE, FALSE)1FIDC
FII
FIP

Taxas

Aqui são detalhadas as informações referentes às taxas aplicadas em um fundo. Trazemos aqui os dados atuais (taxas) e a lista com o histórico de alterações de taxas (historico_taxas).

Lista de campos fundo:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
data_referenciaData de ReferênciaData de referência das taxas e informações apresentadas.DataYYYY-MM-DDFIDC
FII
FIP
unidade_taxa_admUnidade 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 fixo1FIDC
FII
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.Decimal23FIDC
FII
FIP
unidade_tempo_taxa_admUnidade de Tempo da Taxa de AdministraçãoInforma a unidade de tempo em que a taxa de administração é definida.Alfanumérico – Comprimento variável6FIDC
FII
base_calculo_taxa_admBase para Cálculo da Taxa de AdministraçãoInforma qual a base para cálculo da taxa de administração.Alfanumérico – Comprimento variável30FIDC
FII
metodologia_calculo_taxa_admMetodologia para o Cálculo da Taxa de AdministraçãoInforma a metodologia utilizada no cálculo da taxa de cobrança.Alfanumérico – Comprimento variável30FIDC
FII
periodicidade_cobranca_taxa_admPeriodicidade de Cobrança da Taxa de AdministraçãoIndica a periodicidade de cobrança da taxa de administração.Alfanumérico – Comprimento variável15FIDC
FII
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 praticada.DataYYYY-MM-DDFIDC
FII
FIP
cobra_taxa_performanceCobra Taxa de 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 fixo1FIDC
FII
FIP
periodicidade_cobranca_taxa_performancePeriodicidade de Cobrança da Taxa de PerformanceInforma a periodicidade em que a taxa de performance é cobrada.Numérico19FIDC
FII
FIP
descricao_taxa_performanceDescrição da Taxa de PerformanceDescreve como ocorre a cobrança de taxa de performance.Alfanumérico – Comprimento variável200FIDC
FII
FIP
taxa_performance_nao_padronizadaTaxa de Performance não Padronizada (regras)Este campo define quais as regras de cobrança de taxa de performance do fundo.Alfanumérico – Comprimento variável500FIDC
FII
FIP
taxa_compostaTaxa 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 fixo1FIDC
FII
FIP
taxa_fixaTaxa FixaInforma o percentual de taxa fixa do fundo, caso se aplique.Alfanumérico – Comprimento variável23FIDC
FII
FIP
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.Decimal23FIDC
FII
FIP
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contexto.Data/horaYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Movimentação de Cotas

Este contexto (movimentacao) é compreendido pelas informações de aportes, resgates e demais movimentações de cotas em um fundo.

Lista de campos classes_series_cotas:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
periodicidade_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.Alfanumérico – Comprimento variável15FIDC
FII
FIP
saldo_minimo_aplicado_ao_fundoSaldo Mínimo Aplicado ao FundoValor mínimo para permanência no fundo.Decimal13FIDC
FII
FIP
aplicacao_inicial_minimaAplicação Inicial MínimaMínimo de aporte aceito para ingresso no fundo.Decimal18FIDC
FII
FIP
aplicacao_adicional_minimaAplicação Adicional MínimaMínimo aceito para aplicações posteriores no fundo.Decimal18FIDC
FII
FIP
resgate_minimoResgate MínimoValor mínimo aceito para retirada de recursos do fundo.Decimal18FIDC
FII
FIP
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contexto.Data/horaYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Série Histórica da Classe/Série de Cota do Fundo

Este contexto (serie-historica) apresenta os dados periódicos (PL e cota) das classes/séries de cota de um fundo na última data disponível. Para calcular os valores referentes ao fundo como um todo, basta somar os valores dos campos de todas as séries/classes de cota.

Lista de campos classes_series_cotas:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
data_referenciaData de ReferênciaData de referência das taxas e informações apresentadas.DataYYYY-MM-DDFIDC
FII
FIP
patrimonio_liquidoPatrimônio LíquidoInforma o patrimônio líquido 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, inclusive aquelas relativas à sua administração.Decimal14FIDC
FII
FIP
valor_cotaValor da CotaValor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo.Decimal17FIDC
FII
FIP
captacaoCaptação (novos aportes)Valor total de novos aportes até a última data de registro.Decimal14FIDC
FII
FIP
resgateResgates (novos saques)Soma dos valores resgatados por cotistas e dos resgates de IR.Decimal14FIDC
FII
FIP
numero_cotistasNúmero de CotistasNúmero total de investidores.Numérico5FIDC
FII
FIP

data_atualizacao
Data de AtualizaçãoData em que houve a última atualização do contexto.Data/horaYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
CNPJCNPJSimGET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/34271171000762
Obs.: Se for informada uma quantidade menor do que 14 dígitos no parâmetro de CNPJ, o sistema completará com zeros a esquerda a quantidade de dígitos faltantes para realizar a consulta.

Série Histórica da Classe/Série de Cota do Fundo

Esta API divulga exibe uma lista com todo o histórico (diário) de dados periódicos (PL e cota) das classes/séries de cota do fundo.

Para calcular os valores referentes ao fundo como um todo, basta somar os valores dos campos de todas as séries/classes de cota na data específica.

Para acessá-la, deve-se utilizar a seguinte URL:

https://[ambiente]/feed/fundos/v1/fundos-estruturados/{CNPJ}/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-estruturados/{CNPJ}/serie-historica

Lista de campos classes_series_cotas:

Campo FeedInformaçãoDescriçãoInformação EsperadaTamanhoClasse ANBIMA
codigo_anbimaCódigo ANBIMAChave de identificação da classe/série de cota do fundo na ANBIMA.Alfanumérico – Comprimento fixo6FIDC
FII
FIP
data_referenciaData de ReferênciaData de referência das taxas e informações apresentadas.DataYYYY-MM-DDFIDC
FII
FIP
patrimonio_liquidoPatrimônio LíquidoInforma o patrimônio líquido 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, inclusive aquelas relativas à sua administração.Decimal14FIDC
FII
FIP
valor_cotaValor da CotaValor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo.Decimal17FIDC
FII
FIP
captacaoCaptação (novos aportes)Valor total de novos aportes até a última data de registro.Decimal14FIDC
FII
FIP
resgateResgates (novos saques)Soma dos valores resgatados por cotistas e dos resgates de IR.Decimal14FIDC
FII
FIP
numero_cotistasNúmero de CotistasNúmero total de investidores.Numérico5FIDC
FII
FIP
data_atualizacaoData de AtualizaçãoData em que houve a última atualização do contexto.Data/horaYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
CNPJCNPJSimGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/34271171000762/serie-historica
Data inicial da consultadata-inicio=yyyy-MM-ddNãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/34271171000762/serie-historica?data-inicio=2019-11-19
Data final da consultadata-fim=yyyy-MM-ddNãoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/34271171000762/serie-historica ?data-inicio=2019-11-19&data-fim=2020-11-14
Obs.1: Se for informada uma quantidade menor do que 14 dígitos no parâmetro de CNPJ, o sistema completará com zeros a esquerda a quantidade de dígitos faltantes para realizar a consulta.
Obs.2: O período máximo permitido por consulta será de 5 anos (60 meses).
Obs.3: Se data início e fim não forem determinadas na consulta, serão retornados os registros dos últimos 5 anos.
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).
Obs.6: Caso o período informado na consulta ultrapasse o range de 5 anos, será retornado um erro ‘400 Bad Request’.