Investment Transactions (OFDA)
Early preview of upcoming product
The following documentation is an early preview of Belvo's upcoming Investments product. As such:
- Parameter key names, values, and structure may change before the final product is implemented.
With Belvo's Open Finance Data Aggregation (OFDA) product for Brazil, you can retrieve key information regarding each investment transaction that occurred for a given investment.
For each investment transaction, you receive:
- Core information about the transaction (value date, type, subtype)
- Details regarding the quantity, any taxes applied, and unit price.
- In the case the transaction is from a Variable Income investment, the daily broker note details.
Core Information
| Parameter | Type | Description | Example |
|---|---|---|---|
| id | string | Belvo's unique ID for the investment transaction. | 1599dd46-303a-4855-a30b-b2ffd4d931bc |
| internal_identification | string | The institution's internal identification of the investment transaction. | ABCD2126019929279212650822221989319253344 |
| value_date | string | The date on which the transaction was settled, in `YYYY-MM-DD` format. > 📘 VARIABLE_INCOME Investments > > For VARIABLE_INCOME Investments, you will only receive transactions up until the last trading date. For example, if today is 19.11.2024, you will only receive transactions up till 18.11.2024. > 📘 Investment Funds > > For Investment Funds, this is the date when the transaction (purchase or redemption) is officially processed into fund shares or quotas. For purchases, this is the date the investor’s money is applied to acquire fund shares. For redemptions, this is the date when the fund shares are officially converted back into cash. | 2024-11-18 |
| gross_value | number | The gross value of the transaction. > 🚧 Not applicable for VARIABLE_INCOME Investments | 60 |
| net_value | number | The net value of the transaction. > 🚧 Not applicable for VARIABLE_INCOME Investments | 60 |
| value | number | The value of the transaction. For **VARIABLE_INCOME Investments**, this is the value of the trade executed by the client. If the client buys or sells stocks, this field indicates the total value of the trade (for example, the price per share × quantity). For **Investment Funds**, this is the value requested by the client for a fund transaction. > 🚧 Only applicable for VARIABLE_INCOME Investments and Investment Funds | 60 |
| unit_price | number | The price for an individual unit or quota. | 3 |
| price_factor | number | The number of units (shares) considered when calculating the price per share or unit for a transaction. > 🚧 Only applicable for VARIABLE_INCOME Investments. | 1 |
| transaction_tax | number | The Financial Transaction Tax (*Imposto sobre Operações Financeiras (IOF)*) applied or withheld during the transaction. > 🚧 Not applicable for VARIABLE_INCOME Investments | 0 |
| income_tax | number | The Income Tax (*Imposto de Renda (IR)*) applied or withheld during the transaction. > 🚧 Not applicable for VARIABLE_INCOME Investments | 0 |
| quantity | number | The number of units, quotas, or assets involved in a transaction. | 20 |
| type | string | The transaction type (`INFLOW` or `OUTFLOW`) from the investment perspective. | INFLOW |
| subtype | string | The transaction subtype. - For FIXED_INCOME_BANKING: APLICACAO, RESGATE, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, OUTROS. - For FIXED_INCOME_CREDIT: COMPRA, VENDA, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, PRÊMIO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, MULTA, MORA, OUTROS. - For VARIABLE_INCOME: COMPRA, VENDA, DIVIDENDOS, JCP, ALUGUEIS, TRANSFERENCIA_TITULARIDADE, OUTROS. - For Investment Funds: AMORTIZACAO, TRANSFERENCIA_DE_COTAS, APLICACAO, RESGATE, COME_COTAS, OUTROS. - For TREASURY_TREASURY_BOND: COMPRA, VENDA, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, OUTROS. | |
| subtype_additional_info | string | Additional information about the transaction subtype. This field is mandatory when the subtype is `OUTROS`. | |
| indexer_percentage | number | The maximum percentage of the indexer for the contract (FIXED_INCOME_BANKING) or transaction (FIXED_INCOME_CREDIT). > 🚧 Only applicable for FIXED_INCOME_BANKING and FIXED_INCOME_CREDIT. | 0 |
| rate | number | The remuneration rate applied to the transaction. > 🚧 Only applicable for FIXED_INCOME_BANKING, FIXED_INCOME_CREDIT, and TREASURY_BOND investments. | 0 |
| exit_fee | number | The exit fee applied to the Investment Fund (Fundos de Investimento) transaction. This fee is charged when a client redeems or exits the fund. > 🚧 Only applicable for Investment Funds. | 0 |
| broker_note_details | object | Details regarding the broker note that is associated with this transaction. This object is only returned for transactions that are associated with a `VARIABLE_INCOME` investment type. > 📘 Info > > A broker note (*nota de corretagem*) is an official document issued by a brokerage detailing the transactions made by an investor on a given day. It includes information on the gross value of all purchases and sales, brokerage fees, clearing and settlement fees, clearing and registration fees, stock exchange asset trade notice fees, stock exchange fees, clearing custody fees, taxes, and income tax withheld at source. |
broker_note_details
In the case that the transaction is linked to a Variable Income investment account, you will receive the daily broker note detailing the gross value of all purchases and sales, brokerage fees, clearing and settlement fees, clearing and registration fees, stock exchange asset trade notice fees, stock exchange fees, clearing custody fees, taxes, and income tax withheld at source.
| Parameter | Type | Description | Example |
|---|---|---|---|
| broker_note_number | string | The broker note number. | 1854009930314350 |
| gross_value | number | The gross value of all purchases and sales for the day. | 1000 |
| brokerage_fee | number | The total brokerage fee charged for the day. | 10 |
| clearing_settlement_fee | number | The fee charged for clearing and settlement in custody. | 2.5 |
| clearing_registration_fee | number | The fee charged for clearing and registration in custody. | 1 |
| stock_exchange_asset_trade_notice_fee | number | The fee charged by the stock exchange for asset trade notifications. | 0.5 |
| stock_exchange_fee | number | The fee charged by the stock exchange for registry services. | 3 |
| clearing_custody_fee | number | The fee charged by financial institutions for custody services. | 1.5 |
| taxes | number | The total amount taxes charged on the transaction for the day, excluding income tax withheld at source. | 10 |
| income_tax | number | The total amount of income tax withheld at the source for the day. | 5 |
| net_value | number | The net value of the broker note after deducting expenses for brokerage fees, clearing settlement fees, registration fees, ANA fees, emoluments, custody fees, taxes, and IRRF | 980 |
Updated 6 days ago