Get account holdings

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Consultá las tenencias de instrumentos de una cuenta comitente usando su investment_account_id.

Antes de empezar

Tené a mano el investment_account_id de la cuenta comitente que querés consultar.
Usá este endpoint cuando necesites revisar la cartera de instrumentos disponibles, comprometidos o no disponibles.
Si además necesitás la posición monetaria o el estado de cuenta completo, usá GET /api/portfolio/account-balances/{investment_account_id} o GET /api/portfolio/account-statements/{investment_account_id}.

Cómo consultar las tenencias

GET /api/portfolio/holdings/{investment_account_id}

Path parameters

Parámetro	Tipo	Requerido	Descripción
`investment_account_id`	integer	Sí	Identificador de la cuenta comitente en ApiBroker.

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa el conjunto de tenencias de una cuenta comitente.

Cada elemento incluye:

investment_account_id: identificador de la cuenta consultada
holdings: lista de instrumentos en tenencia
version: versión del snapshot de tenencias, si está disponible

Estructura de `holdings`

Cada elemento dentro de holdings representa un instrumento en cartera.

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 en tenencia.
`instrument_type`	string	Tipo de activo, por ejemplo `bond`, `cedear`, `currency` o `fund`.
`ticker`	string	Símbolo del instrumento.
`updated_at`	string	Fecha y hora del último cambio en la tenencia.

Cómo interpretar `instrument_id`

Si instrument_type es fund, instrument_id corresponde al mutual_fund_id.
Si instrument_type es distinto de fund, instrument_id corresponde al market_instrument_id.

Respuesta esperada

{
  "items": [
    {
      "investment_account_id": 74659,
      "holdings": [
        {
          "market_type": "stock_market",
          "instrument_id": 123,
          "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",
          "updated_at": "2026-04-17T15:30:00Z"
        },
        {
          "market_type": "stock_market",
          "instrument_id": 45,
          "quantity": 95.5,
          "quantity_available": 95.5,
          "quantity_t1": 0,
          "quantity_t2": 0,
          "quantity_future": 0,
          "quantity_unavailable": 0,
          "available_t0": 95.5,
          "available_t1": 95.5,
          "available_t2": 95.5,
          "instrument_description": "FCI Renta Pesos",
          "instrument_type": "fund",
          "ticker": "FCIRP",
          "updated_at": "2026-04-17T15:30:00Z"
        }
      ]
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

consultar la cartera de instrumentos de una cuenta comitente
revisar disponibilidad por plazo
diferenciar tenencias disponibles, futuras o no disponibles

Errores frecuentes

422 Validation Error: el investment_account_id tiene un formato inválido.

Siguiente paso

Si además necesitás la posición monetaria o el estado de cuenta completo, continuá con GET /api/portfolio/account-balances/{investment_account_id} o GET /api/portfolio/account-statements/{investment_account_id}.