Each investment contains a list of transactions corresponding to Applications or Withdrawals. The transaction schema contains a set of details of that operation.
Investment Transaction#
| Property | Type | Optional | Description |
|---|---|---|---|
| tradeDate | Date | No | The date when the transaction was settled. |
| date | Date | No | The date when the transaction was made. |
| quantity | number | No | Quantity of invested quotas. |
| value | number | No | Value at which it was acquired. |
| amount | number | No | The gross value of the operation. |
| type | InvestmentTransactionType | No | Type of movement of the transaction. |
| description | string | Yes | Description of the transaction. |
| brokerageNumber | string | Yes | Number of the corresponding brokerage note. |
| netAmount | number | Yes | Value including expenses. |
| agreedRate | number | Yes | Agreed rate only available for TREASURY applications. |
| expenses | Expenses | Yes | Taxes and charges described in the brokerage notes. |
Investment Transaction Type#
| Value | Description |
|---|---|
| BUY | Application. |
| SELL | Withdrawal. |
| TAX | Taxes that decrease the investment size. |
| TRANSFER | Transfer between investments. |
| INTEREST | Income distributions: dividends, rental income (FIIs), interest on capital (JCP), coupon payments. |
| AMORTIZATION | Partial return of principal (amortização de cotas, bond amortization). |
Expenses#
When we buy an asset traded on a stock exchange, usually through a brokerage firm, the brokerage firm issues a commercial note called a brokerage note. The note contains the total value of the transaction, the assets bought and sold, the fees related to the stock exchange, the amount charged by the broker (brokerage fee), and the total sum. The brokerage note represents the daily status of an investor's operations in the financial market. All taxes charged in each operation are grouped in the Expenses object.
| Property | Type | Optional | Description |
|---|---|---|---|
| serviceTax | number | Yes | Service tax varies according to state (ISS). |
| brokerageFee | number | Yes | Commission charged by the brokerage for carrying out transactions on the stock market. |
| incomeTax | number | Yes | Income Tax Withholding is the amount paid to the Internal Revenue Service (IRRF). |
| other | number | Yes | Sum of other not defined expenses. |
| tradingAssetsNoticeFee | number | Yes | A fee of Notice of Trading in Assets (ANA). |
| maintenanceFee | number | Yes | Fees charged by BM&F Bovespa in negotiations. |
| settlementFee | number | Yes | Liquidation fee for the settlement of a position on the expiration date or the financial settlement of physical delivery. |
| clearingFee | number | Yes | Clearing fee charged by the clearing house. |
| stockExchangeFee | number | Yes | Fees charged by BM&F Bovespa as a source of operating income. |
| custodyFee | number | Yes | Fee charged by brokers to keep records in their home broker systems or on the trading desk. |
| operatingFee | number | Yes | Amount paid to the Operator for the intermediation service. |
Example of a Transaction:
{
"total": 1,
"totalPages": 1,
"page": 1,
"results": [
{
"type": "BUY",
"description": "Aplicação Fundo de Investimento Premium",
"quantity": 1.25,
"value": 2,
"amount": 5,
"date": "2022-03-24T03:00:00.000Z",
"tradeDate": "2022-03-24T03:00:00.000Z",
"brokerageNumber": "47078992",
"expenses": {
"serviceTax": 0.05,
"brokerageFee": 0.1,
"incomeTax": 0.01,
"other": 0.01,
"tradingAssetsNoticeFee": 0,
"maintenanceFee": 0,
"settlementFee": 0.09,
"clearingFee": 0,
"stockExchangeFee": 0.05
}
}
]
}See Investment Transactions in our API reference for more information.