Get account statements

Obtiene el estado de cuenta de una cuenta comitente e incluye posición monetaria y tenencias disponibles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Consultá el estado de cuenta de una cuenta comitente, incluyendo posición monetaria y tenencias disponibles.

Antes de empezar

  1. Tené a mano el investment_account_id de la cuenta comitente que querés consultar.
  2. Definí position_discriminator_bcra=false si querés ver los dólares sin discriminar entre disponibles y bloqueados.
  3. Definí compromised_holdings=true si querés incluir las tenencias comprometidas en la respuesta.
  4. Definí include_remunerated_balance=true si 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=true

Incluir tenencias comprometidas

GET /api/portfolio/account-statements/{investment_account_id}?compromised_holdings=true

Incluir saldo remunerado

GET /api/portfolio/account-statements/{investment_account_id}?include_remunerated_balance=true

Combinar parámetros

GET /api/portfolio/account-statements/{investment_account_id}?position_discriminator_bcra=true&compromised_holdings=true&include_remunerated_balance=true

Parámetros

Path parameters

ParámetroTipoRequeridoDescripción
investment_account_idintegerSíIdentificador de la cuenta comitente en ApiBroker.

Query parameters

ParámetroTipoRequeridoDefaultDescripción
position_discriminator_bcrabooleanNotrueSi enviás false, la respuesta devuelve el total en dólares sin discriminar entre montos disponibles y bloqueados.
compromised_holdingsbooleanNofalseSi enviás true, la respuesta incluye las tenencias comprometidas.
include_remunerated_balancebooleanNofalseSi 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 consultada
  • available_amount: posición monetaria disponible agrupada por mercado, moneda y plazo
  • bcra_blocked: posición monetaria bloqueada según el criterio BCRA
  • available_holdings: tenencias disponibles de la cuenta
  • compromised_holdings: tenencias comprometidas, si fueron solicitadas
  • remunerated_balance: saldo remunerado, si fue solicitado y la cuenta lo tiene activo

Estructura de available_holdings

Cada elemento dentro de available_holdings representa una tenencia disponible.

CampoTipoDescripción
market_typestringTipo de mercado en el que opera.
instrument_idintegerCódigo del instrumento en tenencia.
quantitynumberCantidad total del instrumento en tenencia.
quantity_availablenumberCantidad disponible en contado inmediato.
quantity_t1numberCantidad aditiva disponible a 24 horas.
quantity_t2numberCantidad aditiva disponible a 48 horas.
quantity_futurenumberCantidad comprometida a futuro.
quantity_unavailablenumberCantidad no disponible.
available_t0numberDisponible para operar en contado inmediato.
available_t1numberDisponible para operar a 24 horas.
available_t2numberDisponible para operar a 48 horas.
instrument_descriptionstringDescripción del instrumento.
instrument_typestringTipo de activo.
tickerstringSímbolo del instrumento.
updated_atstringFecha y hora del último cambio en la tenencia.

Estructura de compromised_holdings

Cada elemento dentro de compromised_holdings representa una tenencia comprometida.

CampoTipoDescripción
instrument_idintegerCódigo del instrumento comprometido.
instrument_typestringTipo de activo comprometido.
currency_idstringMoneda asociada al instrumento.
quantitynumberCantidad comprometida.
market_typestringTipo de mercado en el que opera.

Sobre include_remunerated_balance

Cuando 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}.

Path Params
integer
required
Query Params
boolean
Defaults to true
boolean
Defaults to false
boolean
Defaults to false
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json