Calcular comisiones MEP

Simula el cálculo de comisiones de una operación de dólar MEP sin ejecutarla.

POST/v1/operations/usd-mep/calculate-fees

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

No aplica: Path Parameters, Query Parameters.

Body

person_type se valida del lado del servidor

El campo está tipado como opcional, pero el servidor rechaza la solicitud con 400 si no puede resolverse (ya sea porque se omite o porque los datos de la cuenta necesarios para inferirlo están incompletos).

Campo	Tipo	Requerido	Descripción
amount	number	Sí	Monto a simular, en ARS.
side	string	Sí	Lado de la operación. Valores posibles: buy, sell.
account_id	string	Sí	Número de cuenta de cliente al que aplica la simulación.
person_type	string	No	Tipo de titular de la cuenta. Valores posibles: NATURAL, NATURAL_NON_RESIDENT, JURIDICAL.

Response

2XX Éxito

Campo	Tipo	Descripción
allaria_fee	number	Comisión cobrada por Allaria por la operación.
byma_fee	number	Comisión cobrada por BYMA (Bolsas y Mercados Argentinos) por la operación.
total_fees	number	Suma de todas las comisiones aplicadas a la operación.
gross_amount	number	Monto bruto de la operación, antes de comisiones.
net_amount	number	Monto neto de la operación, luego de comisiones.

Códigos de error

Status	Descripción
400	Bad Request — parámetros inválidos o faltantes
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": "BAD_REQUEST",
  "description": "person type is required"
}

Ejemplo de código

cURL

curl -X POST https://b2b.allaria.dev/v1/operations/usd-mep/calculate-fees \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100000.00,
    "side": "buy",
    "account_id": "12345",
    "person_type": "NATURAL"
  }'

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/operations/usd-mep/calculate-fees', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 100000.00,
    side: 'buy',
    account_id: '12345',
    person_type: 'NATURAL'
  })
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.post(
  'https://b2b.allaria.dev/v1/operations/usd-mep/calculate-fees',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={
    'amount': 100000.00,
    'side': 'buy',
    'account_id': '12345',
    'person_type': 'NATURAL'
  }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const response = await axios.post(
  'https://b2b.allaria.dev/v1/operations/usd-mep/calculate-fees',
  {
    amount: 100000.00,
    side: 'buy',
    account_id: '12345',
    person_type: 'NATURAL'
  },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);
console.log(response.data);

2XX Éxito

{
  "allaria_fee": 1250.00,
  "byma_fee": 15.75,
  "total_fees": 1265.75,
  "gross_amount": 100000.00,
  "net_amount": 98734.25
}