Fundos ICVM 555 – Lote

Fundos ETF – Lote

Dados cadastrais

Esta API divulga os dados referentes de todos os fundos deste tipo referentes às prévias das composições das carteiras teóricas do índice licenciado.

Periodicidade de divulgação: Diária

Horário: A partir das 19h30

Para acessá-la, deve-se utilizar a seguinte URL:

https://[ambiente]/feed/fundos/v1/fundos-etf/lote

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

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

GET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/lote

Lista de campos:

Campos de controle:

Campo no FeedInformaçãoTipo/TamanhoDescrição
totalElements  Total de fundos existentesNumérico(19)  Total de fundos deste tipo existentes na base da ANBIMA
size  Total de registros na páginaNumérico (19)  Total de registros retornados na página atual (veja mais em parâmetros e observações)
page  Número da páginaNumérico (19)  Número da página atual dentro do critério de paginação escolhido (veja mais em parâmetros e observações)
lastPageNúmero da última páginaNumérico (19)Número total de páginas a serem retornadas com o bloco de tamanho informado (veja mais em parâmetros e observações)
contentObjeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela Content)  

Content:

Campo no FeedInformaçãoTipo/TamanhoDescrição
Dados_cadastrais  Objeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela dados_cadastrais)  
prestadores  Objeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela prestadores)  
taxas  Objeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela taxas)  
movimentacaoObjeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela movimentacao)  
documentosObjeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela documentos)  
Serie_historicaObjeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela serie_historica)  
Historico_taxasObjeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela historico_taxas)  

Dados_cadastrais:

