Get movements by investment account id

Time	Status	User Agent
Retrieving recent requests…

Consultá los movimientos asociados a una cuenta comitente usando su investment_account_id y filtrá por rango de fechas, paginación u ordenamiento.

Antes de empezar

Tené a mano el investment_account_id de la cuenta comitente que querés consultar.
Agregá from_date y to_date si querés limitar el resultado a un período específico.
Usá order_by, order, page y size para ordenar y paginar el resultado según tu necesidad.

Cómo consultar movimientos por cuenta comitente

GET /api/portfolio/movements-by-investment-account/{investment_account_id}

Filtrar por rango de fechas y ordenar

GET /api/portfolio/movements-by-investment-account/{investment_account_id}?from_date=2026-01-01&to_date=2026-01-31&order_by=trade_date&order=desc&page=1&size=50

Pará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
`order_by`	string	No	—	Campo por el cual ordenar. Valores posibles: `trade_date`, `settlement_date`.
`order`	string	No	`asc`	Orden del resultado. Valores posibles: `asc`, `desc`.
`page`	integer	No	`1`	Número de página. Mínimo `1`.
`size`	integer	No	`50`	Cantidad de registros por página. Mínimo `1`, máximo `100`.
`from_date`	string	No	—	Fecha desde, inclusive, en formato `YYYY-MM-DD`.
`to_date`	string	No	—	Fecha hasta, inclusive, en formato `YYYY-MM-DD`.

Qué devuelve este endpoint

La respuesta devuelve un objeto paginado con:

items: lista de movimientos asociados a la cuenta
total: cantidad total de registros encontrados
page: página actual
size: cantidad de registros por página

Cada elemento dentro de items representa un movimiento y puede incluir:

Campo	Tipo	Descripción
`movement_id`	integer	Identificador único del movimiento.
`investment_account_id`	integer	Identificador de la cuenta comitente.
`trade_date`	string	Fecha de concertación del movimiento.
`settlement_date`	string	Fecha de liquidación del movimiento.
`detail`	string	Descripción detallada del movimiento.
`instrument_type`	string	Tipo de instrumento asociado al movimiento.
`instrument_id`	integer	Identificador del instrumento asociado. Puede ser `null` en movimientos monetarios.
`concept`	string	Concepto que clasifica el tipo de movimiento.
`market_type`	string	Tipo de mercado en el que se registra el movimiento.
`quantity`	number	Cantidad operada. Puede ser `null` en movimientos monetarios.
`price`	number	Precio unitario del activo. Puede ser `null` en movimientos monetarios.
`net_amount`	number	Importe neto del movimiento.
`gross_amount`	number	Importe bruto del movimiento.
`currency_id`	string	Moneda del movimiento.
`create_time`	string	Fecha y hora de creación del movimiento.
`update_time`	string	Fecha y hora de última actualización.
`cancelled`	boolean	Indica si el movimiento fue cancelado.

Consideraciones

order_by admite únicamente trade_date o settlement_date.
order admite únicamente asc o desc.
size está acotado a un máximo de 100.
Algunos campos pueden venir en null según el tipo de movimiento, por ejemplo instrument_id, quantity o price en movimientos monetarios.
net_amount y gross_amount pueden tener signo positivo o negativo:
- valores positivos indican ingreso de fondos o acreditación
- valores negativos indican egreso de fondos o débito
Si cancelled=true, el movimiento no debería considerarse vigente a nivel operativo.

Respuesta esperada

{
  "items": [
    {
      "movement_id": 501,
      "investment_account_id": 74659,
      "trade_date": "2026-01-15",
      "settlement_date": "2026-01-16",
      "detail": "Compra de AL30",
      "instrument_type": "bond",
      "instrument_id": 123,
      "concept": "market_order",
      "market_type": "stock_market",
      "quantity": 10,
      "price": 1250.5,
      "net_amount": -12505,
      "gross_amount": -12500,
      "currency_id": "ARS",
      "create_time": "2026-01-15T11:52:58Z",
      "update_time": "2026-01-15T11:52:58Z",
      "cancelled": false
    }
  ],
  "total": 1,
  "page": 1,
  "size": 50
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

consultar el historial operativo de una cuenta comitente
revisar ingresos y egresos de fondos
construir reportes o conciliaciones por fecha de operación o liquidación

Errores frecuentes

422 Validation Error: alguno de los parámetros tiene un formato inválido.

Siguiente paso

Si necesitás una vista consolidada de saldos y tenencias además de los movimientos, continuá con GET /api/portfolio/account-statements/{investment_account_id}.