Fundos Offshore
Lista Completa de Fundos
Esta API divulga a lista completa de fundos offshore existentes na base do ANBIMA Feed com o resumo de seus respectivos dados.
As informações são disponibilizadas pela API com paginação (máximo de 1.000 registros por página). No retorno da API, além da lista de fundos, são informados o número total de fundos e o total de páginas.
Para acessá-la, deve-se utilizar a seguinte
https://[ambiente]/feed/fundos/v1/fundos-offshore
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-offshore
Lista de campos:
Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
codigo_fundo | Código ANBIMA | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 6 |
nome_fantasia | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
classe_anbima | Classe ANBIMA | 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 | Alfanumérico – Comprimento variável | 20 |
situacao_atual | Situação atual do Fundo | Indicador sobre o status atual do fundo quanto à novos aportes. Os possíveis valores para este campo são: A = Ativo E = Encerrado | Alfanumérico – Comprimento fixo | 1 |
data_inicio_divulgacao_cota | Data de início de divulgação de cotas do fundo | Representa a primeira data de registro de série histórica (dados periódicos) | Data | YYYY-MM-DD |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Obs. 2: A quantidade máxima de registros por página é 1.000.
Parâmetros:
Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
Página | page=1 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore?page=1 |
Quantidade de fundos por página | size=1000 | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore?page=1&size=1000 |
Detalhes do Fundo
Esta API divulga os dados detalhados de um fundo offshore específico.
Para acessá-la, deve-se utilizar a seguinte URI:
https://[ambiente]/feed/fundos/v1/fundos-offshore/{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 produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/{codigoFundo}
As informações presentes nesta API são divididas nos seguintes contextos:
Dados Cadastrais
Este contexto (dados-cadastrais
) é compreendido pelos dados básicos de identificação de um fundo.
Lista de campos:
Campo Feed | Informação | Descrição | Informação Esperada | Tamanho |
codigo_fundo | Código ANBIMA | Chave de identificação do fundo na ANBIMA | Alfanumérico – Comprimento fixo | 6 |
nome_fantasia | Nome fantasia do fundo | Nome pelo qual o fundo é conhecido | Alfanumérico – Comprimento variável | 40 |
razao_social | Razão social | Razão social do fundo | Alfanumérico – Comprimento variável | 150 |
codigo_isin | ISIN | 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 | Alfanumérico – Comprimento variável | 12 |
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 | YYYY-MM-DD |
classe_anbima | Classe ANBIMA | 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 | Alfanumérico – Comprimento variável | 20 |
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 | 40 |
composicao_fundo | 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 | 20 |
benchmark | Benchmark | Este campo indica o índice de referência de desempenho do fundo | Alfanumérico – Comprimento variável | 20 |
investimento_exterior | Investimento no 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 %] | 20 |
permite_alavancagem | Fundo permite alavancagem | 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. | Alfanumérico – Comprimento fixo | 20 |
situacao_atual | Situação atual do Fundo | Indicador sobre o status atual do fundo quanto à novos aportes. Os possíveis valores para este campo são: A = Ativo E = Encerrado | Alfanumérico – Comprimento fixo | 1 |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Prestadores de Serviço
Este contexto (prestadores
) é 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 |
Lista de campos:
Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
nome | Nome do Prestador de Serviço | Este campo informa o nome dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores. | Alfanumérico – Comprimento variável | 40 |
cnpj | CNPJ do Prestador de Serviço | Este campo informa o cnpj dos prestadores de serviço do fundo. Ele será retornado para todos os prestadores | Alfanumérico – Comprimento variável | 14 |
principal | Gestor principal | Indica se este prestador é o principal gestor do fundo. | Boolean (TRUE, FALSE) | 1 |
Taxas do Fundo
Aqui são detalhadas as informações referentes às taxas aplicadas em um fundo. Trazemos aqui os dados atuais (contexto: taxas
) e a lista com o histórico de alterações de taxas (contexto: historico_taxas
).
Lista de campos:
Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
unidade | Unidade da taxa de administração | É 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) | Alfanumérico – Comprimento fixo | 1 |
cobra_taxa_performance | Cobra taxa performance | 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) | Alfanumérico – Comprimento fixo | 1 |
taxa_performance_nao_padronizada | Taxa de performance não padronizada (regras) | Este campo define quais as regras de cobrança de taxa de performance do fundo | Alfanumérico – Comprimento variável | 500 |
periodicidade_cobranca_taxa_performance | Period. de cobrança da taxa de performance | Informa a periodicidade em que a taxa de performance é cobrada | Numérico | 19 |
taxa_composta | Taxa composta | 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) | Alfanumérico – Comprimento fixo | 1 |
taxa_entrada | Taxa de entrada | Taxa cobrada no momento da aplicação de recursos no fundo | Alfanumérico – Comprimento variável | 40 |
taxa_saida | Taxa de saída | Taxa cobrada sobre o valor do resgate | Alfanumérico – Comprimento variável | 40 |
taxa_maxima | Taxa de administração máxima | É 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. | Decimal | 23 |
taxa_administracao | Taxa de Administração | Percentual da taxa de administração compreendendo as taxas que os fundos investidos podem cobrar, isto é, a taxa explicitada no regulamento. | Decimal | 23 |
data_inicio_vigencia_taxa_adm | Data de início de vigência da Taxa de Administração | Indica quando a Taxa de Administração começou a ser praticada | Data/hora | YYYY-MM-DD HH:MI:SS |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Movimentação de Cotas
Este contexto (movimentacao
) é compreendido pelas informações de aportes, resgates e demais movimentações de cotas em um fundo.
Lista de campos:
Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
prazo_emissao_cotas | Prazo para emissão de cotas | Prazo (em dias) para conversão das cotas para efeito de aplicação de recursos | Alfanumérico – Comprimento variável | 40 |
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 | Alfanumérico – Comprimento variável | 40 |
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 | Alfanumérico – Comprimento variável | 40 |
carencia_inicial_primeiro_resgate | Carência inicial para 1º resgate | 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. | Numérico | 19 |
carencia_ciclica | Carencia ciclica (tempo entre resgates) | Carência cíclica: intervalo de tempo periódico (em dias) a ser respeitado pelo cotista entre um resgate e outro. | Numérico | 19 |
aplicacao_inicial_minima | 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 | 18 |
aplicacao_adicional_minima | Aplicação adicional mínima | 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. | Decimal | 18 |
resgate_minimo | 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 | 18 |
saldo_minimo_aplicado | Saldo mínimo aplicado ao fundo | 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 | Decimal | 18 |
divulgacao_cota | Periodicidade de divulgação de cota | Indica a periodicidade com a qual o administrador do fundo se responsabiliza por atualizar as informações periódicas | Alfanumérico – Comprimento variável | 10 |
data_inicio_divulgacao_cota | Data de início de divulgação de cotas do fundo | Representa a primeira data de registro de dados periódicos do fundo | Data | YYYY-MM-DD |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Série Histórica
Este contexto (serie_historica
) apresenta os dados periódicos de um fundo da última data disponível (PL e cota).
Lista de campos:
Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
numero_cotistas | Número de Cotistas | Número total de investidores do fundo | Numérico | 10 |
patrimonio_liquido | Patrimônio Líquido do Fundo | 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. | Decimal | 14 |
valor_cota | Valor da Cota do Fundo | Valor da cota do fundo no dia. As cotas são frações do valor do patrimônio do fundo. | Decimal | 17 |
captacao | Captação (novos aportes) | Valor total de novos aportes no fundo até a última data de registro. | Decimal | 14 |
resgate | Resgates (novos saques) | Soma dos valores resgatados por cotistas e dos resgates de IR. | Decimal | 14 |
codigo_moeda | Moeda | Moeda referente aos valores informados. | Alfanumérico – Comprimento fixo | 3 |
data_referencia | Data de Referência | Data a qual os valores apresentados se referem | Data/hora | YYYY-MM-DD HH:MI:SS |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Parâmetros:
Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
Código ANBIMA | codigoFundo | Sim | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/073946 |
Série Histórica do Fundo
Esta API divulga exibe uma lista com todo o histórico (diário) de dados periódicos do fundo (PL e cota).
Para acessá-la, deve-se utilizar a seguinte URI:
https://[ambiente]/feed/fundos/v1/fundos-offshore/{codigoFundo}/serie-historica
O método utilizado para acesso aos recursos deve ser o GET, pois nossa API é exclusivamente utilizada para consultas a informações. Um exemplo de chamada real em ambiente de produção seria:
GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/{codigoFundo}/serie-historica
Lista de campos:
Campo Feed | Informação | Descrição | Domínio/ Informação Esperada | Tamanho |
numero_cotistas | Número de Cotistas | Número total de investidores do fundo | Numérico | 10 |
patrimonio_liquido | Patrimônio Líquido do Fundo | 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. | Decimal | 14 |
valor_cota | Valor da Cota do Fundo | Valor da cota do fundo no dia.As cotas são frações do valor do patrimônio do fundo. | Decimal | 17 |
captacao | Captação (novos aportes) | Valor total de novos aportes no fundo até a última data de registro | Decimal | 14 |
resgate | Resgates (novos saques) | Soma dos valores resgatados por cotistas e dos resgates de IR | Decimal | 14 |
codigo_moeda | Moeda | Moeda referente aos valores informados. | Alfanumérico – Comprimento fixo | 3 |
data_referencia | Data de Referência | Data a qual os valores apresentados se referem | Data/hora | YYYY-MM-DD HH:MI:SS |
data_atualizacao | Data de Atualização | Data em que houve a última atualização do contexto | Data/hora | YYYY-MM-DD HH:MI:SS |
Parâmetros:
Tipo parâmetro | Formato | Obrigatório | Exemplo de consulta |
Código ANBIMA | codigoFundo | Sim | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/073946/serie-historica |
Data inicial da consulta | data-inicio=yyyy-MM-dd | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/073946/serie-historica?data-inicio=2019-11-19&data-fim=2020-11-14 |
Data final da consulta | data-fim=yyyy-MM-dd | Não | GET https://api.anbima.com.br/feed/fundos/v1/fundos-offshore/073946/serie-historica?data-inicio=2019-11-19&data-fim=2020-11-14 |
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. Caso a data inicial esteja nula, será considerada a data referente a 1 ano anterior à data fim informada. Se por outro lado, for inserida a data inicial e a final estiver nula, esta última é considerada a data fim que compreende o período de 5 anos a partir da data informada.
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).