Campo no FeedInformaçãoTipo/TamanhoDescrição
codigo_fundo
Código ANBIMA
Alfanumérico – Comprimento fixo (6)Chave de identificação do fundo na ANBIMA
nome_fantasiaNome fantasia do fundoAlfanumérico – Comprimento variável (40)Nome pelo qual o fundo é conhecido
nome_fantasia_2Nome fantasia do fundoAlfanumérico – Comprimento variável (200)Nome pelo qual o fundo é conhecido
razao_socialRazão socialAlfanumérico – Comprimento variável (150)
Razão social do fundo
cnpj_fundoCNPJAlfanumérico – Comprimento variável (14)CNPJ do Fundo
código_isinISINAlfanumérico – Comprimento variável(12)Modelo de International Securities Identification Number. Código para identificação dos fundos de investimento, fornecido pela B3, quando este é registrado na referida bolsa como ativo
data_primeiro_aporte
Data do primeiro aporte do fundo
Data (YYYY-MM-DD)Data em que foi feito o primeiro aporte no fundo
data_encerramento_fundoData de encerramento do fundoData (YYYY-MM-DD)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”
classe_anbimaClasse ANBIMAAlfanumérico – Comprimento variável (20)A classificação ANBIMA busca agregar as diversas opções de carteira oferecidas por meio de fundos de investimento, de acordo com determinadas características do portfólio. Assim, ela leva em consideração as classes de ativos que compõem essa carteira, seus prazos e riscos, além dos estilos e estratégias de gestão.
Os possíveis valores para este campo são:
– Renda Fixa (RF)
– Ações
– Cambial
– Multimercado (MM)
– Previdência
tipo_anbimaTipo ANBIMAAlfanumérico – Comprimento variável (40)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
classe_cvmClasse CVMAlfanumérico – Comprimento variável (20)A regulamentação da CVM organiza os fundos de investimento em quatro diferentes classes. Conforme Art. 108, ICVM 555.
Os possíveis valores para este campo são:
– Renda Fixa (RF)
– Ações
– Cambial
– Multimercado (MM)
subclasse_cvmSubclasse CVMAlfanumérico – Comprimento variável (20)A regulamentação da CVM organiza os fundos de investimento em algumas diferentes subclasses. Conforme Art. 108 e suas Subseções ICVM 555.
Os possíveis valores para este campo são:
– Referenciados
– Curto Prazo
– Dívida Externa
– Ações BDR Nível 1
– Não se Aplica
composicao_fundoComposição do fundoAlfanumérico – Comprimento variável (20)– 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
benchmarkBenchmarkAlfanumérico – Comprimento variável (20)Este campo indica o índice de referência de desempenho do fundo
investimento_exteriorInvestimento no exteriorAlfanumérico – Comprimento variável (20)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
tipo_investidorTipo de investidorAlfanumérico – Comprimento variável (20)Restrição de investimento: tipo de investidor predominante. Os possíveis valores para este campo são:
– Exclusivo (fundo constituído para receber aplicações exclusivamente de um único cotista, conforme art. 130 da ICVM 555. Esse campo deve estar coerente com a descrição do público-alvo constante no regulamento do fundo)
– Reservado/restrito (grupo determinado de investidores, que tenham entre si vínculo familiar, societário ou pertençam a um mesmo grupo econômico, ou que, por escrito, determinem essa condição. Esse campo deve estar coerente com a descrição do público-alvo constante no regulamento do fundo)
– Não há restrição (investidores que apresentam características diferentes de exclusivos e reservados/restritos)
caracteristica_investidorCaracterística do investidorAlfanumérico – Comprimento variável (20)No caso brasileiro, a Instrução nº 554/14, da CVM, que altera, entre outros normativos, a Instrução nº 539/13, divide os investidores em três grupos: investidores profissionais, investidores qualificados e os demais investidores, a quem podemos nos referir como investidores de varejo.
Consideram-se investidores profissionais pessoas naturais ou jurídicas que possuam investimentos financeiros em valor superior a R$ 10.000.000,00 (dez milhões de reais) e que, adicionalmente, atestem por escrito sua condição de investidor profissional (art. 9º-A, ICVM 554)
Consideram-se investidores qualificados pessoas naturais ou jurídicas que possuam investimentos financeiros em valor superior a R$ 1.000.000,00 (um milhão de reais) e que, adicionalmente, atestem por escrito sua condição de investidor qualificado (art. 9º-B, ICVM 554).
Consideram-se investidores não qualificados aqueles que apresentam características diferentes de profissional e qualificado
cota_aberturaCota de aberturaAlfanumérico – Comprimento fixo(1)A Cota de abertura é aquela que é apurada e conhecida no início do dia. Já a cota de fechamento é aquela que é apurada e conhecida apenas no fechamento do dia, ou seja, após o encerramento dos mercados. Os possíveis valores para este campo são:
S = Sim (cota de abertura)
N = Não (cota de fechamento)
permite_alavancagemFundo permite alavancagemAlfanumérico – Comprimento fixo(20)O fundo é considerado alavancado sempre que existir possibilidade (diferente de zero) de perda superior ao patrimônio do fundo, desconsiderando-se casos de default nos ativos do fundo.
aberto_estatutariamente

