Obtener orden por ID

Devuelve una única orden identificada por su ID interno.

GET/v1/broker/orders/id/{order-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
order-id	integer	Sí	Identificador interno de la orden a obtener.

No aplica: Query Parameters, Body.

Response

2XX Éxito

Campo	Tipo	Descripción
id	integer	Identificador interno de la orden.
type	string	Tipo de orden. Valores posibles: MARKET, LIMIT, STOP_LIMIT.
quantity	number	Cantidad de nominales solicitada.
executed_quantity	number	Cantidad de nominales efectivamente ejecutada.
amount	number	Monto solicitado.
symbol	string	Ticker del instrumento operado.
market	string	Mercado al que fue enrutada la orden (ej. byma).
side	string	Lado de la operación. Valores posibles: BUY, SELL.
currency	string	Moneda de la orden. Valores posibles: ARS, DOLLAR_MEP, DOLLAR_CCL.
settled_period	string	Período de liquidación. Valores posibles: T0, T1.
executed_amount	number	Monto efectivamente ejecutado.
executed_price	number	Precio al cual se ejecutó la orden.
account_number	integer	Número de cuenta a la que pertenece la orden.
state	string	Estado actual de la orden. Valores posibles: SENT_TO_MARKET, PENDING, FILLED, CANCELLED, REJECTED, ERROR.
user_id	integer	Identificador del usuario que envió la orden.
operation_sub_type	string	Categoría del instrumento. Valores posibles: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
created_at	string (datetime ISO 8601)	Marca de tiempo de creación de la orden.
market_order_estimated_price	number	Precio de referencia estimado al momento de enviar la orden.
allaria_fee	number	Comisión de Allaria cobrada por la orden.
byma_fee	number	Comisión de BYMA cobrada por la orden.
allaria_fee_percentage	number	Porcentaje de comisión de Allaria aplicado.
allaria_min_fee	number	Comisión mínima de Allaria aplicada.
net_amount	number	Monto neto de la orden, incluyendo comisiones. Solo se completa una vez que la orden alcanza el estado FILLED.
repo_future_gross_amount	number	Monto bruto a liquidar al vencimiento. Solo se completa para órdenes de caución (repo).
repo_future_net_amount	number	Monto neto a liquidar al vencimiento, luego de comisiones. Solo se completa para órdenes de caución (repo).
oms_client_id	string	Identificador asignado a la orden por el sistema de gestión de órdenes (OMS).
has_been_edited	boolean	Indica si la orden fue editada al menos una vez.
error_description	string	Descripción del error, si la orden terminó en estado ERROR.

Códigos de error

Status	Descripción
400	Bad Request — no existe ninguna orden con el order-id indicado
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": "Order 984512 not found"
}

Ejemplo de código

cURL

curl -X GET https://b2b.allaria.cloud/v1/broker/orders/id/984512 \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const orderId = 984512;

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

Python

import requests

order_id = 984512

response = requests.get(
  f'https://b2b.allaria.cloud/v1/broker/orders/id/{order_id}',
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const orderId = 984512;

const response = await axios.get(
  `https://b2b.allaria.cloud/v1/broker/orders/id/${orderId}`,
  { headers: { Authorization: 'Bearer ACCESS_TOKEN' } }
);
console.log(response.data);

2XX Éxito

{
  "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
}