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 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 |
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 |
nome_fantasia_2 | Nome Fantasia | Nome pelo qual o fundo é conhecido. | Alfanumérico – Comprimento variável | 200 | 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 URL:
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-estruturados/{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 FIP |
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 |
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 | FIDC 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 |
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 |
esg | ESG – Environmental, Social and Governance (Ambiental, Social e Governança Corporativa) | Indica se o fundo segue as práticas ESG. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Relacionado (R) | Alfanumérico – Comprimento fixo | 1 | FIDC |
entidade_investimento_fins_tributarios | Entidade de investimento para fins tributários | Campo referente a tributação da lei 4.173. Os possíveis valores para o campo são: Sim Não Não se aplica | Alfanumérico – Comprimento variável | 50 | FIDC FIP |
95_por_cento_fundo_isento | 95% em fundos isentos de come-cotas | Campo referente a tributação da lei 4.173. Os possíveis valores para o campo são: Sim Não | Alfanumérico – Comprimento variável | 50 | FIDC FIP |
Lista de campos classe_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 |
nome_fantasia_2 | Nome Fantasia | Nome pelo qual o fundo é conhecido. | Alfanumérico – Comprimento variável | 200 | 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 | Data de inicio do fundo | Data de inicio do 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 |
isin | Código Isin do título | 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 | FIDC FII FIP |
fundo_adaptado_icvm_175 | Fundo Adaptado a CVM 175 | Informa que o fundo está adaptado a CVM 175. Os possíveis valores para o campo são: S = Sim N = Não | Alfanumérico – Comprimento fixo | 1 | FIDC FII FIP |
data_fundo_adaptado_icvm_175 | Data do fundo adaptado a CVM 175 | Se o fundo já for adaptado a CVM 175, informada a data na qual ocorreu | Data | YYYY-MM-DD | FIDC FII FIP |
responsabilidade_ltda | Responsabilidade Limitada | Informa se o fundo possui responsabilidade limitada | Alfanumérico – Comprimento variável | 50 | 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 | Tamanho 23 com 6 casas decimais | 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 |
taxa_fixa | Taxa Fixa | Informa o percentual de taxa fixa do fundo, caso se aplique. | Alfanumérico – Comprimento variável | 23 | 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_maxima | Taxa de Administração Máxima | É o percentual máximo da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa máxima explicitada no regulamento | Decimal | Tamanho 23 com 6 casas decimais | FIDC FII FIP |
taxa_entrada | Taxa de entrada | Taxa cobrada no momento da aplicação de recursos no fundo | Alfanumérico – Comprimento variável | 40 | FIDC FII FIP |
taxa_saida | Taxa de saída | Taxa cobrada sobre o valor do resgate | Alfanumérico – Comprimento variável | 40 | FIDC FII FIP |
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 |
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. Os possíveis valores para este campo são: – 1 – 7 – 28 – 365 | 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 |
resgate_detalhamento | Detalhes dos resgates | Detalhe dos resgates realizados por cotistas e para o 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 |
Lista de campos resgate_detalhamento
Este contexto é compreendido pelos diferentes prestadores de serviço de um fundo. Estes prestadores podem ser:
Campo no Feed | Informação | Tipo/Tamanho | Descrição |
resgates_ir | Valor do IR | Numérico (14) | Valor do resgate do imposto de renda |
resgates_cotista | Valor dos resgates de cotistas | Numérico (14) | Valor de resgates realizados pelos cotistas |
Parâmetros:
Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
CNPJ | CNPJ | Sim | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/34271171000762 |
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-estruturados/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-estruturados/historico
Lista de campos:
Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
descricao | Descrição | Texto descritivo dos arquivos do fundo | Alfanumérico – Comprimento variável | – |
nome | Nome do arquivo | Data em que a nota explicativa foi gerada | Alfanumérico – Comprimento variável | – |
data | Data de referência | Ano correspondente da nota explicativa | Data | YYYY-MM-DD |
url | URL do Documento | Endereço eletrônico do arquivo | Alfanumérico – Comprimento variável | – |
Parâmetros:
Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
data | YYYY-MM-DD | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/historico?data=2024-01-15 |
Arquivos
Abaixo uma relação dos arquivos presentes no endpoint:
Nome do Arquivo | Formato do nome | Exemplo |
anmovcot | nome_data_hora_pacotedefundo | anmovcot_20240115_175033_555.txt |
anstatus | nome_data_hora_pacotedefundo | anstatus_20240115_175033_555.txt |
anvlmes | nome_data_hora_pacotedefundo | anvlmes_20240115_175033_555.txt |
cbtipo | nome_data_hora_pacotedefundo | cbtipo_20240115_175033_555.txt |
Arquivo anmovcot:
A seguir o layout dos arquivos anmovcot
Campo | Formato | Descrição |
codigo_fundo | Numérico 6 dígitos fixos | Código do Fundo |
data_referencia | dd/mm/aaaa hh:mm:ss | Data de início de vigência para regra de movimentação do fundo. |
aplicacao_inicial_minima | Decimal – Precisão 18/5 Exportação truncada em 2 casas | Valor mínimo para aplicação inicial |
aplicacao_adicional_minima | Decimal – Precisão 18/5 Exportação truncada em 2 casas | Valor mínimo para aplicação adicional |
resgate_minimo | Decimal – Precisão 18/5 Exportação truncada em 2 casas | Valor mínimo para resgate do fundo |
saldo_minimo_aplicado | Decimal – Precisão 18/5 Exportação truncada em 2 casas | Valor mínimo de aplicação |
identificador | Alfanumérico 2 posições | Identifica o preenchimento do campo. VAZIO – Não NA – Não se aplica ND – Não disponível NI – Não informado VL – Valor |
Arquivo anstatus:
A seguir o layout dos arquivos anstatus
Campo | Formato | Descrição |
codigo_fundo | Numérico 6 dígitos fixos | Código do Fundo |
status | Alfanumérico até 40 posições | Diversos |
opcoes_status | Alfanumérico até 20 posições | Diversos |
dataini | dd/mm/aaaa hh:mm:ss | Data de inicio de vigência do status do fundo |
datafim | dd/mm/aaaa hh:mm:ss | Data de fim de vigência do status do fundo. Caso este status esteja vigente, este campo é vazio. |
Arquivo anvlmes:
A seguir o layout dos arquivos anvlmes
Campo | Formato | Descrição |
codigo_fundo | Numérico 6 dígitos fixos | Código do Fundo |
mes | Numérico 2 dígitos fixo | Informa o mês da data da informação |
ano | Numérico 4 dígitos fixo | Informa o ano da data da informação |
patrimonio_liquido | Decimal – Precisão 14/2 separado por vírgula | Data de inicio de vigência do status do fundo |
valor_cota | Decimal – Precisão 17/9 separado por vírgula | Data de fim de vigência do status do fundo. Caso este status esteja vigente, este campo é vazio. |
rentmes | Decimal – Precisão 13/7 | Rentabilidade acumulada do fundo no mês |
rentano | Decimal – Precisão 13/7 | Rentabilidade acumulada do fundo no ano |
codtipo | Numérico até 4 dígitos | Código do tipo de fundo |
Arquivo cbtipo:
A seguir o layout dos arquivos cbtipo
Campo | Formato | Descrição |
codtipo | Numérico até 4 dígitos | Código do tipo de fundo |
descricao | Alfanumérico até 40 posições | Descrição do tipo de fundo |
sigla | Alfanumérico até 6 posições | Sigla do tipo de fundo |
dataini | dd/mm/aaaa hh:mm:ss | Data de inicio de vigência do tipo de fundo |
datafim | dd/mm/aaaa hh:mm:ss | Data de fim de vigência do tipo de fundo. Se o tipo estiver ativo este campo não é preenchido |
Notas Explicativas do Fundo
Esta API divulga a lista de notas explicativas do fundo. Estas notas explicativas indicam eventos relevantes que ocorreram no fundo e foram registrados na base da ANBIMA.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v1/fundos-estruturados/{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-estruturados/{codigoFundo}/notas-explicativas
Lista 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-estruturados/546356/notas-explicativas |
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.
Periodicidade de divulgação: Diária
Horário: A partir das 19h30
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 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 |
resgate_detalhamento | Detalhamento dos resgates | Detalhe dos resgates realizados por cotistas e para o 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 |
Lista de campos resgate_detalhamento
Este contexto é compreendido pelos diferentes prestadores de serviço de um fundo. Estes prestadores podem ser:
Campo no Feed | Informação | Tipo/Tamanho | Descrição |
resgates_ir | Valor do IR | Numérico (14) | Valor do resgate do imposto de renda |
resgates_cotista | Valor dos resgates de cotistas | Numérico (14) | Valor de resgates realizados pelos cotistas |
Parâmetros:
Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
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’.
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 Feed | Informação | Descrição | Informação Esperada | Tamanho |
nome | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ | CNPJ do fundo | Alfanumérico – Comprimento variável | 14 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N – Não | Alfanumérico – Comprimento fixo | 1 |
Lista de campos instituicoes_secundarias
:
Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
nome | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ | CNPJ do fundo | Alfanumérico – Comprimento variável | 14 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N – Não | Alfanumérico – Comprimento fixo | 1 |
Parâmetros:
Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
Página | page=1 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-instituicao?page=1 |
Quantidade de fundos por página | size=1000 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-instituicao?page=1&size=1000 |
Obs. 2: A quantidade máxima de registros por página é 1.000.
Obs. 3: Caso seja informado um valor superior ao limite de páginas existentes, é retornado um erro ‘404 Not Found’.
Detalhes dos Fundos Instituição
Este endpoint divulga os dados detalhados de uma instituição específica mediante o fornecimento de um CNPJ.
A relação entre instituições primária e secundária não represente o conceito de conglomerado, ela é autodeclaratória para o fim dos rankings ANBIMA de fundos de investimentos.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v1/fundos-instituicao/{CNPJ}
O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos-instituicao/{CNPJ}
Lista de campos:
Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
nome | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ | CNPJ do fundo | Alfanumérico – Comprimento variável | 14 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N – Não | Alfanumérico – Comprimento fixo | 1 |
Lista de campos instituicoes_secundarias
:
Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
nome | Nome fantasia da Instituição primária | Nome pelo qual a instituição é conhecido | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ | CNPJ da Instituição | Alfanumérico – Comprimento variável | 14 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N – Não | Alfanumérico – Comprimento fixo | 1 |
Parâmetros:
Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
CNPJ Instituição | CNPJ | Sim | GET https:// api.anbima.com.br/feed/fundos/v1/fundos-instituicao/22222222000122 |