Aberto estatutariamenteAlfanumérico – Comprimento fixo(1)Os fundos de investimento podem ser organizados sob a forma de condomínio aberto ou fechado, conforme disposto no art. 4º da ICVM 555. Os possíveis valores para este campo são:
S = aberto estatutariamente (os cotistas podem solicitar o resgate de suas cotas a qualquer tempo)
N = fechado estatutariamente (os cotistas podem resgatar suas cotas ao término do prazo de duração do fundo)
tributacao_alvoTributação alvoAlfanumérico – Comprimento variável[Longo Prazo, Curto Prazo, Renda Variável, Indefinido, ND, Não Aplicável](50)Indica o tratamento tributário perseguido pelo fundo para efeito de cobrança de imposto de renda do cotista
data_atualizacaoData de AtualizaçãoData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto
data_referenciaData de ReferênciaData (AAAA-MM-DD)Data de referência das taxas e informações apresentadas.
situacao_atualSituação atual do FundoAlfanumérico – Comprimento fixo(1)Indicador sobre o status atual do fundo quanto à novos aportes. Os possíveis valores para este campo são:
A = Ativo
E = Encerrado
multigestorMultigestorAlfanumérico – Comprimento variável(20)Indica se o fundo é multigestor (investe em outros fundos), espelho, feeder ou nenhuma das opções
aplicacao_automaticaAplicação automáticaAlfanumérico – Comprimento variável(20)Indica se o fundo permite que o cotista realize aplicações ou resgates automáticos de valores de suas contas no mesmo
fundo_adaptado_icvm_175Fundo Adaptado a CVM 175Alfanumérico – Comprimento fixo
(1)
Informa que o fundo está adaptado a CVM 175. Os possíveis valores para o campo são:
S = Sim
N = Não
data_fundo_adaptado_icvm_175Data do fundo adaptado a CVM 175Data
(YYYY-MM-DD)
Se o fundo já for adaptado a CVM 175, informada a data na qual ocorreu
responsabilidade_ltdaResponsabilidade LimitadaAlfanumérico – Comprimento variável
(50)
Informa se o fundo possui responsabilidade limitada

Lista de campos  Prestadores:

Campo no FeedInformaçãoTipo/TamanhoDescrição
administrador  AdministradoresObjeto JSONResponsável por todos os serviços relacionados ao funcionamento e manutenção do fundo
gestores  GestoresObjeto JSONResponsável pela gestão dos ativos do fundo
distribuidores  DistribuidoresObjeto JSONResponsável pelo relacionamento e vendas para com o investidor final
custodiantes  CustodiantesObjeto JSONResponsável por manter e guardar os ativos do fundo de investimento
controlador_ativo  Controlador de AtivosObjeto JSONResponsável pela execução dos processos ligados ao controle dos ativos, bem como os procedimentos contábeis
controlador_passivo_escrituradorControlador de PassivosObjeto JSONResponsável pela execução dos processos ligados ao controle dos passivos, bem como os procedimentos contábeis
  data_atualizacao  Data de AtualizaçãoData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto

Lista de campos Prestadores (Objeto JSON):

Campo no FeedInformaçãoTipo/TamanhoDescrição
nome  Nome do Prestador de ServiçoAlfanumérico – Comprimento variável(40)Este campo informa o nome dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores.
cnpj  CNPJ do Prestador de ServiçoAlfanumérico – Comprimento variável(14)Este campo informa o cnpj dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores
principal  Gestor principalBoolean (TRUE, FALSE) (1)Indica se este prestador é o principal gestor do fundo.

Lista de campos Taxas do Fundo:

Campo no FeedInformaçãoTipo/TamanhoDescrição
unidade    Unidade da taxa de administraçãoAlfanumérico – Comprimento fixo(1)É a remuneração pelos serviços de administração, conforme art. 85 da ICVM 555.Os possíveis valores para este campo são:- Percentual (P)- Valor (V)- Misto (M)
cobra_taxa_performance    Cobra taxa performanceAlfanumérico – Comprimento fixo(1)Taxa de performance é cobrada do cotista quando a rentabilidade do fundo supera a de um indicador de referência, conhecido como benchmark, e existe uma periodicidade mínima para sua cobrança. Os possíveis valores para o campo são:
S = Sim (Cobra taxa)
N = Não (Não cobra taxa)
taxa_composta    Taxa compostaAlfanumérico – Comprimento fixo(1)Este campo informa quando existe a possibilidade de as taxas cobradas pelos fundos investidos incidirem sobre o fundo objeto de cadastro.
Os possíveis valores para o campo são:
S = Sim (taxa incide sobre o fundo)
N = Não (taxa não incide sobre o fundo)
taxa_maximaTaxa de administração máximaDecimal (tamanho 23 com 6 casas decimais)É o percentual máximo da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa máxima explicitada no regulamento
taxa_administracao    Taxa de AdministraçãoDecimal (tamanho 23 com 6 casas decimais)Responsável por manter e guardar os ativos do fundo de investimentoPercentual da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa explicitada no regulamento
taxa_fixaTaxa FixaAlfanumérico – Comprimento variável (23)Informa o percentual de taxa fixa do fundo, caso se aplique
data_inicio_vigencia_taxa_adm  Data de início de vigência da Taxa de AdministraçãoData/hora(YYYY-MM-DD HH:MI:SS)Indica quando a Taxa de Administração começou a ser praticada
data_atualizacao  Data de AtualizaçãoData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto

