Beta 2 – API Fundos (RCVM 175) – versão 0.2.0

Essa documentação está em construção. Ela pode sofrer alterações conforme necessidade. Por favor, confira abaixo a versão vigente.

Publicado em 09/08/2024 | Versão 0.2.0 (Beta 2)

Versões da documentação

Versão: 0.2.0

Veja aqui todas as versões publicadas: Controle de versões do Beta v2 de Fundos de Investimentos

Corrigida a request de série histórica;
Adicionadas mais explicações sobre o “de/para” dos códigos ANBIMA para fundo e classes;
Adicionada documentação dos endpoints Detalhes – histórico, Fundos instituição, Fundos instituição – detalhes, Patrimônio líquido por Segmento do Investidor e Notas explicativas ;
Adicionado detalhamento de quais são os próximos endpoints no roadmap;
Adicionado detalhamento sobre a previsão de lançamento da versão Beta 3.

Sobre a versão 2 da API de Fundos

Com a nova resolução de fundos de investimento, a RCVM 175, no qual institui a possibilidade de estrutura multiclasses para todos os fundos, foi necessário a criação de uma nova versão de API. Atualmente disponibilizada em versão Beta 1.

Por que beta?

Estamos inicialmente disponibilizando uma versão Beta em sua primeira release, a Beta 1. Versão beta pois haverão mudanças em breve, contemplando novos endpoints e também a adição e revisão de informações já disponibilizadas.

Quando a fase de betas termina?

A API deve ficar em fase beta até o início da vigência da 175.

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:

O campo Código ANBIMA, identificador atual dos fundos, será refletido na RCVM 175 nos campos Código Fundo e Código Classe por meio de uma equivalência. Segue exemplo fictício dessa equivalência: um fundo atual cujo Código ANBIMA é 999999 receberá o Código Fundo F0000999999 e Código Classe C0000999999. Os campos Código Fundo e Código Classe são campos de 11 dígitos, nos formatos F9999999999 e C9999999999, respectivamente.
Mais informações de taxas serão disponibilizadas em breve.

Como acessar a fase beta

Disponibilizamos duas formas de consumo de um conjunto de dados não produtivos, criados especificamente para que você possa se familiarizar com a nova estrutura. Esses dados são exclusivamente para testes, ou seja, não representam os números reais da indústria.

Para cliente ANBIMA Feed que tenham acesso atualmente aos pacotes de produção como Fundos ICVM 555, Fundos Offshore, Fundos ETF ou Fundos Estruturados,
basta solicitar aqui por e-mail a liberação à base beta.

A base beta contém atualmente mais de 7.231 mil fundos do tipo FIF de exemplo.

Para novos clientes disponibilizamos um ambiente sandbox com dados em mock. São dados limitados e sem responder os parâmetros dos endpoints.
Nesse modelo não existe a necessidade de solicitar a liberação da base.

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]/beta/feed/fundos/v2/fundos

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 beta 1 seria:

GET https://api-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos

Campos 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-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos?page=1`
Quantidade de fundos por página	size=1000	Não	`GET https://api-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos?page=1&size=1000`
Tipo de fundo	tipo-fundo=FIF	Não	`GET https://api-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos?tipo-fundo=FIF`

Obs. 1: Se página e quantidade de registros não forem informados na consulta, por padrão são retornados os primeiros 1.000 fundos, ordenados pelo código do fundo, na página 0.
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]/beta/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 beta 1 seria:

GET https://api-sandbox.anbima.com.br/beta/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
`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 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	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
`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
`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

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_do_fundo}/historico

O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.

Um exemplo de chamada real em ambiente de produção seria:

GET https://api-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos/{codigo_do_fundo}/historico

Campos 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
`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_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_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
`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 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	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
`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

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-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-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos/{codigo classe ou subclasse}/serie-historica

Campos 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-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos/C0000000191/serie-historica`
Data inicial da consulta	data-inicio=YYYY-MM-DD	Não	`GET https://api-sandbox.anbima.com.br/beta/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-sandbox.anbima.com.br/beta/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-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos/C0000000191/serie-historicatualizacao=2024-01-01T00:00:00.000`

Obs. 1: Se data início e fim não forem determinadas na consulta, serão retornados os registros dos últimos 5 anos..
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/instituicoes

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-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos/instituicoes

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. 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`	–	–	–	–

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-sandbox.anbima.com.br/beta/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-liquido

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-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos/segmento-investidor/{codigo_classe_ou_subclasse}/patrimonio-liquido

Campos 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-sandbox.anbima.com.br/beta/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-sandbox.anbima.com.br/beta/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-sandbox.anbima.com.br/beta/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-explicativas

O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.

Um exemplo de chamada real em ambiente de produção seria:

GET https://api-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos/{codigo_classe_ou_subclasse}/notas-explicativas

Campos 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

Próximos endpoints

Seguem os próximos endpoints a serem disponibilizados:

Lote – dados cadastrais ^{(Em breve)}

Lote – série histórica ^{(Em breve)}

Lote – arquivo carga completa de dados cadastrais ^{(Em breve)}

Lote – arquivo carga completa de série histórica ^{(Em breve)}

Versões

Os próximos endpoints serão disponibilizados nas próximas versões das APIs de Fundos (RCVM 175).

Beta 3 – API Fundos (RCVM 175)

Previsão: 2º quinzena de agosto

Pricing and Indices

Beta 2 – API Fundos (RCVM 175) – versão 0.2.0

Versões da documentação

Sobre a versão 2 da API de Fundos

Por que beta?

Quando a fase de betas termina?

O que mudou da v1 para a v2 de fundos?

Observações:

Como acessar a fase beta

Lista

Detalhes

Content

Documentos

Prestadores de serviço

Classes

Perfil complementar

Taxas entrada e saída

Valores mínimos movimentação

Índices benchmark

Subclasses

Detalhes – histórico

Campos da lista content:

Série histórica

Fundos instituição

Fundos instituição – detalhes

Patrimônio líquido por Segmento do Investidor

Notas explicativas

Próximos endpoints

Lote – dados cadastrais (Em breve)

Lote – série histórica (Em breve)

Lote – arquivo carga completa de dados cadastrais (Em breve)

Lote – arquivo carga completa de série histórica (Em breve)

Versões

Beta 3 – API Fundos (RCVM 175)

Campos da lista `content`:

Lote – dados cadastrais ^{(Em breve)}

Lote – série histórica ^{(Em breve)}

Lote – arquivo carga completa de dados cadastrais ^{(Em breve)}

Lote – arquivo carga completa de série histórica ^{(Em breve)}