Obtener operaciones por cuenta

Devuelve un listado paginado de operaciones de mercado (operaciones de fondos comunes, órdenes de mercado, órdenes de caución y operaciones MEP) registradas para una cuenta determinada.

Se puede filtrar por tipo, estado, rango de fechas, período de liquidación y moneda.

GET/v1/broker/operations/{account-id}

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN

Path Parameters

Campo	Tipo	Requerido	Descripción
account-id	integer	Sí	Número de cuenta para el cual se obtienen las operaciones.

Query Parameters

Campo	Tipo	Requerido	Descripción
type	array of strings	No	Filtra por subtipo de instrumento/operación. Repetir el parámetro para pasar múltiples valores (por ejemplo type=BONDS&type=CEDEARS). Valores posibles: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
state	array of strings	No	Filtra por estado de la operación. Repetir el parámetro para pasar múltiples valores. Valores posibles: PENDING, PARTIALLY_FILLED, FILLED, PARTIALLY_CANCELLED, REJECTED, CANCELLED.
from	string (date)	No	Fecha de inicio del rango (inclusive), en formato yyyy-MM-dd.
to	string (date)	No	Fecha de fin del rango (inclusive), en formato yyyy-MM-dd.
settledPeriod	array of strings	No	Filtra por período de liquidación. Repetir el parámetro para pasar múltiples valores. Valores posibles: T0, T1.
currency	array of strings	No	Filtra por moneda. Repetir el parámetro para pasar múltiples valores. Valores posibles: ARS, DOLLAR_MEP, DOLLAR_CCL.
page	integer	No	Número de página (base 0). Default: 0.
size	integer	No	Cantidad de resultados por página. Default: 20.

No aplica: Body.

Response

2XX Éxito

Solo se completa un objeto anidado por registro

Cada entrada de data representa una operación. Solo uno de fund, order o mep_operation está presente, según el valor de type — los otros dos son null:

type	Objeto presente
FUND	fund
ORDER o REPO_ORDER	order
MEP_OPERATION	mep_operation