Lista de campos Movimentação de Cotas:

Campo no FeedInformaçãoTipo/TamanhoDescrição
prazo_emissao_cotas      Prazo para emissão de cotasAlfanumérico – Comprimento variável(40)Prazo (em dias) para conversão das cotas para efeito de aplicação de recursos
prazo_pagamento_resgate      Prazo pagamento resgateAlfanumérico – Comprimento variável(40)Prazo para pagamento do resgate solicitado, ou seja, o número de dias após a data de solicitação do resgate
prazo_conversao_resgate      Prazo de conversão do resgateAlfanumérico – Comprimento variável(40)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
carencia_inicial_primeiro_resgateCarência inicial para 1º resgateNumérico(19)Indica se o fundo estabelece um período em que o investidor não pode resgatar os recursos aplicados no fundo.Carência inicial: prazo mínimo (em dias) a ser respeitado pelo cotista para efetuar resgate a partir de cada aplicação no fundo.
carencia_ciclica      Carencia ciclica (tempo entre resgates)Numérico(19)Carência cíclica: intervalo de tempo periódico (em dias) a ser respeitado pelo cotista entre um resgate e outro.
aplicacao_inicial_minima    Aplicação inicial mínimaDecimal(18)IRefere-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.
aplicacao_adicional_minimaAplicação adicional mínimaDecimal(18)Refere-se ao mínimo aceitável para efetuar aplicações/movimentação e para manter-se no fundo. Aplicação adicional: mínimo para aplicações posteriores.
resgate_minimo  Resgate mínimoDecimal(18)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.
saldo_minimo_aplicado_ao_fundo  Saldo mínimo aplicado ao fundoDecimal(18)Refere-se ao mínimo aceitável para efetuar aplicações/movimentação e para manter-se no fundo. Saldo mínimo: valor mínimo para permanência no fundo
divulgacao_cotaPeriodicidade de divulgação de cotaAlfanumérico – Comprimento variável(10)Indica a periodicidade com a qual o administrador do fundo se responsabiliza por atualizar as informações periódicas. Os possíveis valores para este campo são:
– DIARIA
– SEMANAL
– MENSAL
– ANUAL
data_inicio_divulgacao_cota  Data de início de divulgação de cotas do fundoData (AAAA-MM-DD)Representa a primeira data de registro de dados periódicos do fundo
data_atualizacao  Data de AtualizaçãoData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto
data_referencia    Data de ReferênciaData (AAAA-MM-DD)Data de referência das taxas e informações apresentadas.

Lista de campos Documentos:

Campo no FeedInformaçãoTipo/TamanhoDescrição
url        URL do DocumentoAlfanumérico – Comprimento variável(500)Endereço eletrônico do arquivo
extensao        Extensão do DocumentoAlfanumérico – Comprimento variável(50)As extensões de arquivos são sufixos que designam seu formato. Exemplos: txt, doc, pdf, exe, etc.
codigo_fundo        Código ANBIMAAlfanumérico – Comprimento fixo (6)Chave de identificação do fundo na ANBIMA
tipo_documento        Tipo de DocumentoAlfanumérico – Comprimento variável(100)Informa o tipo de documento a qual o arquivo se refere. Exemplos: Regulamento, Auditoria, Assembleia, etc.
nome_arquivo    Nome do ArquivoAlfanumérico – Comprimento variável(255)Nome do Arquivo

