Investment Funds

Funds APIs

Structured Funds

List of Funds

This API discloses the complete list of structured funds (FIDC, FII and FIP), their respective classes/series of quotas existing in the ANBIMA Feed base and a summary of their data.

The information is made available through the API with pagination (maximum of 300 records per page). In addition to the list of funds, the API returns the total number of funds and pages.

To access it, the following URL must be used:

https://[environment]/feed/fundos/v1/fundos-estruturados

Since our API is exclusively used for querying information, the GET method must be used to access the resources. An example of a real request in a Production environment would be:

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

Fund list of fields:

Feed fieldInformationDescriptionExpected informationSizeANBIMA
Class
cnpj_fundoCNPJ (Corporate Taxpayer’s ID)Fund CNPJAlphanumeric – Variable length14FIDC
FII
FIP
razao_socialCorporate NameFund corporate nameAlphanumeric – Variable length150FIDC
FII
FIP
classe_anbimaANBIMA classANBIMA’s classification seeks to gather the several options of portfolios offered by investment funds, according to certain portfolio features.
So, it takes into consideration the asset classes comprising a portfolio, their terms and risks, in addition to management styles and strategies.
Possible values for this field are:
– FIDC
– FII
– FIP
Alphanumeric – Variable length20FIDC
FII
FIP

Classes/series of quota list of fields [classes_serie_cota]:

Feed fieldInformationDescriptionExpected informationSizeANBIMA class
codigo_anbimaANBIMA codeIdentification key of class/serie of the fund’s quota at ANBIMA.Alphanumeric – Fixed length6
FIDC
FII
FIP
nome_fantasiaFund fictitious nameName by which the fund is known.Alphanumeric – Variable length40FIDC
FII
FIP
tipo_classe_cotaQuota type of classInforms the class of shares in the structured fund that the data refer to. Example: Senior, Mezzanine, Subordinated, 1, 2, A, B, etc.Alphanumeric – Variable length15FIDC
FII
FIP
data_inicio_divulgacao_cotaFund quota disclosure start dateRepresents the first record date of periodic data of a fund.DateYYYY-MM-DDFIDC
FII
FIP
situacao_atualFund current statusIndicator about the current status of the fund regarding new contributions.
Possible values for this field are:
A = Active
E = Closed
Alphanumeric – Fixed length1FIDC
FII
FIP
data_encerramentoFund closing dateDate on which the fund was closed and contributions were no longer allowed. This field is only shown when the current status of the fund is “Closed”.DateYYYY-MM-DDFIDC
FII
FIP
data_atualizacaoDate of updatingDate when context was last updated.Date/timeYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Parameters:

Parameter typeFormatMandatoryQuery example
ANBIMA Classclasse-anbima=FIP classe-anbima=FII classe-anbima=FIDCNoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?classe-anbima=FIP&classe-anbima=FII
Pagepage=1NoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?page=1
Amount of funds per pagesize=1000NoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?page=1&size=300
Note: 1: If the page and size are not informed in the query, by default the first thousand funds, sorted by fund code, are returned on page zero.
Note 2: The maximum number of records per page is 300.

Fund Details

This API discloses detailed information of a structured fund and its respective classes/series of quota.

To access it, the following URL must be used:

https://[environment]/feed/fundos/v1/fundos-estruturados/{CNPJ}

Since our API is exclusively used for querying information, the GET method must be used to access the resources. An example of a real request in a Production environment would be:

GET https://api.anbima.com.br/feed/fundos/v1/fundos/{CNPJ}

Information in this API is divided into the following contexts:

Fund Registration Data

This context (dados-cadastrais) comprises the basic data for identifying a fund.

Fund list of fields:

