list_variable_incomes
List a user's variable income assets (stocks, ETFs, exchange-traded assets) from Brazilian banks, showing quantity, closing price, and gross amount.
Instructions
Lists a user's variable income asset positions (stocks, ETFs, and other exchange-traded assets) via Open Finance Brasil Fase 4 (P1.3), including quantity, closing price, and gross amount.
No net_amount is returned here (unlike list_investments/list_funds/ list_treasure_titles): the real Variable Incomes spec's balance data only publishes a gross amount - taxes/fees on these assets are reported per-transaction (broker notes), not as a running net position.
Args: subject_id: User's CPF. bank: Participating bank. ctx: MCP request context, providing access to shared adapters.
Returns: The user's variable income assets and an aggregate gross total.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subject_id": "<subject_id>",
"bank": "<bank>"
},
"name": "list_variable_incomes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bank | Yes | ||
| subject_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bank | Yes | ||
| assets | No | ||
| total_records | Yes | ||
| total_gross_amount | Yes |