Lista de campos Série Histórica:

Campo no FeedInformaçãoTipo/TamanhoDescrição
patrimonio_liquido          Patrimônio Líquido do FundoAlfanumérico – Comprimento variável(500)Informa o patrimônio líquido do fundo no dia.O patrimônio líquido é calculado pela soma do valor de todos os títulos e do valor em caixa, menos as obrigações do fundo, inclusive aquelas relativas à sua administração.
valor_cota          Valor da Cota do FundoAlfanumérico – Comprimento variável(50)Valor da cota do fundo no dia.As cotas são frações do valor do patrimônio do fundo.
captacao          Captação (novos aportes)Alfanumérico – Comprimento fixo (6)Valor total de novos aportes no fundo até a última data de registro
resgate          Resgates (novos saques)Alfanumérico – Comprimento variável(100)Soma dos valores resgatados por cotistas e dos resgates de IR
resgate_detalhamento  Detalhes dos resgatesObjeto JSONDetalhamento dos dados dos resgates. Veja lista de campos Detalhamento dos Resgates nas tabelas seguinte.
data_atualizacao    Data/horaData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto
data_referenciaData de ReferênciaData (AAAA-MM-DD)Data de referência das taxas e informações apresentadas.

Lista de campos Detalhes dos resgates:

Campo no FeedInformaçãoTipo/TamanhoDescrição
resgates_irValor do IRNumérico (14)Valor do imposto de renda que incidiu sobre os resgates.
resgates_cotista   

Lista de campos Histórico Taxas:

Campo no FeedInformaçãoTipo/TamanhoDescrição
unidade            Unidade da taxa de administraçãoAlfanumérico – Comprimento fixo(1)É a remuneração pelos serviços de administração, conforme art. 85 da ICVM 555.Os possíveis valores para este campo são:- Percentual (P)- Valor (V)- Misto (M)
cobra_taxa_performance            Cobra taxa performanceAlfanumérico – Comprimento fixo(1)Taxa de performance é cobrada do cotista quando a rentabilidade do fundo supera a de um indicador de referência, conhecido como benchmark, e existe uma periodicidade mínima para sua cobrança.Os possíveis valores para o campo são:S = Sim (Cobra taxa)N = Não (Não cobra taxa)
taxa_performance_nao_padronizadaTaxa de performance não padronizada (regras)Alfanumérico – Variável(500)Este campo define quais as regras de cobrança de taxa de performance do fundo
taxa_composta            Taxa compostaAlfanumérico – Comprimento fixo(1)Este campo informa quando existe a possibilidade de as taxas cobradas pelos fundos investidos incidirem sobre o fundo objeto de cadastro.
Os possíveis valores para o campo são:
S = Sim (taxa incide sobre o fundo)
N = Não (taxa não incide sobre o fundo)
taxa_entradaTaxa de entradaAlfanumérico – Variável (40)Taxa cobrada no momento da aplicação de recursos no fundo
taxa_saidaTaxa de saídaAlfanumérico – Variável (40)Taxa cobrada sobre o valor do resgate
periodicidade_cobranca_taxa_performancePeriod. de cobrança da taxa de performanceNumérico(19)Informa a periodicidade em que a taxa de performance é cobrada
data_inicio_vigencia_taxa_adm            Data de início de vigência da Taxa de AdministraçãoData e Hora (YYYY-MM-DD HH:MI:SS)Indica quando a Taxa de Administração começou a ser praticada
taxa_maximaTaxa de administração máximaDecimal (tamanho 23 com 6 casas decimais)É o percentual máximo da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa máxima explicitada no regulamento.
taxa_administracaoTaxa de AdministraçãoDecimal (tamanho 23 com 6 casas decimais)Percentual da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa explicitada no regulamento.
data_atualizacao    Data/horaData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Páginapage=0NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/lote?page=1
Quantidade de fundos por páginasize=300NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/lote?page=1&size=300