Feed fieldInformationDescriptionExpected informationSizeANBIMA class
cnpj_fundoCNPJ (Corporate Taxpayer’s ID)CNPJ of fund.Alphanumeric – Variable length14FIDC
FII
FIP
razao_socialCorporate nameFund corporate name.Alphanumeric – Variable length150FIDC
FII
FIP
classe_anbimaANBIMA classANBIMA’s classification seeks to gather the several options of portfolios offered by investment funds, according to certain portfolio features.
So, it takes into consideration the asset classes comprising a portfolio, their terms and risks, in addition to management styles and strategies.
Possible values for this field are:
– FIDC
– FII
– FIP
Alphanumeric – Variable length20FIDC
FII
FIP
tipo_anbimaANBIMA TypeThis field seeks to show the type of management and corresponding risks and, whenever possible, an analogy with active or indexed (passive) management is made for all asset classes.Alphanumeric – Variable length40FIDC
FII
FIP
categoria_anbimaANBIMA categoryAt this level, the funds are classified according to type of management.Alphanumeric – Variable length20FIDC
FII
composicao_fundoFund Composition– FI: Investment Fund: in general, it seeks to receive investments from investors according to their target audience and investment objective and policy. An FI can invest up to 100% in securities in compliance with the legislation.
– FC: Investment Fund in Quotas: must have a minimum value of investment fund quotas in its portfolio, in compliance with the instruction governing it.
– FF: Master Investment Fund: receive investments solely from other funds. In this case, the target audience must necessarily be investment funds and/or investment funds in quotas. If the fund accepts investments from funds as well as from managed portfolios, it must be classified as FI, and not as FF.
– FM: Master Investment Fund in Quotas: investment fund in quotas aimed solely at receiving investment from other funds
Alphanumeric – Variable length40FIDC
FII
FIP
classe_cvmCVM ClassThis field informs the CVM class that the fund belongs to.Alphanumeric – Variable length20FIDC
FII
foco_atuacaoMain focusIndicates the fund’s main focusAlphanumeric – Variable length20FIDC
FII
prazo_duracaoDuration of the fundInforms the duration of the fund, if it is established.Alphanumeric – Variable length50FIDC
FII
cota_aberturaOpening quotaOpening quota is the one calculated and known at beginning of day. Closing quota is the one calculated and known only at day closing, that is, after market closing.
Possible values for this field are:
S = Yes (opening quota)
N = No (closing quota)
Alphanumeric – Fixed length1FIDC
FII
FIP
tributacao_alvoTarget taxationIt indicates the tax treatment given by the fund to collect income tax from the fund shareholders.
Longo Prazo: Long term
Curto Prazo: Short term
Renda Variável: Variable Income
Indefinido: Undefined
ND: ND
Não Aplicável: Not Applicable
Alphanumeric – Variable length50FIDC
FII
data_atualizacaoDate of updatingDate when context was last updated.Date/timeYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Classes/series of quota list of fields [classes_serie_cota]:

Feed fieldInformationDescriptionExpected informationSizeANBIMA class
codigo_anbimaANBIMA codeIdentification key of class/serie of the fund’s quota at ANBIMA.Alphanumeric – Fixed length6FIDC
FII
FIP
nome_fantasiaFund fictitious nameName by which the fund is known.Alphanumeric – Variable length40FIDC
FII
FIP
tipo_classe_cotaQuota type of classInforms the class of the quota in the structured fund that the data refer to. Example: Senior, Mezzanine, Subordinated, 1, 2, A, B, etc.Alphanumeric – Variable length15FIDC
FII
FIP
data_primeiro_aporteDate of first contribution to the fundDate on which the first contribution to the fund was madeDateYYYY-MM-DDFIDC
FII
FIP
data_inicio_divulgacao_cotaFund quota disclosure start dateRepresents the first record date of periodic data of the class of the fund’s quota.DateYYYY-MM-DDFIDC
FII
FIP
data_encerramentoFund closing dateDate on which the fund was closed and contributions were no longer allowed.
This field is only shown when the current status of the fund is “Closed”.
DateYYYY-MM-DDFIDC
FII
FIP
situacao_atualFund current statusIndicator about the current status of the fund regarding new contributions.
Possible values for this field are:
A = Active
E = Closed
Alphanumeric – Fixed length1FIDC
FII
FIP
restritoRestricted?Informs whether the fund is restricted, that is, if it has a limit on the number of shareholders.Alphanumeric – Variable length20FIDC
FII
FIP
investidor_qualificadoQualified investor?Informs whether the fund allows only qualified investors.
Possible values for this field are:
S = Yes
N = No
Alphanumeric – Variable length1FIDC
FII
FIP
benchmarkBenchmarkThis field displays the reference performance index of the fundAlphanumeric – Variable length20FIP
data_atualizacaoDate of updatingDate when context was last updated.Date/timeYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Service Providers

This context (prestadores) comprises the different service providers of a structured fund, who could be:

ProviderDescriptionANBIMA class
AdministratorResponsible for all the services related to the operation and maintenance of the fund.FIDC
FII
FIP
ManagerResponsible for the management of the fund’s assets.FIDC
FII
FIP
CustodianResponsible for maintaining and safeguarding the assets of the investment fund.FIDC
FII
FIP
Asset ControllerResponsible to implement the processes related to the control of assets as well as the accounting procedures.FIDC
FII
FIP
Passive ControllerResponsible to implement the processes related to the control of liabilities as well as the accounting procedures.FIDC
FII
Independent AuditorResponsible for analyzing the accounts and operations of the fund and issuing an independent report.FIDC
FII

