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-estruturadosSince 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-estruturadosFund list of fields:
| Feed field | Information | Description | Expected information | Size | ANBIMA Class |
cnpj_fundo | CNPJ (Corporate Taxpayer’s ID) | Fund CNPJ | Alphanumeric – Variable length | 14 | FIDC FII FIP |
razao_social | Corporate Name | Fund corporate name | Alphanumeric – Variable length | 150 | FIDC FII FIP |
classe_anbima | ANBIMA class | ANBIMA’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 length | 20 | FIDC FII FIP |
Classes/series of quota list of fields [classes_serie_cota]:
| Feed field | Information | Description | Expected information | Size | ANBIMA class |
codigo_anbima | ANBIMA code | Identification key of class/serie of the fund’s quota at ANBIMA. | Alphanumeric – Fixed length | 6 | FIDC FII FIP |
nome_fantasia | Fund fictitious name | Name by which the fund is known. | Alphanumeric – Variable length | 40 | FIDC FII FIP |
tipo_classe_cota | Quota type of class | Informs the class of shares in the structured fund that the data refer to. Example: Senior, Mezzanine, Subordinated, 1, 2, A, B, etc. | Alphanumeric – Variable length | 15 | FIDC FII FIP |
data_inicio_divulgacao_cota | Fund quota disclosure start date | Represents the first record date of periodic data of a fund. | Date | YYYY-MM-DD | FIDC FII FIP |
situacao_atual | Fund current status | Indicator about the current status of the fund regarding new contributions. Possible values for this field are: A = Active E = Closed | Alphanumeric – Fixed length | 1 | FIDC FII FIP |
data_encerramento | Fund closing date | Date 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”. | Date | YYYY-MM-DD | FIDC FII FIP |
data_atualizacao | Date of updating | Date when context was last updated. | Date/time | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Parameters:
| Parameter type | Format | Mandatory | Query example |
| ANBIMA Class | classe-anbima=FIP classe-anbima=FII classe-anbima=FIDC | No | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?classe-anbima=FIP&classe-anbima=FII |
| Page | page=1 | No | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?page=1 |
| Amount of funds per page | size=1000 | No | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados?page=1&size=300 |
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 field | Information | Description | Expected information | Size | ANBIMA class |
cnpj_fundo | CNPJ (Corporate Taxpayer’s ID) | CNPJ of fund. | Alphanumeric – Variable length | 14 | FIDC FII FIP |
razao_social | Corporate name | Fund corporate name. | Alphanumeric – Variable length | 150 | FIDC FII FIP |
classe_anbima | ANBIMA class | ANBIMA’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 length | 20 | FIDC FII FIP |
tipo_anbima | ANBIMA Type | This 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 length | 40 | FIDC FII FIP |
categoria_anbima | ANBIMA category | At this level, the funds are classified according to type of management. | Alphanumeric – Variable length | 20 | FIDC FII |
composicao_fundo | Fund 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 length | 40 | FIDC FII FIP |
classe_cvm | CVM Class | This field informs the CVM class that the fund belongs to. | Alphanumeric – Variable length | 20 | FIDC FII |
foco_atuacao | Main focus | Indicates the fund’s main focus | Alphanumeric – Variable length | 20 | FIDC FII |
prazo_duracao | Duration of the fund | Informs the duration of the fund, if it is established. | Alphanumeric – Variable length | 50 | FIDC FII |
cota_abertura | Opening quota | Opening 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 length | 1 | FIDC FII FIP |
tributacao_alvo | Target taxation | It 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 length | 50 | FIDC FII |
data_atualizacao | Date of updating | Date when context was last updated. | Date/time | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Classes/series of quota list of fields [classes_serie_cota]:
| Feed field | Information | Description | Expected information | Size | ANBIMA class |
codigo_anbima | ANBIMA code | Identification key of class/serie of the fund’s quota at ANBIMA. | Alphanumeric – Fixed length | 6 | FIDC FII FIP |
nome_fantasia | Fund fictitious name | Name by which the fund is known. | Alphanumeric – Variable length | 40 | FIDC FII FIP |
tipo_classe_cota | Quota type of class | Informs 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 length | 15 | FIDC FII FIP |
data_primeiro_aporte | Date of first contribution to the fund | Date on which the first contribution to the fund was made | Date | YYYY-MM-DD | FIDC FII FIP |
data_inicio_divulgacao_cota | Fund quota disclosure start date | Represents the first record date of periodic data of the class of the fund’s quota. | Date | YYYY-MM-DD | FIDC FII FIP |
data_encerramento | Fund closing date | Date 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”. | Date | YYYY-MM-DD | FIDC FII FIP |
situacao_atual | Fund current status | Indicator about the current status of the fund regarding new contributions. Possible values for this field are: A = Active E = Closed | Alphanumeric – Fixed length | 1 | FIDC FII FIP |
restrito | Restricted? | Informs whether the fund is restricted, that is, if it has a limit on the number of shareholders. | Alphanumeric – Variable length | 20 | FIDC FII FIP |
investidor_qualificado | Qualified investor? | Informs whether the fund allows only qualified investors. Possible values for this field are: S = Yes N = No | Alphanumeric – Variable length | 1 | FIDC FII FIP |
benchmark | Benchmark | This field displays the reference performance index of the fund | Alphanumeric – Variable length | 20 | FIP |
data_atualizacao | Date of updating | Date when context was last updated. | Date/time | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Service Providers
This context (prestadores) comprises the different service providers of a structured fund, who could be:
| Provider | Description | ANBIMA class |
| Administrator | Responsible for all the services related to the operation and maintenance of the fund. | FIDC FII FIP |
| Manager | Responsible for the management of the fund’s assets. | FIDC FII FIP |
| Custodian | Responsible for maintaining and safeguarding the assets of the investment fund. | FIDC FII FIP |
| Asset Controller | Responsible to implement the processes related to the control of assets as well as the accounting procedures. | FIDC FII FIP |
| Passive Controller | Responsible to implement the processes related to the control of liabilities as well as the accounting procedures. | FIDC FII |
| Independent Auditor | Responsible for analyzing the accounts and operations of the fund and issuing an independent report. | FIDC FII |
Fund list of fields:
| Feed field | Information | Description | Expected information | Size | ANBIMA Class |
nome | Service Provider Name | This field informs the name of the service providers for the fund. It will be prompted for all the roles. | Alphanumeric – Variable length | 40 | FIDC FII FIP |
cnpj | Service Provider CNPJ | This field informs the CNPJ (corporate taxpayer’s ID) of the fund’s service providers. It will be prompted for all the roles. | Alphanumeric – Variable length | 14 | FIDC FII FIP |
principal | Primary manager | Indicates whether this provider is the fund’s main manager. | Boolean (TRUE = 1, FALSE = 0) | 1 | FIDC 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 field | Information | Description | Expected information | Tamanho | ANBIMA Class |
data_referencia | Reference date | Reference date for fees and information provided. | Date | YYYY-MM-DD | FIDC FII FIP |
unidade_taxa_adm | Administration fee unit | It is the remuneration for administration services. Possible values for this field are: Percentage (P) Value (V) Mixed (M) | Alphanumeric – Fixed length | 1 | FIDC FII |
taxa_administracao | Administration Fee | Percentage of the administration fee, comprising the fees that the invested funds may charge, that is, the fee specified in the regulation. | Decimal | 23 | FIDC FII FIP |
unidade_tempo_taxa_adm | Unit of time of administration fee | Informs the unit of time when the administration fee is defined. | Alphanumeric – Variable length | 6 | FIDC FII |
base_calculo_taxa_adm | Basis for calculating administration fee | Informs the basis for calculating administration fee | Alphanumeric – Variable length | 30 | FIDC FII |
metodologia_calculo_taxa_adm | Methodology for calculating administration fee | Informs the methodology for calculating collection fee. | Alphanumeric – Variable length | 30 | FIDC FII |
periodicidade_cobranca_taxa_adm | Frequency of charging the administration fee | Administration fee collection periodicity | Alphanumeric – Variable length | 15 | FIDC FII |
data_inicio_vigencia_taxa_adm | Administration Fee Effective Date | Indicates when the administration fee started to be practiced. | Date | YYYY-MM-DD | FIDC FII FIP |
cobra_taxa_performance | Charges performance fee | The 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 length | 1 | FIDC FII FIP |
periodicidade_cobranca_taxa_performance | Performance fee collection periodicity | It informs the periodicity with which performance fee is collected. | Numerical | 19 | FIDC FII FIP |
descricao_taxa_performance | Description of performance fee | Describes how performance fee is charged. | Alphanumeric – Variable length | 200 | FIDC FII FIP |
taxa_performance_nao_padronizada | Non-standardized performance fee (rules) | Defines the rules for collecting the performance fee of the fund | Alphanumeric – Variable length | 500 | FIDC FII FIP |
taxa_composta | Compound 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 length | 1 | FIDC FII FIP |
taxa_fixa | Fixed fee | Informs the percentage of the fund’s fixed fee, if applicable. | Alphanumeric – Variable length | 23 | FIDC FII FIP |
taxa_maxima | Maximum administration fee | It is the maximum percentage that can be charged for administration fee as per the fund’s regulations. | Decimal | 23 | FIDC FII FIP |
data_atualizacao | Date of updating | Date when context was last updated. | Date/time | YYYY-MM-DD HH:MI:SS | FIDC 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 field | Information | Description | Expected information | Size | ANBIMA class |
periodicidade_divulgacao_cota | Quota disclosure frequency | Indicates the frequency with which the fund administrator is responsible for updating the periodic information | Alphanumeric – Variable length | 15 | FIDC FII FIP |
saldo_minimo_aplicado_ao_fundo | Minimum balance invested in the fund | Minimum amount to remain in the fund. | Decimal | 13 | FIDC FII FIP |
aplicacao_inicial_minima | Minimum starting investment | Minimum contribution to be accepted in the fund. | Decimal | 18 | FIDC FII FIP |
aplicacao_adicional_minima | Minimum additional investment | Minimum acceptable amount for subsequent investments. | Decimal | 18 | FIDC FII FIP |
resgate_minimo | Minimum redemption | Minimum acceptable amount to withdraw from the fund. | Decimal | 18 | FIDC FII FIP |
data_atualizacao | Date of updating | Date when context was last updated. | Date/time | YYYY-MM-DD HH:MI:SS | FIDC 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 field | Information | Description | Expected information | Size | ANBIMA class |
data_referencia | Reference date | Reference date for information provided. | Date | YYYY-MM-DD | FIDC FII FIP |
patrimonio_liquido | Net Assets | It 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. | Decimal | 14 | FIDC FII FIP |
valor_cota | Fund quota value | Value of fund quota on the day. The quotas are fractions of the net assets. | Decimal | 17 | FIDC FII FIP |
captacao | Sales (new contributions) | Total amount of new contributions to the fund until the last registration date. | Decimal | 14 | FIDC FII FIP |
resgate | Redemptions (new withdrawals) | Sum of the amounts redeemed by fund shareholders and of income tax redemptions | Decimal | 14 | FIDC FII FIP |
numero_cotistas | Number of fund shareholders | Total number of fund investors. | Numerical | 5 | FIDC FII FIP |
data_atualizacao | Date of updating | Date when context was last updated. | Date/time | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Parameters:
| Parameter type | Format | Mandatory | Query Example |
| CNPJ | {CNPJ} | Yes | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762} |
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-historicaSince 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-historicaClasses/series of quota list of fields [classes_series_cotas]:
| Feed field | Information | Description | Expected information | Size | ANBIMA class |
data_referencia | Reference date | Reference date for information provided. | Date | YYYY-MM-DD | FIDC FII FIP |
patrimonio_liquido | Net Assets | It 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. | Decimal | 14 | FIDC FII FIP |
valor_cota | Fund quota value | Value of fund quota on the day. The quotas are fractions of the net assets. | Decimal | 17 | FIDC FII FIP |
captacao | Sales (new contributions) | Total amount of new contributions to the fund until the last registration date. | Decimal | 14 | FIDC FII FIP |
resgate | Redemptions (new withdrawals) | Sum of the amounts redeemed by fund shareholders and of income tax redemptions | Decimal | 14 | FIDC FII FIP |
numero_cotistas | Number of fund shareholders | Total number of fund investors. | Numerical | 5 | FIDC FII FIP |
data_atualizacao | Date of updating | Date when context was last updated. | Date/time | YYYY-MM-DD HH:MI:SS | FIDC FII FIP |
Parameters:
| Parameter type | Format | Mandatory | Query example |
| CNPJ | {CNPJ} | Yes | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/serie-historica |
| Start date of consultation | data-inicio=yyyy-MM-dd | No | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/serie-historica?data-inicio=2019-11-19 |
| End date of consultation | data-fim=yyyy-MM-dd | No | GET https://api.anbima.com.br/feed/fundos/v1/fundos-estruturados/{34271171000762}/serie-historica ?data-inicio=2019-11-19&data-fim=2020-11-14 |
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.