Campo	Tipo	Descripción
data	array of objects	Listado de operaciones que cumplen con los filtros solicitados, para la página actual.
data[].id	integer	Identificador interno de la operación.
data[].type	string	Tipo de operación. Valores posibles: FUND, ORDER, REPO_ORDER, MEP_OPERATION.
data[].email	string	Email del usuario que solicitó la operación.
data[].fund	object	Detalle de la operación de fondo común. Presente solo cuando type es FUND; null en caso contrario.
data[].fund.user_id	integer	Identificador del usuario que solicitó la operación.
data[].fund.fund_operation	string	Tipo de operación de fondo. Valores posibles: SUBSCRIBE (suscripción), RETRIEVE (rescate).
data[].fund.fund_code	string	Identificador Bloomberg del fondo común de inversión.
data[].fund.fund_name	string	Nombre completo del fondo común de inversión.
data[].fund.currency	string	Moneda de la operación. Valores posibles: ARS, DOLLAR_MEP, DOLLAR_CCL.
data[].fund.account_number	integer	Número de cuenta para el cual se ejecutó la operación.
data[].fund.amount	number	Monto operado, en la moneda del fondo.
data[].fund.price_per_share	number	Precio por cuotaparte al momento en que se liquidó la operación. null hasta que se conoce.
data[].fund.shares	number	Cantidad de cuotapartes involucradas en la operación. null hasta que se conoce.
data[].fund.total	boolean	Indica si la operación aplicó sobre la posición total en lugar de un amount específico.
data[].fund.settled_period	string	Período de liquidación. Valores posibles: T0, T1.
data[].fund.settlement_date	string (ISO 8601 datetime)	Fecha y hora en que la operación se liquida o liquidó. null hasta que se conoce.
data[].fund.trade_date	string (ISO 8601 datetime)	Fecha y hora en que se concertó la operación. null hasta que se conoce.
data[].fund.created_at	string (ISO 8601 datetime)	Fecha y hora en que se creó la operación.
data[].fund.state	string	Estado de la operación de fondo. Valores posibles: PENDING, EXECUTED, FILLED, FAILED, INSUFFICIENT_POSITION.
data[].order	object	Detalle de la orden de mercado. Presente solo cuando type es ORDER o REPO_ORDER; null en caso contrario.
data[].order.id	integer	Identificador interno de la orden.
data[].order.type	string	Tipo de orden. Valores posibles: MARKET, LIMIT, STOP_LIMIT.
data[].order.quantity	number	Cantidad de nominales solicitados.
data[].order.executed_quantity	number	Cantidad de nominales efectivamente ejecutados.
data[].order.amount	number	Monto monetario solicitado.
data[].order.symbol	string	Ticker del instrumento operado.
data[].order.market	string	Mercado al que se enrutó la orden (por ejemplo byma).
data[].order.side	string	Lado de la operación. Valores posibles: BUY, SELL.
data[].order.currency	string	Moneda de la orden. Valores posibles: ARS, DOLLAR_MEP, DOLLAR_CCL.
data[].order.settled_period	string	Período de liquidación. Valores posibles: T0, T1.
data[].order.executed_amount	number	Monto monetario efectivamente ejecutado.
data[].order.executed_price	number	Precio al cual se ejecutó la orden.
data[].order.account_number	integer	Número de cuenta al que pertenece la orden.
data[].order.state	string	Estado actual de la orden. Valores posibles: SENT_TO_MARKET, PENDING, FILLED, CANCELLED, REJECTED, ERROR.
data[].order.user_id	integer	Identificador del usuario que colocó la orden.
data[].order.operation_sub_type	string	Categoría del instrumento. Valores posibles: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
data[].order.created_at	string (ISO 8601 datetime)	Fecha y hora en que se creó la orden.
data[].order.market_order_estimated_price	number	Precio de referencia estimado al momento de colocar la orden.
data[].order.allaria_fee	number	Comisión de Allaria cobrada por la orden.
data[].order.byma_fee	number	Comisión de BYMA cobrada por la orden.
data[].order.allaria_fee_percentage	number	Porcentaje de comisión de Allaria aplicado.
data[].order.allaria_min_fee	number	Comisión mínima de Allaria aplicada.
data[].order.net_amount	number	Monto neto de la orden, incluyendo comisiones. Se completa solo cuando la orden alcanza el estado FILLED.
data[].order.repo_future_gross_amount	number	Monto bruto a liquidar al vencimiento. Se completa solo para órdenes de caución.
data[].order.repo_future_net_amount	number	Monto neto a liquidar al vencimiento, después de comisiones. Se completa solo para órdenes de caución.
data[].order.oms_client_id	string	Identificador asignado a la orden por el sistema de gestión de órdenes (OMS).
data[].order.has_been_edited	boolean	Indica si la orden fue editada al menos una vez.
data[].order.error_description	string	Descripción del error, si la orden terminó en estado ERROR.
data[].mep_operation	object	Detalle de la operación MEP. Presente solo cuando type es MEP_OPERATION; null en caso contrario.
data[].mep_operation.id	string	ID externo de la operación MEP.
data[].mep_operation.account_id	string	Número de cuenta al que pertenece la operación.
data[].mep_operation.amount_in_ars	number	Monto total de la operación en ARS.
data[].mep_operation.amount_in_usd	number	Monto total de la operación en USD.
data[].mep_operation.state	string	Estado actual de la operación MEP. Valores posibles: SENT_TO_OMS_TO_BUY, BOND_BOUGHT, SENT_TO_OMS_TO_SELL, BOND_SOLD, CANCELLED, UNKNOWN, REJECTED_BUY, REJECTED_SELL, COMPLETED, PENDING.
data[].mep_operation.transact_time_buy	string (ISO 8601 datetime)	Timestamp de ejecución de la pata de compra.
data[].mep_operation.transact_time_sell	string (ISO 8601 datetime)	Timestamp de ejecución de la pata de venta.
data[].mep_operation.executed_amount	number	Monto total efectivamente ejecutado.
data[].mep_operation.quantity	integer	Cantidad del instrumento operado.
data[].mep_operation.net_amount	number	Monto neto de la operación después de comisiones.
data[].state	string	Estado actual de la operación. Valores posibles: PENDING, PARTIALLY_FILLED, FILLED, PARTIALLY_CANCELLED, REJECTED, CANCELLED.
data[].currency	string	Moneda de la operación. Valores posibles: ARS, DOLLAR_MEP, DOLLAR_CCL.
data[].settled_period	string	Período de liquidación. Valores posibles: T0, T1.
data[].sub_type	string	Subtipo de instrumento/operación. Valores posibles: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
data[].settlement_date	string (ISO 8601 date)	Fecha de liquidación de la operación, en formato yyyy-MM-dd.
data[].tag	object	Metadatos clave-valor opcionales asociados a la operación.
total	integer	Cantidad total de operaciones que cumplen con los filtros.
page	integer	Número de página actual (base 0).
size	integer	Cantidad de resultados por página.

Códigos de error

Status	Descripción
400	Bad Request — parámetros inválidos o faltantes, o el número de cuenta no es accesible para el usuario autenticado
401	Unauthorized — token de acceso inválido o faltante
403	Forbidden — el token no tiene permiso para acceder a este recurso
500	Internal Server Error

Estructura del error:

{
  "code": "invalid_request",
  "description": "Invalid account number: 70104"
}

