Publicado em 01/10/2024 | Versão 0.2.0
Sobre a versão 2 da API de Fundos
Com a nova resolução de fundos de investimento, a RCVM 175, a qual institui a possibilidade de estrutura multiclasses para todos os fundos, foi necessária a criação de uma nova versão de API, a v2. Essa versão da API entrou em produção em 01/10/2024.
Documentação API de Fundos v1
Se você ainda precisa consultar a antiga documentação da API de fundos v1 que foi descontinuada. Acesse aqui:
- API de Fundos v1.DESCONTINUADA
- Swagger da API de Fundos v1.DESCONTINUADA
- API de Fundos v1 LOTE.DESCONTINUADA
- Swagger da API de Fundos v1 LOTE.DESCONTINUADA
Documentação API de Fundos v2 – fase beta
Acesse aqui o controle de versões da fase beta da API v2 de fundos de investimentos.
O que mudou da v1 para a v2 de fundos?
As principais diferenças ocorrem na estrutura dos fundos que agora podem ser multiclasses. Com isso novos campos de códigos de identificação foram criados.
Observações:
- Sobre o campo Código ANBIMA:
- Passam a existir três tipos de códigos ANBIMA na estrutura de um fundo RCVM 175, diferente da estrutura de um fundo ICVM 555 que apresenta somente um. Esses três códigos são necessários para atender essa nova estrutura composta dos níveis fundo, classe e subclasse. Os fundos poderão ou não usar todos os níveis dessa estrutura.
- Os três códigos têm o mesmo padrão, são alfanuméricos de 11 caracteres, sendo compostos sempre primeiro por uma letra acrescida de dez números. Esta letra será variável de acordo com três opções, uma para cada nível da estrutura: “F”, ”C” ou “S”. Ou seja, um código cuja letra inicial é “F” é um código de fundo. Se a letra for “C”, trata-se de um código de classe e se for “S” trata-se de um código de subclasse.
- Os fundos “estoque” do tipo ICVM555, offshore e ETF que existem hoje serão todos fundos monoclasse (com uma única classe e sem subclasse) quando “migrados para a estrutura 175”.
- Esses fundos de estoque terão a mesma numeração do Código ANBIMA atual nos códigos do fundo e da classe, variando somente a letra. “F” para o fundo e “C” para a classe. Exemplo: o fundo ICVM 555 de código “000191” terá dois códigos: “F0000000191” para a hierarquia do fundo e “C0000000191” para a classe.
- Ou seja, os códigos atuais não persistirão, mas é possível adequá-los com essa regra de transformação: os 6 números atuais + 4 zeros a esquerda deles + a letra a esquerda dos zeros.
- Já para os fundos estruturados de estoque (FII, FIP e FIDC) por eles já terem o conceito de classes, a mudança será um pouco diferente quando “migrados para a estrutura 175”.
- Se o fundo estruturado tiver apenas uma classe, na estrutura 175 esse fundo se manterá como um fundo monoclasse e sem subclasse
- Se o fundo estruturado tiver mais de uma classe (ativa ou encerrada), na estrutura 175 esse fundo será monoclasse com subclasses (estas subclasses são as classes de hoje).
- Somente a partir de 01/10/2024 os novos fundos (FIF, ETF, OFFSHORE) poderão ser registrados como multiclasses.
- Passam a existir três tipos de códigos ANBIMA na estrutura de um fundo RCVM 175, diferente da estrutura de um fundo ICVM 555 que apresenta somente um. Esses três códigos são necessários para atender essa nova estrutura composta dos níveis fundo, classe e subclasse. Os fundos poderão ou não usar todos os níveis dessa estrutura.
De-para:
Disponível material para consulta de de-para de campos da v1 para v2.
Nota: Essa documentação pode sofrer alterações conforme necessidade.
Lista
Este endpoint divulga a lista de fundos da resolução CVM 175 existentes na base da ANBIMA. São informados os códigos de identificação do Fundo, classe(s) e eventuais subclasse(s) existentes.
As informações são disponibilizadas com paginação, com o máximo de 1.000 registros por página. No retorno do objeto JSON, além da lista de fundos, são informados o número total de fundos e a página.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/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/v2/fundosCampos da lista content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_fundo | Código do fundo | Código de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_fundo | Tipo de identificador do fundo | Informa qual o tipo de identificador do fundo. Exemplo: CNPJ | Alfanumérico – Comprimento variável | 11 |
identificador_fundo | Identificador do fundo | Valor do campo tipo de identificador do fundo | Alfanumérico – Comprimento variável | 50 |
razao_social_fundo | Razão social do fundo | Razão social do fundo | Alfanumérico – Comprimento variável | 200 |
nome_comercial_fundo | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 200 |
tipo_fundo | Tipo do fundo | ETF, FIDC, FII, FIP, FIF, OFFSHORE | Alfanumérico – Comprimento variável | 30 |
data_encerramento_fundo | Data de encerramento do fundo | Informa a data de encerramento do fundo | Data | AAAA-MM-DD |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista classes:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_classe | Código da classe | Código de identificação da classe na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_classe | Tipo de identificador da classe | Informa qual o tipo de identificador da classe | Alfanumérico – Comprimento variável | 11 |
identificador_classe | Identificador da classe | Valor do campo tipo de identificador da classe | Alfanumérico – Comprimento variável | 50 |
razao_social_classe | Razão social da classe | Razão social da classe | Alfanumérico – Comprimento variável | 200 |
nome_comercial_classe | Nome fantasia da classe | Nome pelo qual a classe é conhecida | Alfanumérico – Comprimento variável | 200 |
nivel1_categoria | Categoria nível 1 | Categoria nível 1 | Alfanumérico – Comprimento variável | 50 |
data_inicio_atividade_classe | Data de início de atividade da classe | Informa a data de início de atividade da classe | Data | AAAA-MM-DD |
data_encerramento_classe | Data de encerramento da classe | Informa a data de encerramento da classe | Data | AAAA-MM-DD |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista subclases:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_subclasse | Código da subclasse | Código de identificação da subclasse na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_subclasse | Tipo de identificador da subclasse | Informa qual o tipo de identificador da subclasse | Alfanumérico – Comprimento variável | 11 |
identificador_subclasse | Identificador da subclasse | Valor do campo tipo de identificador da subclasse | Alfanumérico – Comprimento variável | 50 |
nome_comercial_subclasse | Nome fantasia da subclasse | Nome pelo qual a subclasse é conhecida | Alfanumérico – Comprimento variável | 200 |
data_inicio_atividade_subclasse | Data de início de atividade da subclasse | Informa a data de início de atividade da subclasse | Data | AAAA-MM-DD |
data_encerramento_subclasse | Data de encerramento da subclasse | Informa a data de encerramento da subclasse | Data | AAAA-MM-DD |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
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/v2/fundos?page=1 |
| Quantidade de fundos por página | size=1000 | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos?page=1&size=1000 |
| Tipo de fundo | tipo-fundo=FIF | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos?tipo-fundo=FIF |
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
Este endpoint contém todos os dados de um fundo CVM 175 específico, com suas classe(s) e eventuais subclasse(s). Ficam apartados no endpoint de série histórica os dados de patrimônio líquido e valores das cotas (PL & Cota).
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/fundos/{codigo_fundo_ou_classe_ou_subclasse}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/v2/fundos/{codigo_fundo_ou_classe_ou_subclasse}As informações presentes nesta API são divididas nos seguintes contextos:
Content
Este contexto é compreendido pelos dados básicos de identificação de um fundo.
Campos da lista Content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_fundo | Código ANBIMA | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_fundo | Tipo identificador do fundo | Informa qual o tipo de identificador do fundo. Exemplo: CNPJ | Alfanumérico – Comprimento variável | 11 |
identificador_fundo | Código identificador | Valor do campo tipo de identificador do fundo | Alfanumérico – Comprimento variável | 50 |
tipo_fundo | Tipo do fundo | Indica o tipo do fundo | Alfanumérico – Comprimento variável | 30 |
razao_social_fundo | Razão social | Razão social do fundo | Alfanumérico – Comprimento variável | 200 |
nome_comercial_fundo | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
adaptado_rcvm175 | Adaptado à RCVM 175 | Informa se o fundo está adaptado a RCVM 175. Os possíveis valores para o campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
moeda | Moeda | Moeda referente aos valores informados | Alfanumérico – Comprimento fixo | 3 |
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 | AAAA-MM-DD |
data_vigencia_fundo | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
atributo | Atributo | Indicada se o fundo é classificado como monoclasse ou multiclasses. Os possíveis valores para o campo são: – Monoclasse – Multiclasses | Alfanumérico – Comprimento variável | 50 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Documentos
Este contexto é compreendido pelos dados básicos de documentos de um fundo.
Campos da lista documentos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_documento | Tipo do documento | Informa o tipo de documento a qual o arquivo se refere. Exemplos: Regulamento, Auditoria, Assembleia, etc. | Alfanumérico – Comprimento variável | 11 |
url | URL do documento | Endereço eletrônico do arquivo | Alfanumérico – Comprimento variável | 250 |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
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 |
| Co-gestor | Responsável pela co-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 |
| Controladoria | Responsável pela execução dos procedimentos contábeis |
Campos da lista prestadores:
Esta lista contempla prestadores que podem ser do fundo, da classe ou da subclasse.
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_tipo_prestador | Tipo de prestador | Informa o tipo de prestador | Alfanumérico – Comprimento variável | 50 |
identificador | Código identificador | Exibe o código identificador | Alfanumérico – Comprimento variável | 50 |
razao_social | Nome ou Razão Social | Nome ou Razão Social do prestador | Alfanumérico – Comprimento variável | 200 |
nome_comercial | Nome comercial | Nome comercial do prestador | Alfanumérico – Comprimento variável | 200 |
tipo_pessoa | Tipo de pessoa | Exibe o tipo de pessoa, sendo: F = Pessoa Física J = Pessoa Jurídica | Alfanumérico – Comprimento fixo | 1 |
codigo_pais | Código do país | Informa o código do país | Alfanumérico – Comprimento fixo | 3 |
data_inicio_vigencia | Data de início da vigência | Data de início da vigência | Data | AAAA-MM-DD |
data_fim_vigencia | Data de fim da vigência | Data de fim da vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Classes
Este contexto é compreendido pelos dados básicos de detalhes da(s) classe(s).
Campos da lista classes:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_classe | Código da Classe | Exibe o código da classe | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_classe | Tipo de identificador da classe | Informa qual o tipo de identificador da classe | Alfanumérico – Comprimento variável | 11 |
identificador_classe | Identificador da classe | Valor do campo tipo de identificador da classe | Alfanumérico – Comprimento variável | 50 |
data_inicio_atividade_classe | Data início da atividade | Representa a primeira data de atividade | Data | AAAA-MM-DD |
razao_social_classe | Razão social | Razão social | Alfanumérico – Comprimento variável | 200 |
nome_comercial_classe | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
tributacao_perseguida | Tributação perseguida | Informa a tributação perseguida | Alfanumérico – Comprimento variável | 50 |
alavancado | Alavancado | Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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). Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
percentual_permitido_credito_privado | Percentual permitido de crédito privado | Indica o percentual de crédito privado permitido | Decimal | 5, 2 |
investimento_exterior | Investimento 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 %] | 50 |
percentual_permitido_investimento_exterior | Percentual permitido de investimento exterior | Indica o percentual de investimento exterior permitido | Decimal | 5, 2 |
foco_atuacao | Foco atuação | Indica o principal foco de atuação do fundo | Alfanumérico – Comprimento variável | 50 |
fundos_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: – Não – Não se Aplica – ND – Relacionado – Sim | Alfanumérico – Comprimento variável | 50 |
forma_condominio | Forma condomínio | Os fundos de investimento podem ser organizados sob a forma de condomínio aberto ou fechado | Alfanumérico – Comprimento variável | 50 |
responsabilidade_limitada | Responsabilidade limitada | Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
categoria_cvm | Categoria CVM | Nome da categoria CVM | Alfanumérico – Comprimento variável | 11 |
composicao | Composição da classe | CI (Classe de Investimento) CIC (Classe que Investe em Cotas) CIPC (Classe de Investimento para Classe) CICPC (Classe que Investe em Cotas Para Classe) | Alfanumérico – Comprimento variável | 50 |
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 | 50 |
nivel_1_categoria | Categoria nível 1 | Categoria nível 1 | Alfanumérico – Comprimento variável | 50 |
nivel_2_categoria | Categoria nível 2 | Categoria nível 2 | Alfanumérico – Comprimento variável | 50 |
nivel_3_subcategoria | Subcategoria nível 3 | Subcategoria nível 3 | Alfanumérico – Comprimento variável | 50 |
data_encerramento_classe | Data de encerramento | Informa a data de encerramento da classe | Data | AAAA-MM-DD |
data_vigencia_classe | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
sufixo | Sufixo | Sufixo da classe | Alfanumérico – Comprimento variável | 100 |
data_inico_vigencia | Data início da vigência | Data de início da vigência do sufixo | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência do sufixo | Data | AAAA-MM-DD |
infraestrutura | Infraestrutura | Indica se o fundo é de infraestrutura. Os possíveis valores para o campo são: Sim (S) Não (N) Não se aplica (NA) Não definido (ND) | Alfanumérico – Comprimento variável | 2 |
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 |
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 |
data_atualização | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Perfil complementar
Lista de campos perfil-complementar:
Esta lista contempla informações de perfil complementar que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
restricao_investimento | Restrição Investimento | Restrição de investimento | Alfanumérico – Comprimento variável | 50 |
tipo_investidor | Tipo de investidor | Tipo de investidor predominante | Alfanumérico – Comprimento variável | 50 |
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. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
plano_previdencia | Plano previdência | Informa o plano de previdência | Alfanumérico – Comprimento variável | 50 |
periodicidade_envio_pl_cota | Periodicidade envio PL cota | Periodicidade do envio PL Cota | Alfanumérico – Comprimento variável | 50 |
calculo_cota | Cálculo cota | Cálculo Cota | Alfanumérico – Comprimento variável | 50 |
codigo_b3 | Código B3 | Código B3 | Alfanumérico – Comprimento variável | 50 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Taxas entrada e saída
Lista de campos taxas-entrada-saida:
Esta lista contempla informações de taxas de entrada e saída que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_entrada_saida | Tipo entrada e saída | Informa se a taxa é entrada ou saída | Alfanumérico – Comprimento fixo | 1 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Decimal | 7, 2 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
Taxas
Lista de campos taxas:
Esta lista contempla informações de taxas que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_taxa | Tipo taxa | Informa o tipo de taxa. Os possíveis valores para este campo são: – Global | Alfanumérico – Comprimento variável | 50 |
perfil_taxa | Perfil taxa | Perfil da taxa. Os possíveis valores para este campo são: – Fixa – Escalonada | Alfanumérico – Comprimento variável | 50 |
unidade_taxa | Unidade taxa | Unidade da taxa. Os possíveis valores para este campo são: – Valor – Percentual – % acrescido de valor – Maior entre % e valor – Outros | Alfanumérico – Comprimento variável | 50 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Decimal | 7, 2 |
valor_piso | Valor piso | Exibe o valor do piso | Decimal | 19, 2 |
valor_fixo | Valor fixo | Exibe o valor fixo | Decimal | 19, 2 |
valor_taxa_maxima | Valor taxa máxima | Exibe o valor monetário da taxa máxima | Decimal | 19, 2 |
valor_percentual_taxa_maxima | Valor percentual taxa máxima | Exibe o valor percentual da taxa máxima | Decimal | 7, 2 |
informacoes_adicionais | Informações adicionais | Exibe informações adicionais | Alfanumérico – Comprimento variável | 500 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
faixas_escalonamento | ||||
valor_faixa_pl_inicial | Valor faixa PL inicial | Exibe o valor inicial da faixa de patrimônio líquido | Decimal | 19, 2 |
valor_faixa_pl_final | Valor faixa PL final | Exibe o valor final da faixa de patrimônio líquido | Decimal | 19, 2 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Dacimal | 7, 2 |
Taxas de performance
Lista de campos taxas-performance:
Esta lista contempla informações de taxas de performance que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
perfil_taxa | Perfil taxa | Perfil da taxa. Os possíveis valores para este campo são: – Fixa – Escalonada | Alfanumérico – Comprimento variável | 50 |
periodicidade_cobranca | Periodicidade de cobrança | Periodicidade de cobrança da taxa. Os possíveis valores para este campo são: – Mensal – Bimestral – Trimestral – Semestral – Anual | Alfanumérico – Comprimento variável | 50 |
informacoes_adicionais | Informações adicionais | Informações adicionais | Alfanumérico – Comprimento variável | 500 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
detalhes | ||||
valor_pl_inicial | Valor PL inicial | Valor inicial do patrimônio líquido | Decimal | 19, 2 |
valor_pl_final | Valor PL final | Valor final do patrimônio líquido | Decimal | 19, 2 |
valor_percentual | Valor percentual | Valor percentual da taxa | Decimal | 7, 2 |
indice_referência | Índice referência | Índice referência da taxa | Alfanumérico – Comprimento variável | 50 |
valor_percentual_indice_referencia | Valor percentual índice referência | Valor percentual do índice de referência | Decimal | 7, 2 |
valor_taxa_fixa | Valor taxa fixa | Valor da taxa fixa | Decimal | 7, 2 |
Valores mínimos movimentação
Lista de campos valores-minimos-movimentacao:
Esta lista contempla informações de valores mínimos de movimentação que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
indicador_prazo_emissao_cota | Indicador de prazo para emissão de cotas | Indicador de prazo para emissão de cotas. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
prazo_emissao_cota | Prazo para emissão de cotas | Prazo (em dias) para conversão das cotas para efeito de aplicação de recursos | Numérico | 11 |
indicador_prazo_conversao_resgate | Indicador de prazo para conversão de resgate | Indicador de prazo para conversão de resgate. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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 | Inteiro | 11 |
indicador_prazo_pagamento_resgate | Indicador de prazo para pagamento resgate | Indicador de prazo para pagamento resgate. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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 | Inteiro | 11 |
regra_adicional_pagamento_resgate | Regra adicional pagamento resgate | Regra adicional pagamento resgate | Alfanumérico – Comprimento variável | 150 |
dias_carencia_inicial | Carência inicial | Dias de carência inicial | Inteiro | 11 |
dias_carencia_ciclica | Carência cíclica | Dias de carência cíclica | Inteiro | 11 |
valor_minimo_aplicacao_inicial | 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 | 19,2 |
valor_minimo_aplicacao_subsequente | Valor mínimo aplicação subsequente | Decimal | 19,2 | |
valor_minimo_resgate | 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 | 19,2 |
valor_minimo_permanencia | Valor mínimo de permanência | Informa o valor mínimo de permanência | Decimal | 19,2 |
data_atualizacao | Data de atulização da informação | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Índices benchmark
Lista de campos indices-benchmark:
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
benchmark | Benchmark | Este campo indica o índice de referência de desempenho do fundo | Alfanumérico – Comprimento variável | 50 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência do benchmark | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência do benchmark | Data | AAAA-MM-DD |
data_atualizacao | Data de atulização da informação | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Subclasses
Lista de campos subclasses:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_subclasse | Código da Classe | Exibe o código da classe | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_subclasse | Tipo de identificador da subclasse | Informa qual o tipo de identificador da subclasse | Alfanumérico – Comprimento variável | 11 |
identificador_subclasse | Identificador da subclasse | Valor do campo de identificador da subclasse | Alfanumérico – Comprimento variável | 50 |
nome_comercial_subclasse | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
data_inicio_atividade_subclasse | Data início da atividade | Representa a primeira data de atividade | Data | YYYY-MM-DD |
data_encerramento_subclasse | Data de encerramento da subclasse | Informa a data de encerramento da subclasse | Data | YYYY-MM-DD |
data_atualização | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Detalhes – Histórico
Este endpoint divulga todo o histórico de alterações cadastrais de um Fundo.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/fundos/{codigo_fundo}/historicoO 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/v2/fundos/{codigo_fundo}/historicoCampos da lista content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_fundo | Código do fundo | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_fundo | Tipo identificador do fundo | Informa qual o tipo de identificador do fundo. Exemplo: CNPJ | Alfanumérico – Comprimento variável | 11 |
identificador_fundo | Identificador do fundo | Valor do campo tipo de identificador do fundo | Alfanumérico – Comprimento variável | 50 |
tipo_fundo | Tipo do fundo | ETF, FIDC, FII, FIP, FIF, OFFSHORE | Alfanumérico – Comprimento variável | 30 |
atributo | Atributo | Indicada se o fundo é classificado como monoclasse ou multiclasses. Os possíveis valores para o campo são: – Monoclasse – Multiclasses | Alfanumérico – Comprimento variável | 50 |
data_encerramento_fundo | Data de encerramento do fundo | Informa qual a data de encerramento do fundo | Data | AAAA-MM-DD |
Campos da lista historico_fundo:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_identificador_fundo | Tipo identificador do fundo | Informa qual o tipo de identificador do fundo. Exemplo: CNPJ | Alfanumérico – Comprimento fixo | 11 |
identificador_fundo | Identificador do fundo | Valor do campo de identificador do fundo | Alfanumérico – Comprimento variável | 50 |
razao_social_fundo | Razão social do fundo | Razão social do fundo | Alfanumérico – Comprimento variável | 200 |
nome_comercial | Nome comercial | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 200 |
| Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
Campos da lista historico_prestadores:
Esta lista contempla informações de prestadores que podem ser do fundo, da classe ou da subclasse.
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_tipo_prestador | Tipo de prestador | Informa o tipo de prestador | Alfanumérico – Comprimento variável | 50 |
identificador | Código identificador | Exibe o código identificador | Alfanumérico – Comprimento variável | 50 |
razao_social | Nome ou Razão Social | Nome ou Razão Social do prestador | Alfanumérico – Comprimento variável | 200 |
nome_comercial | Nome comercial | Nome comercial do prestador | Alfanumérico – Comprimento variável | 200 |
tipo_pessoa | Tipo de pessoa | Exibe o tipo de pessoa, sendo: F = Pessoa Física J = Pessoa Jurídica | Alfanumérico – Comprimento fixo | 1 |
codigo_pais | Código do país | Informa o código do país | Alfanumérico – Comprimento fixo | 3 |
data_inicio_vigencia | Data de início da vigência | Data de início da vigência | Data | AAAA-MM-DD |
data_fim_vigencia | Data de fim da vigência | Data de fim da vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista historico_documentos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_documento | Tipo do documento | Informa o tipo de documento a qual o arquivo se refere. Exemplos: Regulamento, Auditoria, Assembleia, etc. | Alfanumérico – Comprimento variável | 11 |
url | URL do documento | Endereço eletrônico do arquivo | Alfanumérico – Comprimento variável | 250 |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista classes:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_classe | Código da Classe | Exibe o código da classe | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_classe | Tipo de identificador da classe | Informa qual o tipo de identificador da classe | Alfanumérico – Comprimento variável | 11 |
identificador_classe | Identificador da classe | Valor do campo tipo de identificador da classe | Alfanumérico – Comprimento variável | 50 |
data_inicio_atividade | Data início da atividade | Representa a primeira data de atividade | Data | AAAA-MM-DD |
data_encerramento_classe | Data de encerramento | Informa a data de encerramento da classe | Data | AAAA-MM-DD |
Campos da lista historico_classe:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
razao_social | Razão social | Exibe a razão social | Alfanumérico – Comprimento variável | 200 |
nome_comercial | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
categoria_cvm | Categoria CVM | Nome da categoria CVM | Alfanumérico – Comprimento variável | 11 |
tributacao_perseguida | Tributação perseguida | Informa a tributação perseguida | Alfanumérico – Comprimento variável | 50 |
alavancado | Alavancado | Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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). Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
percentual_permitido_credito_privado | Percentual permitido de crédito privado | Indica o percentual de crédito privado permitido | Decimal | 5, 2 |
investimento_exterior | Investimento 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 %] | 50 |
percentual_permitido_investimento_exterior | Percentual permitido de investimento exterior | Indica o percentual de investimento exterior permitido | Decimal | 5, 2 |
foco_atuacao | Foco atuação | Indica o principal foco de atuação do fundo | Alfanumérico – Comprimento variável | 50 |
fundo_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: – Não – Não se Aplica – ND – Relacionado – Sim | Alfanumérico – Comprimento variável | 50 |
forma_condominio | Forma condomínio | Os fundos de investimento podem ser organizados sob a forma de condomínio aberto ou fechado | Alfanumérico – Comprimento variável | 50 |
responsabilidade_limitada | Responsabilidade limitada | Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
infraestrutura | Infraestrutura | Indica se o fundo é de infraestrutura. Os possíveis valores para o campo são: Sim (S) Não (N) Não se aplica (NA) Não definido (ND) | Alfanumérico – Comprimento variável | 2 |
entidade_investimento_fins_tributarios | Entidade investimentos 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 |
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 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
Campos da lista historico_composicao_classe:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
composicao | Composição da classe | CI (Classe de Investimento) CIC (Classe que Investe em Cotas) CIPC (Classe de Investimento para Classe) CICPC (Classe que Investe em Cotas Para Classe) | Alfanumérico – Comprimento variável | 50 |
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 | 50 |
nivel1_categoria | Categoria nível 1 | Categoria nível 1 | Alfanumérico – Comprimento variável | 50 |
nivel2_categoria | Categoria nível 2 | Categoria nível 2 | Alfanumérico – Comprimento variável | 50 |
nivel3_subcategoria | Subcategoria nível 3 | Subcategoria nível 3 | Alfanumérico – Comprimento variável | 50 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista historico_perfil_complementar:
Esta lista contempla informações de perfil que podem ser da classe ou da subclasse.
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
restricao_investimento | Restrição Investimento | Restrição de investimento | Alfanumérico – Comprimento variável | 50 |
tipo_investidor | Tipo de investidor | Tipo de investidor predominante | Alfanumérico – Comprimento variável | 50 |
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. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
plano_previdencia | Plano previdência | Informa o plano de previdência | Alfanumérico – Comprimento variável | 50 |
periodicidade_envio_pl_cota | Periodicidade envio PL cota | Periodicidade do envio PL Cota | Alfanumérico – Comprimento variável | 50 |
calculo_cota | Cálculo cota | Cálculo Cota | Alfanumérico – Comprimento variável | 50 |
codigo_b3 | Código B3 | Código B3 | Alfanumérico – Comprimento variável | 50 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
Campos da lista historico_taxa_entrada_saida:
Esta lista contempla informações de taxa de entrada e saída que podem ser da classe ou da subclasse.
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_entrada_saida | Tipo entrada e saída | Informa se a taxa é entrada ou saída | Alfanumérico – Comprimento fixo | 1 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Decimal | 7, 2 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Taxas
Lista de campos taxas:
Esta lista contempla informações de taxas que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_taxa | Tipo taxa | Informa o tipo de taxa. Os possíveis valores para este campo são: – Global | Alfanumérico – Comprimento variável | 50 |
perfil_taxa | Perfil taxa | Perfil da taxa. Os possíveis valores para este campo são: – Fixa – Escalonada | Alfanumérico – Comprimento variável | 50 |
unidade_taxa | Unidade taxa | Unidade da taxa. Os possíveis valores para este campo são: – Valor – Percentual – % acrescido de valor – Maior entre % e valor – Outros | Alfanumérico – Comprimento variável | 50 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Decimal | 7, 2 |
valor_piso | Valor piso | Exibe o valor do piso | Decimal | 19, 2 |
valor_fixo | Valor fixo | Exibe o valor fixo | Decimal | 19, 2 |
valor_taxa_maxima | Valor taxa máxima | Exibe o valor monetário da taxa máxima | Decimal | 19, 2 |
valor_percentual_taxa_maxima | Valor percentual taxa máxima | Exibe o valor percentual da taxa máxima | Decimal | 7, 2 |
informacoes_adicionais | Informações adicionais | Exibe informações adicionais | Alfanumérico – Comprimento variável | 500 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
faixas_escalonamento | ||||
valor_faixa_pl_inicial | Valor faixa PL inicial | Exibe o valor inicial da faixa de patrimônio líquido | Decimal | 19, 2 |
valor_faixa_pl_final | Valor faixa PL final | Exibe o valor final da faixa de patrimônio líquido | Decimal | 19, 2 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Dacimal | 7, 2 |
Taxas de performance
Lista de campos taxas-performance:
Esta lista contempla informações de taxas de performance que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
perfil_taxa | Perfil taxa | Perfil da taxa. Os possíveis valores para este campo são: – Fixa – Escalonada | Alfanumérico – Comprimento variável | 50 |
periodicidade_cobranca | Periodicidade de cobrança | Periodicidade de cobrança da taxa. Os possíveis valores para este campo são: – Mensal – Bimestral – Trimestral – Semestral – Anual | Alfanumérico – Comprimento variável | 50 |
informacoes_adicionais | Informações adicionais | Informações adicionais | Alfanumérico – Comprimento variável | 500 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
detalhes | ||||
valor_pl_inicial | Valor PL inicial | Valor inicial do patrimônio líquido | Decimal | 19, 2 |
valor_pl_final | Valor PL final | Valor final do patrimônio líquido | Decimal | 19, 2 |
valor_percentual | Valor percentual | Valor percentual da taxa | Decimal | 7, 2 |
indice_referência | Índice referência | Índice referência da taxa | Alfanumérico – Comprimento variável | 50 |
valor_percentual_indice_referencia | Valor percentual índice referência | Valor percentual do índice de referência | Decimal | 7, 2 |
valor_taxa_fixa | Valor taxa fixa | Valor da taxa fixa | Decimal | 7, 2 |
Campos da lista historico_valores_minimos_movimentacao:
Esta lista contempla informações de valores mínimos de movimentação que podem ser da classe ou da subclasse.
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
indicador_prazo_emissao_cota | Indicador de prazo para emissão de cotas | Indicador de prazo para emissão de cotas. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
prazo_emissao_cota | Prazo para emissão de cotas | Prazo (em dias) para conversão das cotas para efeito de aplicação de recursos | Inteiro | 11 |
indicador_prazo_conversao_resgate | Indicador de prazo para conversão de resgate | Indicador de prazo para conversão de resgate. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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 | Inteiro | 11 |
indicador_prazo_pagamento_resgate | Indicador de prazo para pagamento resgate | Indicador de prazo para pagamento resgate. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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 | Numérico | 11 |
regra_adicional_pagamento_resgate | Regra adicional pagamento resgate | Regra adicional pagamento resgate | Alfanumérico – Comprimento fixo | 150 |
dias_carencia_inicial | Carência inicial | Dias de carência inicial | Inteiro | 11 |
dias_carencia_ciclica | Carência cíclica | Dias de carência cíclica | Inteiro | 11 |
valor_minimo_aplicacao_inicial | 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 | 19, 2 |
valor_minimo_aplicacao_subsequente | Valor mínimo aplicação subsequente | Informa o valor mínimo para aplicação subsequente | Decimal | 19, 2 |
valor_minimo_resgate | 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 | 19, 2 |
valor_minimo_permanencia | Valor mínimo de permanência | Informa o valor mínimo de permanência | Decimal | 19,2 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista historico_indices_benchmark:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
| benchmark | Bechmark | Este campo indica o índice de referência de desempenho do fundo | Alfanumérico – Comprimento variável | 50 |
| data_inicio_vigencia | Data início da vigência | Data de início da vigência do benchmark | Data | AAAA-MM-DD |
| data_fim_vigencia | Data fim da vigência | Data de fim da vigência do benchmark | Data | AAAA-MM-DD |
| data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista historico_sufixos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
sufixo | Sufixo | Sufixo da classe | Alfanumérico – Comprimento variável | 100 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista subclasses:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_subclasse | Código da Subclasse | Exibe o código da subclasse | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_subclasse | Tipo de identificador da subclasse | Informa qual o tipo de identificador da subclasse | Alfanumérico – Comprimento variável | 11 |
identificador_subclasse | Identificador da subclasse | Valor do campo de identificador da subclasse | Alfanumérico – Comprimento variável | 50 |
data_inicio_atividade | Data início da atividade | Representa a primeira data de atividade | Data | AAAA-MM-DD |
data_encerramento | Data de encerramento da subclasse | Informa a data de encerramento da subclasse | Data | AAAA-MM-DD |
Campos da lista historico_subclasses:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
data_inicio_atividade_subclasse | Data início da atividade | Representa a primeira data de atividade | Data | AAAA-MM-DD |
nome_comercial | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
Série histórica
Este endpoint divulga todo o histórico de dados periódicos do fundo (PL e cota).
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/fundos/{codigo_classe_ou_subclasse}/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/v2/fundos/{codigo_classe_ou_subclasse}/serie-historicaCampos da lista content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_fundo | Código do fundo | Código de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
codigo_classe | Código da classe | Código de identificação da classe na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
codigo_subclasse | Código da subclasse | Código de identificação da subclasse na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
valor_patrimonio_liquido | Valor do patrimônio líquido | Exibe o valor do patrimônio líquido da classe ou subclasse | Decimal | 21, 5 |
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 | 33, 17 |
valor_volume_total_aplicacoes | Valor volume total aplicações | Valor volume total aplicações | Decimal | 21, 5 |
valor_volume_total_resgates | Valor volume total resgates | Valor volume total resgates | Decimal | 21, 5 |
valor_volume_total_resgate_ir | Valor volume total resgate IR | Valor volume total resgate IR | Decimal | 21, 5 |
numero_cotistas | Número de cotistas | Número total de investidores | Numérico | 11 |
codigo_moeda | Identificação do tipo da moeda | BRL, USD ou EUR | Alfanumérico – Comprimento fixo | 3 |
data_competencia | Data competência | Informa a data de competência | Data | YYYY-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização | Data/hora | YYYY-MM-DD HH:MM:SS.SSS |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Código Classe/Subclasse | C0000000000, S0000000000 | Sim | GET https://api.anbima.com.br/feed/fundos/v2/fundos/C0000000191/serie-historica |
| Data inicial da consulta | data-inicio=YYYY-MM-DD | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/C0000000191/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/v2/fundos/C0000000191/serie-historica?data-inicio=2019-11-19&data-fim=2020-11-14 |
| Data de atualização | data-atualizacao=AAA-MM-DDTHH:MM:SS.SSS | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/C0000000191/serie-historica?data-atualizacao=2024-01-01T00:00:00.000 |
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.
Obs. 5: Os dados de série histórica são exibidos por ordem descendente da data de referência (do mais novo ao mais antigo registro).
Fundos instituição
Este endpoint divulga a lista completa da relação entre as instituições pertencentes a indústria de fundos de investimentos que possuem pelo menos um fundo ativo vinculado ao papel de prestador de serviço.
Essa relação é constituída a pedido da instituição participante ao Código de Administração de Recursos de Terceiros para fim da elaboração dos rankings de fundos de investimento realizados pela ANBIMA.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/fundos/instituicoesO 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/v2/fundos/instituicoesLista de campos content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
razao_social | Nome ou Razão Social | Nome ou Razão Social do prestador | Alfanumérico – Comprimento variável | 200 |
identificador | Código identificador | Exibe o código identificador | Alfanumérico – Comprimento variável | 50 |
tipo_pessoa | Tipo de pessoa | Exibe o tipo de pessoa, sendo: F = Pessoa Física, J = Pessoa Jurídica | Alfanumérico – Comprimento fixo | 1 |
codigo_pais | Código do país | Informa o código do país | Alfanumérico – Comprimento fixo | 3 |
instituicao_primaria | S/N | Informa se a instituição é primária. S = Sim N = Não | Alfanumérico – Comprimento fixo | 1 |
Campos da lista instituicoes_secundarias:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
razao_social | Nome ou Razão Social | Nome ou Razão Social do prestador | Alfanumérico – Comprimento variável | 200 |
identificador | Código identificador | Exibe o código identificador | Alfanumérico – Comprimento variável | 50 |
tipo_pessoa | Tipo de pessoa | Exibe o tipo de pessoa, sendo: F = Pessoa Física, J = Pessoa Jurídica | Alfanumérico – Comprimento fixo | 1 |
codigo_pais | Código do país | Informa o código do país | Alfanumérico – Comprimento fixo | 3 |
instituicao_primaria | N | Informa se a instituição é primária. Nesse caso, como se trata de uma instituição secundária, será sempre N. | Alfanumérico – Comprimento fixo | 1 |
instituicoes_secundarias | – | – | – | – |
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/v2/fundos/instituicoes?page=1 |
| Quantidade de fundos por página | size=1000 | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/instituicoes?page=1&size=1000 |
Obs. 2: Caso seja informado um valor superior ao limite de páginas existentes, é retornado um erro ‘404 Not Found’.
Fundos instituição – detalhes
Este endpoint divulga os detalhes das instituições pertencentes a indústria de fundos de investimentos que possuem pelo menos um fundo ativo vinculado ao papel de prestador de serviço.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/fundos/instituicoes/{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/v2/fundos/instituicoes/{cnpj}Lista de campos content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
razao_social | Nome ou Razão Social | Nome ou Razão Social do prestador | Alfanumérico – Comprimento variável | 200 |
identificador | Código identificador | Exibe o código identificador | Alfanumérico – Comprimento variável | 50 |
tipo_pessoa | Tipo de pessoa | Exibe o tipo de pessoa, sendo: F = Pessoa Física, J = Pessoa Jurídica | Alfanumérico – Comprimento fixo | 1 |
codigo_pais | Código do país | Informa o código do país | Alfanumérico – Comprimento fixo | 3 |
instituicao_primaria | S/N | Informa se a instituição é primária. Informa se a instituição é primária. S = Sim N = Não | Alfanumérico – Comprimento fixo | 1 |
instituicoes_secundarias | S/N | Informa se a instituição é primária. S = Sim N = Não | Alfanumérico – Comprimento fixo | 1 |
Patrimônio líquido por Segmento do Investidor
Este endpoint divulga a distribuição percentual do patrimônio líquido (PL) dos fundos de investimento, conforme a classificação do tipo de investidor que aplicou nos fundos (segmentação dos clientes). Trata-se de um produto exclusivo para instituições aderentes ao Capítulo de Gestão ou Administração no Código de ART.
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/fundos/segmento-investidor/{codigo_classe_ou_subclasse}/patrimonio-liquidoO 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/v2/fundos/segmento-investidor/{codigo_classe_ou_subclasse}/patrimonio-liquidoCampos da lista content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_fundo | Código do fundo | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
identificador | Código identificador | Valor do campo tipo de identificador do fundo | Alfanumérico – Comprimento variável | 50 |
tipo_identificador | Tipo identificador do fundo | Informa qual o tipo de identificador do fundo. Exemplo: CNPJ | Alfanumérico – Comprimento variável | 11 |
nome_comercial | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
Campos da lista classe:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_classe | Código da classe | Exibe o código da classe | Alfanumérico – Comprimento fixo | 11 |
identificador | Identificador da classe | Valor do campo tipo de identificador da classe | Alfanumérico – Comprimento variável | 50 |
tipo_identificador | Tipo identificador da classe | Informa qual o tipo de identificador da classe | Alfanumérico – Comprimento variável | 11 |
nome_comercial | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
nivel1_categoria | Categoria nível 1 | Categoria nível 1 | Alfanumérico – Comprimento variável | 50 |
Campos da lista subclasse:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_subclasse | Código da subclasse | Exibe o código da subclasse | Alfanumérico – Comprimento fixo | 11 |
identificador | Identificador da classe | Valor do campo tipo de identificador da subclasse | Alfanumérico – Comprimento variável | 50 |
tipo_identificador | Tipo identificador da classe | Informa qual o tipo de identificador da subclasse | Alfanumérico – Comprimento variável | 11 |
nome_comercial | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
Campos da lista historico_segmento_investidor_fundo:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
ano_referencia | Ano referência | Ano de referência | Inteiro | 4 |
mes_referencia | Mês referência | Mês de referência | Inteiro | 2 |
data_referencia | Data referência | Data de referência | Data | YYYY-MM-DD |
nome_administrador | Nome do administrador mãe do fundo | Indica o nome do administrador (na visão de instituição líder do conglomerado), instituição responsável por classificar os clientes e enviar as informações de segmento de investidor | Alfanumérico – Comprimento variável | 255 |
nome_gestor | Nome gestor | Indica o nome do gestor (na visão de instituição líder do conglomerado) | Alfanumérico – Comprimento variável | 255 |
status | Status | Indica se o administrador compartilhou com a ANBIMA as informações de PL por segmento do investidor no determinado mês e ano de referência | Alfanumérico – Comprimento variável | 255 |
data_atualizacao | Data de atualização da informação | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Campos da lista distribuicao_segmento_investidor:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
segmento_investidor | Segmento do investidor | Indica em qual tipo de segmentação o cliente está enquadrado, conforme política comercial de cada instituição | Alfanumérico – Comprimento variável | 255 |
percentual_patrimonio_liquido | Percentual do patrimônio líquido | Indica o percentual do Patrimônio Líquido que corresponde ao segmento do investidor informado no determinado mês e ano de referência | Decimal | 6 |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
Código Classe/Subclasse | C0000000000, S0000000000 | Sim | GET https://api.anbima.com.br/feed/fundos/v2/fundos/segmento-investidor/{codigo_classe_ou_subclasse}/patrimonio-liquido |
Mês de referência | mes-referencia=MM | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/segmento-investidor/{codigo_classe_ou_subclasse}/patrimonio-liquido?mes-referencia=4 |
Ano de referência | ano-referencia=AAAA | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/segmento-investidor/{codigo_classe_ou_subclasse}/patrimonio-liquido?ano-referencia=2018 |
Notas explicativas
Este endpoint 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/v2/fundos/{codigo_classe_ou_subclasse}/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/v2/fundos/{codigo_classe_ou_subclasse}/notas-explicativasCampos da lista content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_fundo | Código do fundo | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
codigo_classe | Código da classe | Exibe o código da classe | Alfanumérico – Comprimento fixo | 11 |
codigo_subclasse | Código da subclasse | Exibe o código da subclasse | Alfanumérico – Comprimento fixo | 11 |
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 | YYYY-MM-DDDD |
ano_divulgacao | Ano divulgação | Ano correspondente da nota explicativa | Número | 4 |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Página | page=0 | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/{codigo_classe_ou_subclasse}/notas-explicativas?page=0 |
| Quantidade de fundos por página | size=1000 | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/{codigo_classe_ou_subclasse}/notas-explicativas?size=10 |
Lote – dados cadastrais
Este endpoint divulga os dados básicos de identificação de todos os fundos deste tipo existentes na base da ANBIMA.
Periodicidade de divulgação: Diária
Horário: Ao longo do dia
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/fundos/dados-cadastrais/loteO 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/v2/fundos/dados-cadastrais/loteContent
Este contexto é compreendido pelos dados básicos de identificação de um fundo.
Campos da lista Content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_fundo | Código ANBIMA | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_fundo | Tipo identificador do fundo | Informa qual o tipo de identificador do fundo. Exemplo: CNPJ | Alfanumérico – Comprimento variável | 11 |
identificador_fundo | Código identificador | Valor do campo tipo de identificador do fundo | Alfanumérico – Comprimento variável | 50 |
tipo_fundo | Tipo do fundo | Indica o tipo do fundo | Alfanumérico – Comprimento variável | 30 |
razao_social_fundo | Razão social | Razão social do fundo | Alfanumérico – Comprimento variável | 200 |
nome_comercial_fundo | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
adaptado_rcvm175 | Adaptado à RCVM 175 | Informa se o fundo está adaptado a RCVM 175. Os possíveis valores para o campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
moeda | Moeda | Moeda referente aos valores informados | Alfanumérico – Comprimento fixo | 3 |
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 | AAAA-MM-DD |
data_vigencia_fundo | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
atributo | Atributo | Indicada se o fundo é classificado como monoclasse ou multiclasses. Os possíveis valores para o campo são: – Monoclasse – Multiclasses | Alfanumérico – Comprimento variável | 50 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Documentos
Este contexto é compreendido pelos dados básicos de documentos de um fundo.
Campos da lista documentos:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_documento | Tipo do documento | Informa o tipo de documento a qual o arquivo se refere. Exemplos: Regulamento, Auditoria, Assembleia, etc. | Alfanumérico – Comprimento variável | 11 |
url | URL do documento | Endereço eletrônico do arquivo | Alfanumérico – Comprimento variável | 250 |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
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 |
| Co-gestor | Responsável pela co-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 |
| Controladoria | Responsável pela execução dos procedimentos contábeis |
Campos da lista prestadores:
Esta lista contempla prestadores que podem ser do fundo, da classe ou da subclasse.
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_tipo_prestador | Tipo de prestador | Informa o tipo de prestador | Alfanumérico – Comprimento variável | 50 |
identificador | Código identificador | Exibe o código identificador | Alfanumérico – Comprimento variável | 50 |
razao_social | Nome ou Razão Social | Nome ou Razão Social do prestador | Alfanumérico – Comprimento variável | 200 |
nome_comercial | Nome comercial | Nome comercial do prestador | Alfanumérico – Comprimento variável | 200 |
tipo_pessoa | Tipo de pessoa | Exibe o tipo de pessoa, sendo: F = Pessoa Física J = Pessoa Jurídica | Alfanumérico – Comprimento fixo | 1 |
codigo_pais | Código do país | Informa o código do país | Alfanumérico – Comprimento fixo | 3 |
data_inicio_vigencia | Data de início da vigência | Data de início da vigência | Data | AAAA-MM-DD |
data_fim_vigencia | Data de fim da vigência | Data de fim da vigência | Data | AAAA-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Classes
Este contexto é compreendido pelos dados básicos de detalhes da(s) classe(s).
Campos da lista classes:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_classe | Código da Classe | Exibe o código da classe | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_classe | Tipo de identificador da classe | Informa qual o tipo de identificador da classe | Alfanumérico – Comprimento variável | 11 |
identificador_classe | Identificador da classe | Valor do campo tipo de identificador da classe | Alfanumérico – Comprimento variável | 50 |
data_inicio_atividade_classe | Data início da atividade | Representa a primeira data de atividade | Data | AAAA-MM-DD |
razao_social_classe | Razão social | Razão social | Alfanumérico – Comprimento variável | 200 |
nome_comercial_classe | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
tributacao_perseguida | Tributação perseguida | Informa a tributação perseguida | Alfanumérico – Comprimento variável | 50 |
alavancado | Alavancado | Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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). Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
percentual_permitido_credito_privado | Percentual permitido de crédito privado | Indica o percentual de crédito privado permitido | Decimal | 5, 2 |
investimento_exterior | Investimento 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 %] | 50 |
percentual_permitido_investimento_exterior | Percentual permitido de investimento exterior | Indica o percentual de investimento exterior permitido | Decimal | 5, 2 |
foco_atuacao | Foco atuação | Indica o principal foco de atuação do fundo | Alfanumérico – Comprimento variável | 50 |
fundos_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: – Não – Não se Aplica – ND – Relacionado – Sim | Alfanumérico – Comprimento variável | 50 |
forma_condominio | Forma condomínio | Os fundos de investimento podem ser organizados sob a forma de condomínio aberto ou fechado | Alfanumérico – Comprimento variável | 50 |
responsabilidade_limitada | Responsabilidade limitada | Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
categoria_cvm | Categoria CVM | Nome da categoria CVM | Alfanumérico – Comprimento variável | 11 |
composicao | Composição da classe | CI (Classe de Investimento) CIC (Classe que Investe em Cotas) CIPC (Classe de Investimento para Classe) CICPC (Classe que Investe em Cotas Para Classe) | Alfanumérico – Comprimento variável | 50 |
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 | 50 |
nivel_1_categoria | Categoria nível 1 | Categoria nível 1 | Alfanumérico – Comprimento variável | 50 |
nivel_2_categoria | Categoria nível 2 | Categoria nível 2 | Alfanumérico – Comprimento variável | 50 |
nivel_3_subcategoria | Subcategoria nível 3 | Subcategoria nível 3 | Alfanumérico – Comprimento variável | 50 |
data_encerramento_classe | Data de encerramento | Informa a data de encerramento da classe | Data | AAAA-MM-DD |
data_vigencia_classe | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
sufixo | Sufixo | Sufixo da classe | Alfanumérico – Comprimento variável | 100 |
data_inico_vigencia | Data início da vigência | Data de início da vigência do sufixo | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência do sufixo | Data | AAAA-MM-DD |
infraestrutura | Infraestrutura | Indica se o fundo é de infraestrutura. Os possíveis valores para o campo são: Sim (S) Não (N) Não se aplica (NA) Não definido (ND) | Alfanumérico – Comprimento variável | 2 |
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 |
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 |
data_atualização | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Perfil complementar
Lista de campos perfil-complementar:
Esta lista contempla informações de perfil complementar que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
restricao_investimento | Restrição Investimento | Restrição de investimento | Alfanumérico – Comprimento variável | 50 |
tipo_investidor | Tipo de investidor | Tipo de investidor predominante | Alfanumérico – Comprimento variável | 50 |
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. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
plano_previdencia | Plano previdência | Informa o plano de previdência | Alfanumérico – Comprimento variável | 50 |
periodicidade_envio_pl_cota | Periodicidade envio PL cota | Periodicidade do envio PL Cota | Alfanumérico – Comprimento variável | 50 |
calculo_cota | Cálculo cota | Cálculo Cota | Alfanumérico – Comprimento variável | 50 |
codigo_b3 | Código B3 | Código B3 | Alfanumérico – Comprimento variável | 50 |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Taxas entrada e saída
Lista de campos taxas-entrada-saida:
Esta lista contempla informações de taxas de entrada e saida que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_entrada_saida | Tipo entrada e saída | Informa se a taxa é entrada ou saída | Alfanumérico – Comprimento fixo | 1 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Decimal | 7, 2 |
| data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
| data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
Taxas
Lista de campos taxas:
Esta lista contempla informações de taxas que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
tipo_taxa | Tipo taxa | Informa o tipo de taxa. Os possíveis valores para este campo são: – Global | Alfanumérico – Comprimento variável | 50 |
perfil_taxa | Perfil taxa | Perfil da taxa. Os possíveis valores para este campo são: – Fixa – Escalonada | Alfanumérico – Comprimento variável | 50 |
unidade_taxa | Unidade taxa | Unidade da taxa. Os possíveis valores para este campo são: – Valor – Percentual – % acrescido de valor – Maior entre % e valor – Outros | Alfanumérico – Comprimento variável | 50 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Decimal | 7, 2 |
valor_piso | Valor piso | Exibe o valor do piso | Decimal | 19, 2 |
valor_fixo | Valor fixo | Exibe o valor fixo | Decimal | 19, 2 |
valor_taxa_maxima | Valor taxa máxima | Exibe o valor monetário da taxa máxima | Decimal | 19, 2 |
valor_percentual_taxa_maxima | Valor percentual taxa máxima | Exibe o valor percentual da taxa máxima | Decimal | 7, 2 |
informacoes_adicionais | Informações adicionais | Exibe informações adicionais | Alfanumérico – Comprimento variável | 500 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
faixas_escalonamento | ||||
valor_faixa_pl_inicial | Valor faixa PL inicial | Exibe o valor inicial da faixa de patrimônio líquido | Decimal | 19, 2 |
valor_faixa_pl_final | Valor faixa PL final | Exibe o valor final da faixa de patrimônio líquido | Decimal | 19, 2 |
valor_monetario | Valor monetário | Exibe o valor monetário | Decimal | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Dacimal | 7, 2 |
Taxas de performance
Lista de campos taxas-performance:
Esta lista contempla informações de taxas de performance que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
perfil_taxa | Perfil taxa | Perfil da taxa. Os possíveis valores para este campo são: – Fixa – Escalonada | Alfanumérico – Comprimento variável | 50 |
periodicidade_cobranca | Periodicidade de cobrança | Periodicidade de cobrança da taxa. Os possíveis valores para este campo são: – Mensal – Bimestral – Trimestral – Semestral – Anual | Alfanumérico – Comprimento variável | 50 |
informacoes_adicionais | Informações adicionais | Informações adicionais | Alfanumérico – Comprimento variável | 500 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência da taxa | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência da taxa | Data | AAAA-MM-DD |
detalhes | ||||
valor_pl_inicial | Valor PL inicial | Valor inicial do patrimônio líquido | Decimal | 19, 2 |
valor_pl_final | Valor PL final | Valor final do patrimônio líquido | Decimal | 19, 2 |
valor_percentual | Valor percentual | Valor percentual da taxa | Decimal | 7, 2 |
indice_referência | Índice referência | Índice referência da taxa | Alfanumérico – Comprimento variável | 50 |
valor_percentual_indice_referencia | Valor percentual índice referência | Valor percentual do índice de referência | Decimal | 7, 2 |
valor_taxa_fixa | Valor taxa fixa | Valor da taxa fixa | Decimal | 7, 2 |
Valores mínimos movimentação
Lista de campos valores-minimos-movimentacao:
Esta lista contempla informações de valores mínimos de movimentação que podem ser da classe ou da subclasse.
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
data_vigencia | Data de vigência | Data de vigência | Data | AAAA-MM-DD |
indicador_prazo_emissao_cota | Indicador de prazo para emissão de cotas | Indicador de prazo para emissão de cotas. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
prazo_emissao_cota | Prazo para emissão de cotas | Prazo (em dias) para conversão das cotas para efeito de aplicação de recursos | Numérico | 11 |
indicador_prazo_conversao_resgate | Indicador de prazo para conversão de resgate | Indicador de prazo para conversão de resgate. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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 | Inteiro | 11 |
indicador_prazo_pagamento_resgate | Indicador de prazo para pagamento resgate | Indicador de prazo para pagamento resgate. Os possíveis valores para este campo são: – Sim (S) – Não (N) – Não se aplica (NA) – Não disponível (ND) | Alfanumérico – Comprimento fixo | 2 |
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 | Inteiro | 11 |
regra_adicional_pagamento_resgate | Regra adicional pagamento resgate | Regra adicional pagamento resgate | Alfanumérico – Comprimento variável | 150 |
dias_carencia_inicial | Carência inicial | Dias de carência inicial | Inteiro | 11 |
dias_carencia_ciclica | Carência cíclica | Dias de carência cíclica | Inteiro | 11 |
valor_minimo_aplicacao_inicial | 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 | 19,2 |
valor_minimo_aplicacao_subsequente | Valor mínimo aplicação subsequente | Decimal | 19,2 | |
valor_minimo_resgate | 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 | 19,2 |
valor_minimo_permanencia | Valor mínimo de permanência | Informa o valor mínimo de permanência | Decimal | 19,2 |
data_atualizacao | Data de atulização da informação | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Índices benchmark
Lista de campos indices-benchmark:
| Campo no Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
benchmark | Benchmark | Este campo indica o índice de referência de desempenho do fundo | Alfanumérico – Comprimento variável | 50 |
data_inicio_vigencia | Data início da vigência | Data de início da vigência do benchmark | Data | AAAA-MM-DD |
data_fim_vigencia | Data fim da vigência | Data de fim da vigência do benchmark | Data | AAAA-MM-DD |
data_atualizacao | Data de atulização da informação | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Subclasses
Lista de campos subclasses:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_subclasse | Código da Classe | Exibe o código da classe | Alfanumérico – Comprimento fixo | 11 |
tipo_identificador_subclasse | Tipo de identificador da subclasse | Informa qual o tipo de identificador da subclasse | Alfanumérico – Comprimento variável | 11 |
identificador_subclasse | Identificador da subclasse | Valor do campo de identificador da subclasse | Alfanumérico – Comprimento variável | 50 |
nome_comercial_subclasse | Nome comercial | Exibe o nome comercial | Alfanumérico – Comprimento variável | 200 |
data_inicio_atividade_subclasse | Data início da atividade | Representa a primeira data de atividade | Data | YYYY-MM-DD |
data_encerramento_subclasse | Data de encerramento da subclasse | Informa a data de encerramento da subclasse | Data | YYYY-MM-DD |
data_atualização | Data de atualização | Data e hora em que houve a última atualização das informações desse grupo | Data e hora | AAAA-MM-DDTHH:MM:SS.SSS |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Data de atualização | data-atualizacao=AAA-MM-DDTHH:MM:SS.SSS | Sim | GET https://api.anbima.com.br/feed/fundos/v2/fundos/dados-cadastrais/lote?data-atualizacao=2024-08-15T00:00:00.000 |
| Tipo de fundo | tipo-fundo=FIF | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/dados-cadastrais/lote?tipo-fundo=FIF |
| Página | page=1 | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/dados-cadastrais/lote?page=1 |
| Quantidade de fundos por página | size=250 | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/dados-cadastrais/lote?size=250 |
Lote – série histórica
Este endpoint divulga a lista completa de todos os fundos deste tipo e suas respectivas classes/séries de cota existentes na base do ANBIMA Feed. Se a subclasse vier preenchida, as informações de série histórica são referentes a subclasse. Se a subclasse vier nula, as informações de série histórica são referentes a classe.
Periodicidade de divulgação: Diária
Horário: Ao longo do dia
Para acessá-la, deve-se utilizar a seguinte URL:
https://[ambiente]/feed/fundos/v2/fundos/serie-historica/loteO 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/v2/fundos/serie-historica/loteCampos da lista content:
| Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
codigo_fundo | Código do fundo | Código de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
codigo_classe | Código da classe | Código de identificação da classe na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
codigo_subclasse | Código da subclasse | Código de identificação da subclasse na ANBIMA | Alfanumérico – Comprimento fixo | 11 |
valor_patrimonio_liquido | Valor do patrimônio líquido | Exibe o valor do patrimônio líquido da classe ou subclasse | Decimal | 21, 5 |
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 | 33, 17 |
valor_volume_total_aplicacoes | Valor volume total aplicações | Valor volume total aplicações | Decimal | 21, 5 |
valor_volume_total_resgates | Valor volume total resgates | Valor volume total resgates | Decimal | 21, 5 |
valor_volume_total_resgate_ir | Valor volume total resgate IR | Valor volume total resgate IR | Decimal | 21, 5 |
numero_cotistas | Número de cotistas | Número total de investidores | Numérico | 11 |
codigo_moeda | Identificação do tipo da moeda | BRL, USD ou EUR | Alfanumérico – Comprimento fixo | 3 |
data_competencia | Data competência | Informa a data de competência | Data | YYYY-MM-DD |
data_atualizacao | Data de atualização | Data e hora em que houve a última atualização | Data/hora | YYYY-MM-DD HH:MM:SS.SSS |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Data de atualização | data-atualizacao=AAA-MM-DDTHH:MM:SS.SSS | Sim | GET https://api.anbima.com.br/feed/fundos/v2/fundos/serie-historica/lote?data-atualizacao=2024-08-15T00:00:00.000 |
| Tipo de fundo | tipo-fundo=FIF | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/ |
| Quantidade de fundos por página | size=500 | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/ |
| Página | cursor=149cb4feffdab232b5e58347216af13a | Não | GET https://api.anbima.com.br/feed/fundos/v2/fundos/serie-historica/lote?cursor=149cb4feffdab232b5e58347216af13a |
Obs. 2: A quantidade máxima de registros por página é 1000.
Obs. 3: O valor padrão do bloco retornado para o parâmetro “size” é de 1000 registros . Qualquer valor maior que o tamanho máximo do bloco não irá retornar dados.
Obs. 4: Para avançar para a próxima página do bloco, basta utilizar o parâmetro “cursor” contendo o valor do campo “next_cursor” contido no final da página atual.