Obtiene el estado de cuenta de una cuenta comitente e incluye posición monetaria y tenencias disponibles.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Consultá el estado de cuenta de una cuenta comitente, incluyendo posición monetaria y tenencias disponibles.
Antes de empezar
- Tené a mano el
investment_account_idde la cuenta comitente que querés consultar. - Definí
position_discriminator_bcra=falsesi querés ver los dólares sin discriminar entre disponibles y bloqueados. - Definí
compromised_holdings=truesi querés incluir las tenencias comprometidas en la respuesta. - Definí
include_remunerated_balance=truesi querés incluir el saldo remunerado cuando la cuenta lo tenga activo.
Cómo consultar el estado de cuenta
GET /api/portfolio/account-statements/{investment_account_id}Consultar con discriminación BCRA
GET /api/portfolio/account-statements/{investment_account_id}?position_discriminator_bcra=trueIncluir tenencias comprometidas
GET /api/portfolio/account-statements/{investment_account_id}?compromised_holdings=trueIncluir saldo remunerado
GET /api/portfolio/account-statements/{investment_account_id}?include_remunerated_balance=trueCombinar parámetros
GET /api/portfolio/account-statements/{investment_account_id}?position_discriminator_bcra=true&compromised_holdings=true&include_remunerated_balance=trueParámetros
Path parameters
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
investment_account_id | integer | Sí | Identificador de la cuenta comitente en ApiBroker. |
Query parameters
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
position_discriminator_bcra | boolean | No | true | Si enviás false, la respuesta devuelve el total en dólares sin discriminar entre montos disponibles y bloqueados. |
compromised_holdings | boolean | No | false | Si enviás true, la respuesta incluye las tenencias comprometidas. |
include_remunerated_balance | boolean | No | false | Si enviás true y la cuenta remunera saldo, la respuesta puede incluir el detalle del saldo remunerado. |
Qué devuelve este endpoint
La respuesta devuelve un arreglo items. Cada elemento representa el estado de cuenta consolidado de una cuenta comitente.
Cada elemento puede incluir:
investment_account_id: identificador de la cuenta consultadaavailable_amount: posición monetaria disponible agrupada por mercado, moneda y plazobcra_blocked: posición monetaria bloqueada según el criterio BCRAavailable_holdings: tenencias disponibles de la cuentacompromised_holdings: tenencias comprometidas, si fueron solicitadasremunerated_balance: saldo remunerado, si fue solicitado y la cuenta lo tiene activo
Estructura de available_holdings
available_holdingsCada elemento dentro de available_holdings representa una tenencia disponible.
| Campo | Tipo | Descripción |
|---|---|---|
market_type | string | Tipo de mercado en el que opera. |
instrument_id | integer | Código del instrumento en tenencia. |
quantity | number | Cantidad total del instrumento en tenencia. |
quantity_available | number | Cantidad disponible en contado inmediato. |
quantity_t1 | number | Cantidad aditiva disponible a 24 horas. |
quantity_t2 | number | Cantidad aditiva disponible a 48 horas. |
quantity_future | number | Cantidad comprometida a futuro. |
quantity_unavailable | number | Cantidad no disponible. |
available_t0 | number | Disponible para operar en contado inmediato. |
available_t1 | number | Disponible para operar a 24 horas. |
available_t2 | number | Disponible para operar a 48 horas. |
instrument_description | string | Descripción del instrumento. |
instrument_type | string | Tipo de activo. |
ticker | string | Símbolo del instrumento. |
updated_at | string | Fecha y hora del último cambio en la tenencia. |
Estructura de compromised_holdings
compromised_holdingsCada elemento dentro de compromised_holdings representa una tenencia comprometida.
| Campo | Tipo | Descripción |
|---|---|---|
instrument_id | integer | Código del instrumento comprometido. |
instrument_type | string | Tipo de activo comprometido. |
currency_id | string | Moneda asociada al instrumento. |
quantity | number | Cantidad comprometida. |
market_type | string | Tipo de mercado en el que opera. |
Sobre include_remunerated_balance
include_remunerated_balanceCuando enviás include_remunerated_balance=true y la cuenta remunera, la respuesta puede incluir un nodo como este:
{
"remunerated_balance": {
"ARS": {
"instrument_type": "CURRENCY",
"amount": 0,
"available_amount": 0,
"used_overdraft": 0,
"market_type": "stock_market"
}
}
}Respuesta esperada
{
"items": [
{
"investment_account_id": 74659,
"available_amount": {
"stock_market": {
"ARS": {
"t0": {
"amount": 1000
},
"t1": {
"amount": 1000
},
"t2": {
"amount": 1000
}
}
}
},
"bcra_blocked": {
"stock_market": {
"USD": {
"t0": {
"amount": 100
}
}
}
},
"available_holdings": [
{
"quantity": 150,
"quantity_available": 100,
"quantity_t1": 25,
"quantity_t2": 25,
"quantity_future": 0,
"quantity_unavailable": 0,
"available_t0": 100,
"available_t1": 125,
"available_t2": 150,
"instrument_description": "Bono soberano AL30",
"instrument_type": "bond",
"ticker": "AL30",
"instrument_id": 123,
"market_type": "stock_market",
"updated_at": "2026-04-17T15:30:00Z"
}
]
}
]
}Cuándo usar este endpoint
Este endpoint es útil cuando necesitás:
- consultar el estado consolidado de una cuenta comitente
- revisar posición monetaria y tenencias en una sola respuesta
- incluir tenencias comprometidas o saldo remunerado cuando aplique
Errores frecuentes
422 Validation Error: alguno de los parámetros tiene un formato inválido.
Siguiente paso
Si necesitás el detalle aislado de las tenencias o de la posición monetaria, continuá con GET /api/portfolio/holdings/{investment_account_id} o GET /api/portfolio/account-balances/{investment_account_id}.
