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
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 |
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 URI:
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 |
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 |
código_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_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 |
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 |
sub_classe_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 |
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 |
previdencia | Previdência | Caso o fundo seja de Previdência, indica a modalidade a qual se trata | 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_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
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:
| 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 – Comprimento variável | 500 |
periodicidade_cobranca_taxa_performance | Period. de cobrança da taxa de performance | Informa a periodicidade em que a taxa de performance é cobrada | Numérico | 19 |
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 | 23 |
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 | 23 |
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 |
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 | 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 | 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_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
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 |
numero_cotistas | Número de Cotistas | Número total de investidores do fundo | Numérico | 10 |
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 |
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 |
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} |
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 URI:
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).
Para acessá-la, deve-se utilizar a seguinte URI:
https://[ambiente]/feed/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/v1/fundos/{codigoFundo}/serie-historicaLista de campos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
numero_cotistas | Número de Cotistas | Número total de investidores do fundo | Numérico | 10 |
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 |
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 |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Código ANBIMA | {codigoFundo} | Sim | GET https:// api.anbima.com.br/feed/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 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-estruturadosO 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-estruturadosLista de campos fundo:
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
cnpj_fundo | CNPJ | CNPJ do Fundo. | Alfanumérico – Comprimento variável | 14 | FIDC FII FIP |
razao_social | Razão Social | Razão Social do Fundo. | Alfanumérico – Comprimento variável | 150 | FIDC FII FIP |
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: – FIDC – FII – FIP | Alfanumérico – Comprimento variável | 20 | FIDC FII FIP |
Lista de campos classes_serie_cota:
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
nome_fantasia | Nome Fantasia | Nome pelo qual o fundo é conhecido. | Alfanumérico – Comprimento variável | 40 | FIDC FII FIP |
tipo_classe_cota | Tipo Classe de Cota | Informa 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ável | 15 | FIDC FII FIP |
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 | FIDC FII FIP |
situacao_atual | Situação atual do Fundo | Indicador sobre o status atual quanto à novos aportes. Os possíveis valores para este campo são: A = Ativo E = Encerrado | Alfanumérico – Comprimento fixo | 1 | FIDC FII FIP |
data_encerramento | 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 | FIDC FII FIP |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto. | Data/hora | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Classe ANBIMA | classe-anbima=FIP classe-anbima=FII classe-anbima=FIDC | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?classe-anbima=FIP&classe-anbima=FII |
| Página | page=1 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?page=1 |
| Quantidade de fundos por página | size=1000 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?page=1&size=300 |
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 Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
cnpj_fundo | CNPJ | CNPJ do Fundo. | Alfanumérico – Comprimento variável | 14 | FIDC FII FIP |
razao_social | Razão Social | Razão Social do Fundo. | Alfanumérico – Comprimento variável | 150 | FIDC FII FIP |
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: – FIDC – FII – FIP | Alfanumérico – Comprimento variável | 20 | FIDC FII FIP |
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 | FIDC FII FIP |
categoria_anbima | Categoria ANBIMA | Neste nível os fundos são classificados conforme o tipo de gestão. | Alfanumérico – Comprimento variável | 20 | FIDC FII |
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 | 40 | FIDC FII FIP |
classe_cvm | Classe CVM | Este campo informa a qual classe CVM o fundo faz parte. | Alfanumérico – Comprimento variável | 20 | FIDC FII |
foco_atuacao | Foco de Atuação | Indica o principal foco de atuação do fundo. | Alfanumérico – Comprimento variável | 20 | FIDC FII |
prazo_duracao | Prazo de duração do Fundo | Informa o prazo de duração do fundo caso ele seja determinado. | Alfanumérico – Comprimento variável | 50 | FIDC FII |
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 | FIDC FII FIP |
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 | FIDC FII |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto. | Data/hora | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Lista de campos classes_serie_cota:
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
codigo_anbima | Código ANBIMA | Chave de identificação da classe/série de cota do fundo na ANBIMA. | Alfanumérico – Comprimento fixo | 6 | FIDC FII FIP |
nome_fantasia | Nome Fantasia | Nome pelo qual o fundo é conhecido. | Alfanumérico – Comprimento variável | 40 | FIDC FII FIP |
tipo_classe_cota | Tipo Classe de Cota | Informa 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ável | 15 | FIDC FII FIP |
data_primeiro_aporte | Data do Primeiro Aporte no Fundo | Data em que foi feito o primeiro aporte no fundo. | Data | YYYY-MM-DD | FIDC FII FIP |
data_inicio_divulgacao_cota | Data Início de Divulgação de Cota | Representa a primeira data de registro de série histórica (dados periódicos) da classe de cota do fundo. | Data | YYYY-MM-DD | FIDC FII FIP |
data_encerramento | Data de Encerramento do Fundo | Data 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”. | Data | YYYY-MM-DD | FIDC FII FIP |
situacao_atual | Situação atual do Fundo | Indicador sobre o status atual quanto à novos aportes. Os possíveis valores para este campo são: A = Ativo E = Encerrado | Alfanumérico – Comprimento fixo | 1 | FIDC FII FIP |
restrito | Restrito? | Informa se este fundo é restrito, ou seja, se possui limitação para a quantidade de cotistas que podem aportar capital. | Alfanumérico – Comprimento variável | 20 | FIDC FII FIP |
investidor_qualificado | Investidor 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ável | 1 | FIDC FII FIP |
benchmark | Benchmark | Este campo indica o índice de referência de desempenho do fundo. | Alfanumérico – Comprimento variável | 20 | FIP |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto. | Data/hora | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Prestadores de Serviço
Este contexto (prestadores) é compreendido pelos diferentes prestadores de serviço de um fundo estruturado. Estes prestadores podem ser:
| Prestador | Descrição | Classe ANBIMA |
| Administrador | Responsável por todos os serviços relacionados ao funcionamento e manutenção do fundo. | FIDC FII FIP |
| Gestor | Responsável pela gestão dos ativos do fundo. | FIDC FII FIP |
| Custodiante | Responsável por manter e guardar os ativos do fundo. | FIDC FII FIP |
| Controlador de Ativos | Responsável pela execução dos processos ligados ao controle dos ativos, bem como os procedimentos contábeis. | FIDC FII FIP |
| Controlador de Passivos | Responsável pela execução dos processos ligados ao controle dos passivos, bem como os procedimentos contábeis. | FIDC FII |
| Auditor Independente | Responsá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 Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
nome | Nome do Prestador de Serviço | Este campo informa o nome fantasia dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores. | Alfanumérico – Comprimento variável | 40 | FIDC FII FIP |
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 | FIDC FII FIP |
principal | Gestor Principal | Indica se este prestador é o principal gestor do fundo. | Boolean (TRUE, FALSE) | 1 | FIDC 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 Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
data_referencia | Data de Referência | Data de referência das taxas e informações apresentadas. | Data | YYYY-MM-DD | FIDC FII FIP |
unidade_taxa_adm | 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 | FIDC FII |
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 | 23 | FIDC FII FIP |
unidade_tempo_taxa_adm | Unidade de Tempo da Taxa de Administração | Informa a unidade de tempo em que a taxa de administração é definida. | Alfanumérico – Comprimento variável | 6 | FIDC FII |
base_calculo_taxa_adm | Base para Cálculo da Taxa de Administração | Informa qual a base para cálculo da taxa de administração. | Alfanumérico – Comprimento variável | 30 | FIDC FII |
metodologia_calculo_taxa_adm | Metodologia para o Cálculo da Taxa de Administração | Informa a metodologia utilizada no cálculo da taxa de cobrança. | Alfanumérico – Comprimento variável | 30 | FIDC FII |
periodicidade_cobranca_taxa_adm | Periodicidade de Cobrança da Taxa de Administração | Indica a periodicidade de cobrança da taxa de administração. | Alfanumérico – Comprimento variável | 15 | FIDC FII |
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 | YYYY-MM-DD | FIDC FII FIP |
cobra_taxa_performance | Cobra 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 fixo | 1 | FIDC FII FIP |
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 | FIDC FII FIP |
descricao_taxa_performance | Descrição da Taxa de Performance | Descreve como ocorre a cobrança de taxa de performance. | Alfanumérico – Comprimento variável | 200 | FIDC FII FIP |
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 – Comprimento variável | 500 | FIDC FII FIP |
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 | FIDC FII FIP |
taxa_fixa | Taxa Fixa | Informa o percentual de taxa fixa do fundo, caso se aplique. | Alfanumérico – Comprimento variável | 23 | FIDC FII FIP |
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 | 23 | FIDC FII FIP |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto. | Data/hora | YYYY-MM-DD HH:MI:SS | FIDC 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 Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
periodicidade_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. | Alfanumérico – Comprimento variável | 15 | FIDC FII FIP |
saldo_minimo_aplicado_ao_fundo | Saldo Mínimo Aplicado ao Fundo | Valor mínimo para permanência no fundo. | Decimal | 13 | FIDC FII FIP |
aplicacao_inicial_minima | Aplicação Inicial Mínima | Mínimo de aporte aceito para ingresso no fundo. | Decimal | 18 | FIDC FII FIP |
aplicacao_adicional_minima | Aplicação Adicional Mínima | Mínimo aceito para aplicações posteriores no fundo. | Decimal | 18 | FIDC FII FIP |
resgate_minimo | Resgate Mínimo | Valor mínimo aceito para retirada de recursos do fundo. | Decimal | 18 | FIDC FII FIP |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto. | Data/hora | YYYY-MM-DD HH:MI:SS | FIDC 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 Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
data_referencia | Data de Referência | Data de referência das taxas e informações apresentadas. | Data | YYYY-MM-DD | FIDC FII FIP |
patrimonio_liquido | Patrimônio Líquido | Informa 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. | Decimal | 14 | FIDC FII FIP |
valor_cota | Valor da Cota | Valor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo. | Decimal | 17 | FIDC FII FIP |
captacao | Captação (novos aportes) | Valor total de novos aportes até a última data de registro. | Decimal | 14 | FIDC FII FIP |
resgate | Resgates (novos saques) | Soma dos valores resgatados por cotistas e dos resgates de IR. | Decimal | 14 | FIDC FII FIP |
numero_cotistas | Número de Cotistas | Número total de investidores. | Numérico | 5 | FIDC FII FIP |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto. | Data/hora | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| CNPJ | {CNPJ} | Sim | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762} |
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-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-estruturados/{CNPJ}/serie-historicaLista de campos classes_series_cotas:
| Campo Feed | Informação | Descrição | Informação Esperada | Tamanho | Classe ANBIMA |
codigo_anbima | Código ANBIMA | Chave de identificação da classe/série de cota do fundo na ANBIMA. | Alfanumérico – Comprimento fixo | 6 | FIDC FII FIP |
data_referencia | Data de Referência | Data de referência das taxas e informações apresentadas. | Data | YYYY-MM-DD | FIDC FII FIP |
patrimonio_liquido | Patrimônio Líquido | Informa 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. | Decimal | 14 | FIDC FII FIP |
valor_cota | Valor da Cota | Valor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo. | Decimal | 17 | FIDC FII FIP |
captacao | Captação (novos aportes) | Valor total de novos aportes até a última data de registro. | Decimal | 14 | FIDC FII FIP |
resgate | Resgates (novos saques) | Soma dos valores resgatados por cotistas e dos resgates de IR. | Decimal | 14 | FIDC FII FIP |
numero_cotistas | Número de Cotistas | Número total de investidores. | Numérico | 5 | FIDC FII FIP |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto. | Data/hora | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| CNPJ | {CNPJ} | Sim | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/serie-historica |
| Data inicial da consulta | data-inicio=yyyy-MM-dd | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/serie-historica?data-inicio=2019-11-19 |
| Data final da consulta | data-fim=yyyy-MM-dd | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/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: 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’.