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 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 |
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-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 |
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’.