Obs. 1: Se página e quantidade de registros não forem informados na consulta, por padrão são retornados os primeiros 300 fundos, ordenados pelo código do fundo, na página 0.

Obs. 2: A quantidade máxima de registros por página é 300.

Obs. 3: O valor padrão do bloco retornado para o parâmetro “size” é de 300 registros .  Qualquer valor menor que o tamanho mínimo do bloco ou maior que o tamanho máximo do bloco irá retornar o valor padrão. Se você precisar de um bloco intermediário, especifique um valor no intervalo da centena de cada bloco, respeitando os valores mínimos e máximos.

Por exemplo:

  1. Size variando de 0 a 100, retornará 100 registros.
  2. Size variando de 101 a 200, retornará 200 registros.
  3. Size variando de 201 a 300, retornará 300 registros.
  4. Size variando de 301 a 400, retornará 400 registros.
  5. Size variando de 401 a n, retornará 500 registros.

Notas Explicativas do Fundo

Esta API divulga a lista de notas explicativas de todos os fundos deste tipo. Estas notas explicativas indicam eventos relevantes que ocorreram no fundo e foram registrados na base da ANBIMA.

Periodicidade de divulgação: Diária

Horário: A partir das 19h30

Para acessá-la, deve-se utilizar a seguinte URL:

https://[ambiente]/feed/fundos/v1/fundos-etf/notas-explicativas/lote

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

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

GET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/notas-explicativas/lote

Lista de campos:

Campos de controle:

Campo no FeedInformaçãoTipo/TamanhoDescrição
totalElements  Total de fundos existentesNumérico(19)Total de fundos deste tipo existentes na base da ANBIMA
size  Total de registros na páginaNumérico (19)Total de registros retornados na página atual (veja mais em parâmetros e observações)
page  Número da páginaNumérico (19)Número da página atual dentro do critério de paginação escolhido (veja mais em parâmetros e observações)
lastPage  Número da última páginaNumérico (19)Número total de páginas a serem retornadas com o bloco de tamanho informado (veja mais em parâmetros e observações)
content    Objeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela Content)

Content:

Campo no FeedInformaçãoTipo/TamanhoDescrição
codigo_fundo  Código anbima do fundoNumérico (6)Código Anbima do Fundo
notas_explicativas  Objeto JSON contendo os dados de notas explicativasObjeto JSONTotal de registros retornados na página atual (veja mais na tabela Notas_explicativas)

Notas_explicativas

