Fundos ICVM 555 – Lote

Fundos Estruturados – Lote

Dados cadastrais

Esta api divulga os dados básicos de identificação de todos os fundos deste tipo.

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-estruturados/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-estruturados/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)  
Historico_taxasObjeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela historico_taxas)  
Classe_serie_cotaObjeto JSONLista de Objetos JSONObjeto JSON com os dados (veja mais na tabela classe_serie_cota)

Dados_cadastrais:

Campo no FeedInformaçãoTipo/TamanhoDescrição
cnpj_fundo  
CNPJ
Alfanumérico – Comprimento variável (14)CNPJ do Fundo
razao_socialRazão socialAlfanumérico – Comprimento variável (150)
Razão social do fundo
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
categoria_anbimaCategoria ANBIMAAlfanumérico – Comprimento variável(20)Neste nível os fundos são classificados conforme o tipo de gestão.
composicao_fundoComposição do FundoAlfanumérico – Comprimento variável (40)– 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.
classe_cvmClasse CVMAlfanumérico – Comprimento variável (20)Este campo informa a qual classe CVM o fundo faz parte.
foco_atuacaoFoco de AtuaçãoAlfanumérico – Comprimento variável (20)Indica o principal foco de atuação do fundo.
cota_aberturaCota de aberturaAlfanumérico – Comprimento fixo (1)Informa o prazo de duração do fundo caso ele seja determinado.
aberto_estatutariamenteAberto 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
data_atualizacao    Data de AtualizaçãoData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto
tributacao_alvo    Tributaçã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.
esgESG – Environmental, Social and Governance (Ambiental, Social e Governança Corporativa)Alfanumérico – Comprimento fixo (1)Indica se o fundo segue as práticas ESG. Os possíveis valores para este campo são:
– Sim (S)
– Não (N)
– Relacionado (R)

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
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
auditor_independente  Auditor IndependenteObjeto JSONResponsável por analisar as contas e as operações do fundo e, de forma independe, emitir um parecer.
  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:

Campo no FeedInformaçãoTipo/TamanhoDescrição
unidade_taxa_adm      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)
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.
unidade_tempo_taxa_admUnidade de Tempo da Taxa de AdministraçãoAlfanumérico – Comprimento variável(6)Informa a unidade de tempo em que a taxa de administração é definida.
base_calculo_taxa_adm    Base para Cálculo da Taxa de AdministraçãoAlfanumérico – Comprimento variável(6)Informa a unidade de tempo em que a taxa de administração é definida.
metodologia_calculo_taxa_adm      Metodologia para o Cálculo da Taxa de AdministraçãoAlfanumérico – Comprimento variável(20)Informa a metodologia utilizada no cálculo da taxa de cobrança.
periodicidade_cobranca_taxa_adm      Periodicidade de Cobrança da Taxa de AdministraçãoAlfanumérico – Comprimento variável(15)Indica a periodicidade de cobrança da taxa de administração.
taxa_compostaTaxa 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 – Comprimento variável (40)Taxa cobrada no momento da aplicação de recursos no fundo
taxa_saidaTaxa de saídaAlfanumérico – Comprimento variável (40)Taxa cobrada sobre o valor do resgate
taxa_fixa  Taxa FixaAlfanumérico – Comprimento variável (23)Informa o percentual de taxa fixa do fundo, caso se aplique.
periodicidade_cobranca_taxa_performancePeriodicidade 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/hora(YYYY-MM-DD HH:MI:SS)Indica quando a Taxa de Administração começou a ser praticada
descricao_taxa_performanceDescrição da Taxa de PerformanceAlfanumérico – Comprimento variável(200)Descreve como ocorre a cobrança de taxa de performance.
taxa_performance_nao_padronizadaTaxa de Performance não Padronizada (regras)Alfanumérico – Comprimento variável(500)Este campo define quais as regras de cobrança de taxa de performance do fundo.
cobra_taxa_performance  Cobra Taxa de Performance?Alfanumé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_maximaTaxa de Administração MáximaDecimal(23)É 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.
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 Histórico de Taxas:

Campo no FeedInformaçãoTipo/TamanhoDescrição
unidade_taxa_adm        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)
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.
cobra_taxa_performance        Cobra Taxa de Performance?Alfanumé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)
periodicidade_cobranca_taxa_performancePeriodicidade 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 (AAAA-MM-DD)Indica quando a taxa de administração começou a ser praticada.
descricao_taxa_performanceDescrição da Taxa de PerformanceAlfanumérico – Comprimento variável(200)Descreve como ocorre a cobrança de taxa de performance.
taxa_performance_nao_padronizadaTaxa de Performance não Padronizada (regras)Alfanumérico – Comprimento variável(500)Este campo define quais as regras de cobrança de taxa de performance do fundo.
taxa_composta    Taxa Composta?Alfanumé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_fixa  Taxa FixaAlfanumérico – Comprimento variável(1)Informa o percentual de taxa fixa do fundo, caso se aplique.
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.
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 Classes Série Cotas:

Campo no FeedInformaçãoTipo/TamanhoDescrição
dados_cadastrais          Dados cadastraisObjeto JSONDados básicos de identificação de um fundo. Veja lista de campos Dados cadastrais nas tabelas seguintes.
movimentacao          MovimentaçãoObjeto JSONInformações de aportes, resgates e demais movimentações de cotas em um fundo.Veja lista de campos Movimentação nas tabelas seguintes.
serie_historica          Série HistóricaObjeto JSONApresenta os dados periódicos (PL e cota) das classes/séries de cota de um fundo na última data disponível. Para calcular os valores referentes ao fundo como um todo, basta somar os valores dos campos de todas as séries/classes de cota.Veja lista de Série Histórica nas tabelas seguintes.

Lista de campos Dados cadastrais:

Campo no FeedInformaçãoTipo/TamanhoDescrição
codigo_anbima            Código ANBIMAAlfanumérico – Comprimento fixo (6)Chave de identificação da classe/série de cota do fundo na ANBIMA.
nome_fantasia            Nome FantasiaAlfanumérico – Comprimento variável (40)Nome pelo qual o fundo é conhecido.
nome_fantasia_2Nome FantasiaAlfanumérico – Comprimento variável (200)Nome pelo qual o fundo é conhecido.
tipo_classe_cota            Tipo Classe de CotaAlfanumérico – Comprimento variável (15)Informa a classe de cota do fundo estruturado a qual os dados se referem. Exemplo: Sênior, Mezanino, Subordinada, 1, 2, A, B, etc.
data_primeiro_aporte            Data do Primeiro Aporte no FundoData (AAAA-MM-DD)Data em que foi feito o primeiro aporte no fundo.
data_inicio  Data de inícioData (AAAA-MM-DD)Data de início do fundo
data_inicio_divulgacao_cota  Data de inicio de divulgação.Data (AAAA-MM-DD)Data de início de Divulgação de Cotas do Fundo
data_encerramentoData de Encerramento do FundoData (AAAA-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”
situacao_atual  Situação atual do FundoAlfanumérico – Comprimento fixo(1)Indicador sobre o status atual quanto à novos aportes. Os possíveis valores para este campo são:
A = Ativo
E = Encerrado
restrito  Restrito?Alfanumérico – Comprimento variável(20)Informa se este fundo é restrito, ou seja, se possui limitação para a quantidade de cotistas que podem aportar capital.
investidor_qualificadoInvestidor Qualificado?Alfanumérico – Comprimento variável(1)nforma se este fundo permite apenas investidores qualificados. Os possíveis valores para este campo são:
S = Sim
N = Não
benchmarkBenchmarkAlfanumérico – Comprimento variável(1)Este campo indica o índice de referência de desempenho do fundo.
data_atualizacao Data/horaData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto
isinCódigo Isin do títuloAlfanumé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
aberto_estatutariamenteAberto 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)
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 Movimentação:

Campo no FeedInformaçãoTipo/TamanhoDescrição
periodicidade_divulgacao_cotaPeríodicidade de divulgaçãoAlfanumérico – Comprimento variável(15)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:
– 1
– 7
– 28
– 365
saldo_minimo_aplicado_ao_fundoSaldo Mínimo Aplicado ao FundoDecimal(19)Valor mínimo para permanência no fundo.
aplicacao_inicial_minimaAplicação Inicial MínimaDecimal(18)Mínimo de aporte aceito para ingresso no fundo.
aplicacao_adicional_minimaAplicação Adicional MínimaDecimal(18)Mínimo aceito para aplicações posteriores no fundo.
resgate_minimoResgate MínimoDecimal(18)Valor mínimo aceito para retirada de recursos do fundo.
data_atualizacaoData/horaData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto

Lista de campos Série Histórica:

Campo no FeedInformaçãoTipo/TamanhoDescrição
data_referenciaData de ReferênciaData (AAAA-MM-DD)Data de referência das taxas e informações apresentadas.
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 JSON Detalhamento dos dados dos resgates. Veja lista de campos Detalhamento dos Resgates nas tabelas seguinte.
numero_cotistasNúmero de CotistasNumérico(5)Número total de investidores.
data_atualizacao Data/horaData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto

Lista de campos Detalhes dos resgates:

Campo no FeedInformaçãoTipo/TamanhoDescrição
resgates_irValor do IRNumérico (14)Valor do imposto de renda “come-cotas”
resgates_cotistaValor do resgate realizado por cotistasNumérico (14)Valor dos resgates realizados pelos cotistas do fundo

Parâmetros:

Tipo parâmetroFormatoObrigatórioExemplo de consulta
Páginapage=0NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/lote?page=0
Quantidade de fundos por páginasize=300NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/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 300, retornará 300 registros.
  2. Size variando de 301 a 600, retornará 600 registros.
  3. Size variando de 601 a 900, retornará 900 registros.
  4. Size variando de 901 a 1200, retornará 1200 registros.
  5. Size variando de 1201 a n, retornará 1500 registros.

Notas Explicativas do Fundo

Esta API divulga a lista de notas explicativas de todos os fundos deste tipo existentes na base da Anbima. 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-estruturados/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-estruturados/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-estruturados/notas-explicativas/lote?page=0
Quantidade de fundos por páginasize=100NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/notas-explicativas/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 100 fundos, ordenados pelo código do fundo, na página 0.

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

Obs. 3: O valor padrão do bloco retornado para o parâmetro “size” é de 500 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 a lista completa de fundos e suas respectivas classes/séries de cota existentes na base do ANBIMA Feed.

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-estruturados/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-estruturados/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
cnpj_fundoCNPJAlfanumérico – Comprimento variável (14)CNPJ do Fundo
classes_serie_cota Lista de Objetos JSONLista com todo o histórico (diário) de dados periódicos (PL e cota) das classes/séries de cota do fundo. Veja a tabela lista de campos Série Cota

Lista de campos Classe Série Cota:

Campo no FeedInformaçãoTipo/TamanhoDescrição
codigo_anbimaValor do IRNumérico (14)Valor do imposto de renda que incidiu sobre os resgates.
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 FeedInformaçãoTipo/TamanhoDescrição
data_referenciaData de ReferênciaData (AAAA-MM-DD)Data de referência das taxas e informações apresentadas.
patrimonio_liquidoPatrimônio LíquidoDecimal(14)Informa o patrimônio líquido no dia. O patrimônio líquido é calculado pela soma do valor de todos os títulos e do valor em caixa, menos as obrigações, inclusive aquelas relativas à sua administração.
valor_cotaValor da CotaDecimal(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)Decimal(14)Valor total de novos aportes até a última data de registro.
resgateResgates (novos saques)Decimal(14)Soma dos valores resgatados por cotistas e dos resgates de IR.
resgateDetalhamentoDetalhamento dos resgatesObjeto JSONDetalhamento do resgate com valor do Imposto de renda. Veja tabela Detalhamento dos Resgates a seguir
numero_cotistas Numérico(5)Número total de investidores.
data_atualizacaoData de AtualizaçãoData e Hora (YYYY-MM-DD HH:MI:SS)Data em que houve a última atualização do contexto

Lista de campos Detalhamento do resgate:

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-estruturados/serie-historica/lote?page=0
Quantidade de fundos por páginasize=50NãoGET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/serie-historica/lote?page=1&size=50

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.