Dados cadastrais
Esta API divulga os dados detalhados dos fundos offshore.
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-offshore/loteO método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/loteCampos de controle:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
totalElements | Total de fundos existentes | Numérico(19) | Total de fundos deste tipo existentes na base da ANBIMA |
size | Total de registros na página | Numérico(19) | Total de registros retornados na página atual (veja mais em parâmetros e observações) |
page | Número da página | Numé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ágina | Numé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 JSON | Lista com toda séria histórica dos fundos. Veja a tabela Content |
Content:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
dados_cadastrais | Objeto JSON | Lista de Objetos JSON | Objeto JSON com os dados (veja mais na tabela dados_cadastrais) |
prestadores | Objeto JSON | Lista de Objetos JSON | Objeto JSON com os dados (veja mais na tabela prestadores) |
taxas | Objeto JSON | Lista de Objetos JSON | Objeto JSON com os dados (veja mais na tabela taxas) |
movimentacao | Objeto JSON | Lista de Objetos JSON | Objeto JSON com os dados (veja mais na tabela movimentacao) |
serie_historica | Objeto JSON | Lista de Objetos JSON | Objeto JSON com os dados (veja mais na tabela serie_historica) |
historico_taxas | Objeto JSON | Lista de Objetos JSON | Objeto JSON com os dados (veja mais na tabela historico_taxas) |
Dados_cadastrais:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
codigo_fundo | Código ANBIMA | Alfanumérico – Comprimento fixo (6) | Chave de identificação do fundo na ANBIMA |
nome_fantasia | Nome fantasia do fundo | Alfanumérico – Comprimento variável (40) | Nome pelo qual o fundo é conhecido |
nome_fantasia_2 | Nome fantasia do fundo | Alfanumérico – Comprimento variável (200) | Nome pelo qual o fundo é conhecido |
razao_social | Razão social | Alfanumérico – Comprimento variável (150) | Razão social do fundo |
data_inicio | Data de inicio do fundo | Data(YYYY-MM-DD) | Data de inicio do fundo |
codigo_isin | ISIN | Alfanumé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_encerramento_fundo | Data de encerramento do fundo | Data (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_anbima | Classe ANBIMA | Alfanumé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_anbima | Tipo ANBIMA | Alfanumé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 |
composicao_fundo | Composição do fundo | Alfanumé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 |
benchmark | Benchmark | Alfanumérico – Comprimento variável (20) | Este campo indica o índice de referência de desempenho do fundo |
investimento_exterior | Investimento no exterior | Alfanumé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 |
cota_abertura | Cota de abertura | Alfanumé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_alavancagem | Fundo permite alavancagem | Alfanumé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 estatutariamente | Alfanumé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ção | Data e Hora (YYYY-MM-DD HH:MI:SS) | Data em que houve a última atualização do contexto |
situacao_atual | Situação atual do Fundo | Alfanumé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 |
esg | ESG – 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) |
fundo_adaptado_icvm_175 | Fundo Adaptado a CVM 175 | Alfanumé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_175 | Data do fundo adaptado a CVM 175 | Data (YYYY-MM-DD) | Se o fundo já for adaptado a CVM 175, informada a data na qual ocorreu |
responsabilidade_ltda | Responsabilidade Limitada | Alfanumérico – Comprimento variável (50) | Informa se o fundo possui responsabilidade limitada |
entidade_investimento_fins_tributarios | Entidade de investimento para fins tributários | Alfanumérico – Comprimento variável (50) | Campo referente a tributação da lei 4.173. Os possíveis valores para o campo são: Sim Não Não se aplica |
95_por_cento_fundo_isento | 95% em fundos isentos de come-cotas | Alfanumérico – Comprimento variável (50) | Campo referente a tributação da lei 4.173. Os possíveis valores para o campo são: Sim Não |
Lista de campos Prestadores:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
administrador | Administradores | Objeto JSON | Responsável por todos os serviços relacionados ao funcionamento e manutenção do fundo |
gestores | Gestores | Objeto JSON | Responsável pela gestão dos ativos do fundo |
distribuidores | Distribuidores | Objeto JSON | Responsável pelo relacionamento e vendas para com o investidor final |
custodiantes | Custodiantes | Objeto JSON | Responsável por manter e guardar os ativos do fundo de investimento |
controlador_ativo | Controlador de Ativos | Objeto JSON | Responsável pela execução dos processos ligados ao controle dos ativos, bem como os procedimentos contábeis |
controlador_passivo_escriturador | Controlador de Passivos | Objeto JSON | Responsável pela execução dos processos ligados ao controle dos passivos, bem como os procedimentos contábeis |
data_atualizacao | Data de Atualização | Data 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 Feed | Informação | Tipo/Tamanho | Descrição |
nome | Nome do Prestador de Serviço | Alfanumé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ço | Alfanumé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 principal | Boolean (TRUE, FALSE) (1) | Indica se este prestador é o principal gestor do fundo. |
Lista de campos Taxas do Fundo:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
unidade | Unidade da taxa de administração | Alfanumé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 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_performance_não_padronizada | Taxa de performance não padronizada | Alfanumerico (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_administracao | Taxa de Administração | Decimal (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_maxima | Taxa de administração máxima | Decimal (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_fixa | Taxa fixa | Alfanumé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ção | Data/hora(YYYY-MM-DD HH:MI:SS) | Indica quando a Taxa de Administração começou a ser praticada |
data_atualizacao | Data de Atualização | Data e Hora (YYYY-MM-DD HH:MI:SS) | Data em que houve a última atualização do contexto |
data_referencia | Data de Referência | Data (AAAA-MM-DD) | Data de referência das taxas e informações apresentadas. |
Lista de campos Movimentação de Cotas:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
prazo_emissao_cotas | Prazo para emissão de cotas | Alfanumé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 resgate | Alfanumé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 resgate | Alfanumé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_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. |
carencia_inicial_primeiro_resgate | Carência inicial para 1º resgate | Numé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. |
aplicacao_inicial_minima | Aplicação inicial mínima | Decimal(18) | 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. |
aplicacao_adicional_minima | Aplicação adicional mínima | Decimal(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ínimo | Decimal(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 fundo | Decimal(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_cota | Periodicidade de divulgação de cota | Alfanumé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 fundo | Data (AAAA-MM-DD) | Representa a primeira data de registro de dados periódicos do fundo |
data_atualizacao | Data de Atualização | Data e Hora (YYYY-MM-DD HH:MI:SS) | Data em que houve a última atualização do contexto |
data_referencia | Data de Referência | Data (AAAA-MM-DD) | Data de referência das taxas e informações apresentadas. |
Lista de campos Série Histórica:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
patrimonio_liquido | Patrimônio Líquido do Fundo | Alfanumé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 Fundo | Alfanumé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 resgates | Objeto JSON | Detalhamento dos dados dos resgates. Veja lista de campos Resgate Detalhamento nas tabelas seguinte. |
data_atualizacao | Data/hora | Data e Hora (YYYY-MM-DD HH:MI:SS) | Data em que houve a última atualização do contexto |
data_referencia | Data de Referência | Data (AAAA-MM-DD) | Data de referência das taxas e informações apresentadas. |
Resgate detalhamento:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
resgates_ir | Valor do IR | Numérico (14) | Valor do imposto de renda “come-cotas” |
resgates_cotista | Valor dos resgates de cotistas | Numérico (14) | Valor de resgates realizados pelos cotistas |
Lista de campos Histórico Taxas:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
unidade | Unidade da taxa de administração | Alfanumé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 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_performance_nao_padronizada | Taxa 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_entrada | Taxa de entrada | Alfanumérico – Comprimento variável(40) | Taxa cobrada no momento da aplicação de recursos no fundo |
taxa_saida | Taxa de saída | Alfanumérico – Comprimento variável(40) | Taxa cobrada sobre o valor do resgate |
periodicidade_cobranca_taxa_performance | Period. de cobrança da taxa de perfor mance | Numérico(19) | Informa a periodicidade em que a taxa de performance é cobrada |
taxa_maxima | Taxa de administração máxima | Decimal (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ção | Decimal (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. |
taxa_fixa | Taxa Fixa | Alfanumé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ção | Data e Hora (YYYY-MM-DD HH:MI:SS) | Indica quando a Taxa de Administração começou a ser praticada |
data_atualizacao | Data/hora | Data e Hora (YYYY-MM-DD HH:MI:SS) | Data em que houve a última atualização do contexto |
data_referencia | Data de Referência | Data (AAAA-MM-DD) | Data de referência das taxas e informações apresentadas. |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Página | page=0 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/lote?page=0 |
| Quantidade de fundos por página | size=100 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/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 é 100.
Obs.3: O valor padrão do bloco retornado para o parâmetro “size” é de 100 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:
- Size variando de 0 a 100, retornará 100 registros.
- Size variando de 101 a 200, retornará 200 registros.
- Size variando de 201 a 300, retornará 300 registros.
- Size variando de 301 a 400, retornará 400 registros.
- 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 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-offshore/notas-explicativas/loteO método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/notas-explicativas/loteLista de campos:
Campos de controle:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
totalElements | Total de fundos existentes | Numérico(19) | Total de fundos deste tipo existentes na base da ANBIMA |
size | Total de registros na página | Numérico (19) | Total de registros retornados na página atual (veja mais em parâmetros e observações) |
page | Número da página | Numé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ágina | Numé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 JSON | Lista de Objetos JSON | Objeto JSON com os dados (veja mais na tabela Content) |
Content:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
codigo_fundo | Código anbima do fundo | Numérico (6) | Código Anbima do Fundo |
notas_explicativas | Objeto JSON contendo os dados de notas explicativas | Objeto JSON | Total de registros retornados na página atual (veja mais na tabela Notas_explicativas) |
Notas_explicativas
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
descricao | Descrição da nota explicativa | Alfanumérico (80) | Texto da nota explicativa |
data_referencia | Data de referência | Data/hora (YYYY-MM-DD HH-MM-SS | Data em que a nota explicativa foi gerada |
ano_divulgacao | Ano | Numérico(4) | Ano correspondente da nota explicativa |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Página | page=0 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/notas-explicativas/lote?page=0 |
| Quantidade de fundos por página | size=100 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/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:
- Size variando de 0 a 100, retornará 100 registros.
- Size variando de 101 a 200, retornará 200 registros.
- Size variando de 201 a 300, retornará 300 registros.
- Size variando de 301 a 400, retornará 400 registros.
- Size variando de 401 a n, retornará 500 registros.
Fundos Offshore Série Histórica
Esta API divulga uma lista com todo o histórico (diário) de dados periódicos do fundo (PL e cota).
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-offshore/serie-historica/loteO método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações.
Um exemplo de chamada real em ambiente de produção seria:
https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/serie-historica/loteCampos de controle:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
totalElements | Total de fundos existentes | Numérico(19) | Total de fundos deste tipo existentes na base da ANBIMA |
size | Total de registros na página | Numérico(19) | Total de registros retornados na página atual (veja mais em parâmetros e observações) |
page | Número da página | Numé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ágina | Numé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 JSON | Lista com toda séria histórica dos fundos. Veja a tabela Lista de campos |
Lista de campos:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
codigo_fundo | Código ANBIMA | Alfanumérico – Comprimento fixo (6) | Chave de identificação do fundo na ANBIMA |
serie_historica | Lista de Objetos JSON | Lista 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ção | Tipo/Tamanho | Descrição |
patrimonio_liquido | Patrimônio Líquido do Fundo | Numé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_cota | Valor da Cota do Fundo | Numérico (17) | 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) | Numérico (14) | Valor total de novos aportes no fundo até a última data de registro |
resgate | Resgates (novos saques) | Numérico (14) | Soma dos valores resgatados por cotistas e dos resgates de IR |
resgate_detalhamento | Detalhes dos resgates | Objeto JSON | Detalhamento 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 |
codigo_moeda | Código da Moeda | Alfanumérico(3) | Código da Moeda de referência da posição ativa da operação |
data_atualizacao | Data/hora | Data e Hora (YYYY-MM-DD HH:MI:SS) | Data em que houve a última atualização do contexto |
data_referencia | Data de Referência | Data (AAAA-MM-DD) | Data de referência das taxas e informações apresentadas. |
Lista de campos Detalhamento dos resgates:
| Campo no Feed | Informação | Tipo/Tamanho | Descrição |
resgates_ir | Valor do IR | Decimal(14) | Valor do imposto de renda que incidiu sobre os resgates. |
resgates_cotista | Valor dos resgates | Decimal(14) | Soma dos valores resgatados por cotistas |
Parâmetros:
| Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
| Página | page=0 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/serie-historica/lote?page=1 |
| Quantidade de fundos por página | size=50 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/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:
- Size variando de 0 a 50, retornará 50 registros.
- Size variando de 51 a 100, retornará 100 registros.
- Size variando de 101 a 150, retornará 150 registros.
- Size variando de 151 a 200, retornará 200 registros.
- Size variando de 201 a n, retornará 250 registros.