Essa documentação está em construção. Ela pode sofrer alterações conforme necessidade. Por favor, confira abaixo a versão vigente.
Publicado em 22/07/2024 | – Versão 0.1.0 (Beta 1 – vigente)
Veja aqui todas as versões publicadas: Controle de versões do Beta v2 de Fundos de Investimentos
Sobre a versão 2
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.
Como acessar a beta 1
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 1.
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 de fundos
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. 2: A quantidade máxima de registros por página é 1.000.
Obs. 3: Caso seja informado um valor superior ao limite de páginas existentes, é retornado um erro ‘404 Not Found’.
Detalhes do fundo
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/{codigoFundo}
O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de beta 1 seria:
GET https://api-sandbox.anbima.com.br/beta/feed/fundos/v2/fundos/{codigoFundo}
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 | Numérico | 19, 2 |
valor_percentual | Valor percentual | Exibe o valor percentual | Numérico | 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 | 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 | Numérico | 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 variável | 150 |
dias_carencia_inicial | Carência inicial | Dias de carência inicial | Numérico | 11 |
dias_carencia_ciclica | Carência cíclica | Dias de carência cíclica | Numérico | 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 | Tipo entrada e saída | Informa se a taxa é entrada ou saída | 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 | 50 |
Série Histórica do Fundo
Esta API 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/serie-historica/{codigo 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-sandbox.anbima.com.br/beta/feed/fundos/v2/serie-historica/{codigo classe ou subclasse}
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.anbima.com.br/feed/fundos/v2/serie-historica/546356 |
Data inicial da consulta | data-inicio=YYYY-MM-DD | Não | GET https://api.anbima.com.br/feed/fundos/v2/serie-historica/546356?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/serie-historica/546356?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/serie-historica/546356?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).