Fund list of fields:

Feed fieldInformationDescriptionExpected informationSizeANBIMA Class
nomeService Provider NameThis field informs the name of the service providers for the fund. It will be prompted for all the roles.Alphanumeric – Variable length40FIDC
FII
FIP
cnpjService Provider CNPJThis field informs the CNPJ (corporate taxpayer’s ID) of the fund’s service providers. It will be prompted for all the roles.Alphanumeric – Variable length14FIDC
FII
FIP
principalPrimary managerIndicates whether this provider is the fund’s main manager.Boolean (TRUE = 1, FALSE = 0)1FIDC
FII
FIP

Fund fees

Provides detailed information about the fees applicable to a fund. Both current fees (taxas) and the history of changes in fees are listed (historico_taxas).

Fund list of fields:

Feed fieldInformationDescriptionExpected informationTamanhoANBIMA Class
data_referenciaReference dateReference date for fees and information provided.DateYYYY-MM-DDFIDC
FII
FIP
unidade_taxa_admAdministration fee unitIt is the remuneration for administration services.
Possible values for this field are:
Percentage (P)
Value (V)
Mixed (M)
Alphanumeric – Fixed length1FIDC
FII
taxa_administracaoAdministration FeePercentage of the administration fee, comprising the fees that the invested funds may charge, that is, the fee specified in the regulation.Decimal23FIDC
FII
FIP
unidade_tempo_taxa_admUnit of time of administration feeInforms the unit of time when the administration fee is defined.Alphanumeric – Variable length6FIDC
FII
base_calculo_taxa_admBasis for calculating administration feeInforms the basis for calculating administration feeAlphanumeric – Variable length30FIDC
FII
metodologia_calculo_taxa_admMethodology for calculating administration feeInforms the methodology for calculating collection fee.Alphanumeric – Variable length30FIDC
FII
periodicidade_cobranca_taxa_admFrequency of charging the administration feeAdministration fee collection periodicityAlphanumeric – Variable length15FIDC
FII
data_inicio_vigencia_taxa_admAdministration Fee Effective DateIndicates when the administration fee started to be practiced.DateYYYY-MM-DDFIDC
FII
FIP
cobra_taxa_performanceCharges performance feeThe fund shareholder has to pay a performance fee when the fund yield exceeds the fee of a reference indicator, known as benchmark, and its collection is subject to a minimum periodicity.Possible values for this field are:
S = Yes (fee is charged)
N = No (fee is not charged)
Alphanumeric – Fixed length1FIDC
FII
FIP
periodicidade_cobranca_taxa_performancePerformance fee collection periodicityIt informs the periodicity with which performance fee is collected.Numerical19FIDC
FII
FIP
descricao_taxa_performanceDescription of performance feeDescribes how performance fee is charged.Alphanumeric – Variable length200FIDC
FII
FIP
taxa_performance_nao_padronizadaNon-standardized performance fee (rules)Defines the rules for collecting the performance fee of the fundAlphanumeric – Variable length500FIDC
FII
FIP
taxa_compostaCompound fee?Informs when the fees charged by the funds invested can be applied to the fund registered.
Possible values for this field are:
S = Yes (fee applied to the fund)
N = No (fee not applied to the fund)
Alphanumeric – Fixed length1FIDC
FII
FIP
taxa_fixaFixed feeInforms the percentage of the fund’s fixed fee, if applicable.Alphanumeric – Variable length23FIDC
FII
FIP
taxa_maximaMaximum administration feeIt is the maximum percentage that can be charged for administration fee as per the fund’s regulations.Decimal23FIDC
FII
FIP
data_atualizacaoDate of updatingDate when context was last updated.Date/timeYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Quota Transactions

This context (movimentacao) comprises information regarding contributions, redemptions and other share transactions in a fund.

Classes/series of quota list of fields [classes_series_cotas]:

Feed fieldInformationDescriptionExpected informationSizeANBIMA class
periodicidade_divulgacao_cotaQuota disclosure frequencyIndicates the frequency with which the fund administrator is responsible for updating the periodic informationAlphanumeric – Variable length15FIDC
FII
FIP
saldo_minimo_aplicado_ao_fundoMinimum balance invested in the fundMinimum amount to remain in the fund.Decimal13FIDC
FII
FIP
aplicacao_inicial_minimaMinimum starting investmentMinimum contribution to be accepted in the fund.Decimal18FIDC
FII
FIP
aplicacao_adicional_minimaMinimum additional investmentMinimum acceptable amount for subsequent investments.Decimal18FIDC
FII
FIP
resgate_minimoMinimum redemptionMinimum acceptable amount to withdraw from the fund.Decimal18FIDC
FII
FIP
data_atualizacaoDate of updatingDate when context was last updated.Date/timeYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Historical Series of Classes/Series of Fund’s Quotas