Campo no FeedInformaçãoTipo/TamanhoDescrição
descricao  Descrição da nota explicativaAlfanumérico (80)Texto da nota explicativa
data_referencia  Data de referênciaData/hora (YYYY-MM-DD HH-MM-SSData em que a nota explicativa foi gerada
ano_divulgacaoAnoNumérico(4)Ano correspondente da nota explicativa

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Páginapage=0NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/notas-explicativas/lote?page=0
Quantidade de fundos por páginasize=75NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/notas-explicativas/lote?page=1&size=75

Obs. 1: Se página e quantidade de registros não forem informados na consulta, por padrão são retornados os primeiros 75 fundos, ordenados pelo código do fundo, na página 0.

Obs. 2: A quantidade máxima de registros por página é 75.

Obs. 3: O valor padrão do bloco retornado para o parâmetro “size” é de 75 registros .  Qualquer valor menor que o tamanho mínimo do bloco ou maior que o tamanho máximo do bloco irá retornar o valor padrão. Se você precisar de um bloco intermediário, especifique um valor no intervalo da centena de cada bloco, respeitando os valores mínimos e máximos.

Por exemplo:

  1. Size variando de 0 a 100, retornará 100 registros.
  2. Size variando de 101 a 200, retornará 200 registros.
  3. Size variando de 201 a 300, retornará 300 registros.
  4. Size variando de 301 a 400, retornará 400 registros.
  5. Size variando de 401 a n, retornará 500 registros.

Série Histórica

Esta API divulga os dados detalhados de um fundo ETF.

Periodicidade de divulgação: Diária

Horário: A partir das 19h30

Para acessá-la, deve-se utilizar a seguinte URL:

https://[ambiente]/feed/fundos/v1/fundos-etf/serie-historica/lote

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

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

GET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/serie-historica/lote

Campos de controle:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
totalElements  Total de fundos existentesNumérico(19)Total de fundos deste tipo existentes na base da ANBIMA
size  Total de registros na páginaNumérico(19)Total de registros retornados na página atual (veja mais em parâmetros e observações)
page  Número da páginaNumérico(19)Número da página atual dentro do critério de paginação escolhido (veja mais em parâmetros e observações)
lastPage  Número da última páginaNumérico(19)Número total de páginas a serem retornadas com o bloco de tamanho informado (veja mais em parâmetros e observações)
content Lista de Objetos JSONLista com toda séria histórica dos fundos. Veja a tabela Lista de campos


Lista de campos:

Campo no FeedInformaçãoTipo/TamanhoDescrição
codigo_fundoCódigo ANBIMAAlfanumérico – Comprimento fixo (6)Chave de identificação do fundo na ANBIMA
serie_historica Lista de Objetos JSONLista com todo o histórico (diário) de dados periódicos (PL e cota) das séries histórica do fundo. Veja a tabela Lista de campos Série Histórica

Lista de campos Série Histórica:


Campo no Feed
InformaçãoTipo/Tamanho
Descrição
patrimonio_liquidoPatrimônio Líquido do FundoNumérico (14)Informa o patrimônio líquido do fundo no dia. O patrimônio líquido é calculado pela soma do valor de todos os títulos e do valor em caixa, menos as obrigações do fundo, inclusive aquelas relativas à sua administração.
valor_cotaValor da Cota do FundoNumérico (17)Valor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo.
captacaoCaptação (novos aportes)Numérico (14)Valor total de novos aportes no fundo até a última data de registro
resgateResgates (novos saques)Numérico (14)Soma dos valores resgatados por cotistas e dos resgates de IR
resgate_detalhamentoDetalhes dos resgatesObjeto JSONDetalhamento dos dados dos resgates. Veja Lista de campos Detalhamento do Resgate nas tabelas seguinte.
numero_cotistas
Número de Cotistas
Numérico (10)Número total de investidores do fundo
data_atualizacaoData/horaData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto
data_referenciaData de ReferênciaData (AAAA-MM-DD)Data de referência das taxas e informações apresentadas.


Lista de campos Detalhamento dos resgates:

Campo no FeedInformaçãoTipo/TamanhoDescrição
resgates_irValor do IRDecimal(14)Valor do imposto de renda que incidiu sobre os resgates.
resgates_cotistaValor dos resgatesDecimal(14)Soma dos valores resgatados por cotistas

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Páginapage=0NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/serie-historica/lote?page=1
Quantidade de fundos por páginasize=50NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-etf/serie-historica/lote?page=1&size=100

Obs. 1: Se página e quantidade de registros não forem informados na consulta, por padrão são retornados os primeiros 50 fundos, ordenados pelo código do fundo, na página 0.

Obs. 2: A quantidade máxima de registros por página é 250.

Obs. 3: O valor padrão do bloco retornado para o parâmetro “size” é de 50 registros .  Qualquer valor menor que o tamanho mínimo do bloco ou maior que o tamanho máximo do bloco irá retornar o valor padrão. Se você precisar de um bloco intermediário, especifique um valor no intervalo da centena de cada bloco, respeitando os valores mínimos e máximos.

Por exemplo:

  1. Size variando de 0 a 50, retornará 50 registros.
  2. Size variando de 51 a 100, retornará 100 registros.
  3. Size variando de 101 a 150, retornará 150 registros.
  4. Size variando de 151 a 200, retornará 200 registros.
  5. Size variando de 201 a n, retornará 250 registros.