Ejemplo de código

cURL

curl -X GET "https://b2b.allaria.cloud/v1/broker/operations/70104?type=BONDS&state=FILLED&from=2026-07-01&to=2026-07-21&page=0&size=20" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const accountId = 70104;

const params = new URLSearchParams();
params.append('type', 'BONDS');
params.append('state', 'FILLED');
params.append('from', '2026-07-01');
params.append('to', '2026-07-21');
params.append('page', '0');
params.append('size', '20');

const response = await fetch(
  `https://b2b.allaria.cloud/v1/broker/operations/${accountId}?${params}`,
  {
    method: 'GET',
    headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
  }
);
const data = await response.json();
console.log(data);

Python

import requests

account_id = 70104

response = requests.get(
  f'https://b2b.allaria.cloud/v1/broker/operations/{account_id}',
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' },
  params={
    'type': 'BONDS',
    'state': 'FILLED',
    'from': '2026-07-01',
    'to': '2026-07-21',
    'page': 0,
    'size': 20
  }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const accountId = 70104;

const response = await axios.get(
  `https://b2b.allaria.cloud/v1/broker/operations/${accountId}`,
  {
    headers: { Authorization: 'Bearer ACCESS_TOKEN' },
    params: {
      type: 'BONDS',
      state: 'FILLED',
      from: '2026-07-01',
      to: '2026-07-21',
      page: 0,
      size: 20
    }
  }
);
console.log(response.data);

2XX Éxito

{
  "data": [
    {
      "id": 501234,
      "type": "ORDER",
      "email": "cliente@example.com",
      "fund": null,
      "order": {
        "id": 984512,
        "type": "MARKET",
        "quantity": 6.0,
        "executed_quantity": 6.0,
        "amount": null,
        "symbol": "AL30",
        "market": "byma",
        "side": "BUY",
        "currency": "ARS",
        "settled_period": "T0",
        "executed_amount": 4890.00,
        "executed_price": 815.00,
        "account_number": 70104,
        "state": "FILLED",
        "user_id": 4521,
        "operation_sub_type": "BONDS",
        "created_at": "2026-07-15T10:32:11",
        "market_order_estimated_price": 814.50,
        "allaria_fee": 24.45,
        "byma_fee": 2.93,
        "allaria_fee_percentage": 0.5,
        "allaria_min_fee": 100.00,
        "net_amount": 4917.38,
        "repo_future_gross_amount": null,
        "repo_future_net_amount": null,
        "oms_client_id": "OPX-000123456",
        "has_been_edited": false,
        "error_description": null
      },
      "mep_operation": null,
      "state": "FILLED",
      "currency": "ARS",
      "settled_period": "T0",
      "sub_type": "BONDS",
      "settlement_date": "2026-07-15",
      "tag": {}
    },
    {
      "id": 501235,
      "type": "FUND",
      "email": "cliente@example.com",
      "fund": {
        "user_id": 987654,
        "fund_operation": "SUBSCRIBE",
        "fund_code": "ALRRFIJA AR",
        "fund_name": "Allaria Renta Fija",
        "currency": "ARS",
        "account_number": 70104,
        "amount": 10000.00,
        "price_per_share": 1523.47,
        "shares": 6.5638,
        "total": false,
        "settled_period": "T0",
        "settlement_date": "2026-07-21T18:00:00",
        "trade_date": "2026-07-21T15:32:10",
        "created_at": "2026-07-21T15:32:10",
        "state": "EXECUTED"
      },
      "order": null,
      "mep_operation": null,
      "state": "PENDING",
      "currency": "ARS",
      "settled_period": "T0",
      "sub_type": "FUND",
      "settlement_date": "2026-07-21",
      "tag": {}
    },
    {
      "id": 501236,
      "type": "MEP_OPERATION",
      "email": "cliente@example.com",
      "fund": null,
      "order": null,
      "mep_operation": {
        "id": "b7e4f2a1-9c3d-4e5f-8a1b-2d3e4f5a6b7c",
        "account_id": "70104",
        "amount_in_ars": 1250000.50,
        "amount_in_usd": 1000.00,
        "state": "BOND_SOLD",
        "transact_time_buy": "2026-07-20T10:15:32",
        "transact_time_sell": "2026-07-20T10:16:05",
        "executed_amount": 1249800.00,
        "quantity": 1000,
        "net_amount": 998500.00
      },
      "state": "FILLED",
      "currency": "DOLLAR_MEP",
      "settled_period": "T0",
      "sub_type": "MEP_OPERATION",
      "settlement_date": "2026-07-20",
      "tag": { "reference": "op-001" }
    }
  ],
  "total": 3,
  "page": 0,
  "size": 20
}