This context (serie-historica) shows periodic data (PL and share) of classes/series of the quotas of a fund on the last available date.

To calculate the amounts for the fund, just add the fields of all the series/classes of quotas.

Classes/series of quota list of fields [classes_series_cotas]:

Feed fieldInformationDescriptionExpected informationSizeANBIMA class
data_referenciaReference dateReference date for information provided.DateYYYY-MM-DDFIDC
FII
FIP
patrimonio_liquidoNet AssetsIt informs the net asset on the day. The net equity is calculated by the sum of the amount of all securities and the amount in cash, less the fund liabilities, including those related to its administration.Decimal14FIDC
FII
FIP
valor_cotaFund quota valueValue of fund quota on the day. The quotas are fractions of the net assets.Decimal17FIDC
FII
FIP
captacaoSales (new contributions)Total amount of new contributions to the fund until the last registration date.Decimal14FIDC
FII
FIP
resgateRedemptions (new withdrawals)Sum of the amounts redeemed by fund shareholders and of income tax redemptionsDecimal14FIDC
FII
FIP
numero_cotistasNumber of fund shareholdersTotal number of fund investors.Numerical5FIDC
FII
FIP

data_atualizacao
Date of updatingDate when context was last updated.Date/timeYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Parameters:

Parameter typeFormatMandatoryQuery Example
CNPJ{CNPJ}YesGET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}
Note: : If a number with fewer than 14 digits is entered in the CNPJ parameter, the system will complete it with zeros, on the left side, the number of missing digits to run the query.

Historical Series of Classes/Series of Fund’s Quotas

The API discloses a list with the daily history of periodic data (asset under management and quota) of the classes/series of the fund’s quotas.

To calculate the amounts for the fund, just add the fields of all the series/classes of quotas on a specific date.

To access it, the following URL must be used:

https://[environment]/feed/fundos/v1/fundos-estruturados/{CNPJ}/serie-historica

Since our API is exclusively used for querying information, the GET method must be used to access the resources. An example of a real request in a Production environment would be:

GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{CNPJ}/serie-historica

Classes/series of quota list of fields [classes_series_cotas]:

Feed fieldInformationDescriptionExpected informationSizeANBIMA class
data_referenciaReference dateReference date for information provided.DateYYYY-MM-DDFIDC
FII
FIP
patrimonio_liquidoNet AssetsIt informs the net asset on the day. The net equity is calculated by the sum of the amount of all securities and the amount in cash, less the fund liabilities, including those related to its administration.Decimal14FIDC
FII
FIP
valor_cotaFund quota valueValue of fund quota on the day. The quotas are fractions of the net assets.Decimal17FIDC
FII
FIP
captacaoSales (new contributions)Total amount of new contributions to the fund until the last registration date.Decimal14FIDC
FII
FIP
resgateRedemptions (new withdrawals)Sum of the amounts redeemed by fund shareholders and of income tax redemptionsDecimal14FIDC
FII
FIP
numero_cotistasNumber of fund shareholdersTotal number of fund investors.Numerical5FIDC
FII
FIP

data_atualizacao
Date of updatingDate when context was last updated.Date/timeYYYY-MM-DD HH:MI:SSFIDC
FII
FIP

Parameters:

Parameter typeFormatMandatoryQuery example
CNPJ{CNPJ}YesGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/serie-historica
Start date of consultationdata-inicio=yyyy-MM-ddNoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/serie-historica?data-inicio=2019-11-19
End date of consultationdata-fim=yyyy-MM-ddNoGET  https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/serie-historica ?data-inicio=2019-11-19&data-fim=2020-11-14
Note 1: If a number with fewer than 14 digits is entered in the CNPJ parameter, the system will complete it with zeros, on the left side, the number of missing digits to run the query.
Note 2: Maximum period allowed for query will be five years (60 months).
Note 3: If the start and end dates are not specified in the query, the records of the last five years will be returned.
Note 4: If the user enters a start date greater than the end date, the dates will be swapped. If the start date is null, the date referring to one year prior to the end date informed will be considered. On the other hand, if a start date is entered and the end date is null, the end date will be the date of the end of a period of five years as from the date informed.