Ejecutar operación MEP por broker

Ejecuta una operación de compra o venta de dólar MEP para una cuenta específica.

MEP y el segmento broker del path

El "dólar MEP" es la vía legal de comprar o vender dólares en Argentina a través del mercado de valores: se compra un bono en pesos y se vende el mismo bono en dólares. Allaria ejecuta las dos patas.

El broker del path es un nombre de servicio interno, no algo que configures — ver el Glosario.

POST/v1/broker/operations/mep/{account-id}/{side}

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN
Content-Type	string	Sí	Debe ser application/json

Path Parameters

Campo	Tipo	Requerido	Descripción
account-id	integer	Sí	Número de cuenta sobre la cual se ejecuta la operación.
side	string	Sí	Lado de la operación. Valores posibles: buy, sell (no distingue mayúsculas/minúsculas).

No aplica: Query Parameters.

Body

La unidad de amount depende de side

El campo amount está denominado en distinta moneda según el lado de la operación:

• buy: amount está en ARS (pesos argentinos). El sistema convierte a USD usando la cotización MEP.
• sell: amount está en USD.

Campo	Tipo	Requerido	Descripción
amount	number	Sí	Monto de la operación. ARS cuando side es buy; USD cuando side es sell.
estimated_price	number	Sí	Cotización MEP estimada (ARS por USD) al momento en que el cliente confirma la operación.
tag	object	No	Mapa clave-valor opcional para metadatos personalizados (por ejemplo { "reference": "op-001" }).

Response

2XX Éxito

Campo	Tipo	Descripción
id	string	Identificador único de la operación MEP ejecutada.
executed_at	string (ISO 8601 datetime)	Timestamp en que se ejecutó la operación.
estimated_price	number	Cotización MEP utilizada para ejecutar la operación (ARS por USD).

Códigos de error

Status	Descripción
400	Bad Request — parámetros inválidos o faltantes, o side no es buy/sell
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 side: hold"
}

Ejemplo de código

cURL

curl -X POST https://b2b.allaria.cloud/v1/broker/operations/mep/70104/buy \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000.00,
    "estimated_price": 1245.50,
    "tag": { "reference": "op-001" }
  }'

JavaScript

const accountId = 70104;
const side = 'buy';

const response = await fetch(
  `https://b2b.allaria.cloud/v1/broker/operations/mep/${accountId}/${side}`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      amount: 10000.00,
      estimated_price: 1245.50,
      tag: { reference: 'op-001' }
    })
  }
);
const data = await response.json();
console.log(data);

Python

import requests

account_id = 70104
side = 'buy'

response = requests.post(
  f'https://b2b.allaria.cloud/v1/broker/operations/mep/{account_id}/{side}',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={
    'amount': 10000.00,
    'estimated_price': 1245.50,
    'tag': { 'reference': 'op-001' }
  }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const accountId = 70104;
const side = 'buy';

const response = await axios.post(
  `https://b2b.allaria.cloud/v1/broker/operations/mep/${accountId}/${side}`,
  {
    amount: 10000.00,
    estimated_price: 1245.50,
    tag: { reference: 'op-001' }
  },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);
console.log(response.data);

2XX Éxito

{
  "id": "3f1c2b4a-5d6e-4f7a-8b9c-0d1e2f3a4b5c",
  "executed_at": "2026-07-21T14:30:45.123456",
  "estimated_price": 1245.50
}