Insert Mep Order Request

Crea una solicitud de compra o venta de dólar MEP desde una cuenta comitente.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Creá una solicitud de compra o venta de dólar MEP usando una cuenta comitente y un base_instrument_id.

Antes de empezar

  1. Tené a mano el investment_account_id de la cuenta comitente que va a operar.
  2. Obtené el base_instrument_id del instrumento con GET /api/instruments/market/all.
  3. Definí si la operación va a ser buy para comprar USD MEP o sell para vender USD MEP.
  4. Generá un external_id único para evitar duplicados y poder reconciliar la respuesta.
  5. Si querés controlar el horario de la segunda orden, enviá order_2_scheduled_time en formato HH:MM sobre UTC.

Cómo crear una solicitud de dólar MEP

POST /api/market/mep-order
Content-Type: application/json

Body parameters

El body acepta un objeto InsertMEPMarketOrder.

CampoTipoRequeridoDescripción
investment_account_idintegerSíIdentificador de la cuenta comitente en ApiBroker.
amountnumberSíImporte de la operación.
base_instrument_idintegerSíIdentificador del instrumento base con el que se realiza la operatoria.
market_operation_typestringSíTipo de operación: buy o sell.
order_2_scheduled_timestringNoHorario UTC para la segunda orden, en formato HH:MM.
external_idstringSíIdentificador único de la petición.

Cómo funciona la operatoria

  • Este endpoint opera en días hábiles.
  • Todas las órdenes se cursan en contado inmediato.
  • market_operation_type=buy:
    • el sistema envía primero la orden de compra en ARS
    • luego envía la segunda orden para obtener USD
  • market_operation_type=sell:
    • el sistema envía primero la orden de compra en USD
    • luego envía la segunda orden para obtener ARS
  • El sistema detecta automáticamente en qué moneda debe operar según base_instrument_id y market_operation_type.

Consideraciones sobre order_2_scheduled_time

  • Enviá este campo siempre en UTC.
  • Formato esperado: HH:MM. Ejemplo: 15:30.
  • Si la operación es buy, el horario corresponde al envío de la orden de venta del día siguiente.
  • Si no enviás order_2_scheduled_time para buy, el horario por default es 16:30 UTC.
  • Si la operación es sell, el horario corresponde al envío de la segunda orden en el mismo día.
  • Si no enviás order_2_scheduled_time para sell, el sistema toma como default 10 minutos después de creada la primera orden.

Posibles estados de la solicitud MEP

statusDescripción
PENDINGLa solicitud fue creada y todavía está en proceso de ejecución.
COMPLETEDLa operatoria se completó correctamente.
CANCELLEDLa solicitud fue cancelada.
ERROROcurrió un error durante la operatoria.
RETRYLa operación quedó pendiente de reintento.

Ejemplo de request

{
  "investment_account_id": 74659,
  "amount": 100000,
  "base_instrument_id": 10,
  "market_operation_type": "buy",
  "order_2_scheduled_time": "15:30",
  "external_id": "mep_ext_123"
}

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa una solicitud MEP.

CampoTipoDescripción
mep_market_order_idintegerCódigo identificador de la solicitud.
investment_account_idintegerCuenta comitente que envió la solicitud.
base_instrument_idintegerIdentificador del instrumento base.
market_operation_typestringTipo de operación.
amountnumberImporte operado.
statusstringEstado actual de la solicitud.
external_idstringIdentificador externo enviado en la request.
market_order_id_1integerIdentificador de la primera orden generada.
market_order_id_2integerIdentificador de la segunda orden generada.
messagestringMensaje asociado a la operación.
error_codestringCódigo de error, si corresponde.
created_atstringFecha de creación de la solicitud.
updated_atstringFecha de última actualización.

Respuesta esperada

{
  "items": [
    {
      "mep_market_order_id": 3001,
      "investment_account_id": 74659,
      "base_instrument_id": 10,
      "market_operation_type": "buy",
      "amount": 100000,
      "status": "PENDING",
      "external_id": "mep_ext_123",
      "market_order_id_1": 1001,
      "market_order_id_2": 1002,
      "message": "",
      "error_code": "",
      "created_at": "2026-04-17T15:30:00Z",
      "updated_at": "2026-04-17T15:30:00Z"
    }
  ]
}

Errores frecuentes

  • 409 Conflict: ya existe una solicitud con el mismo external_id o hay un conflicto de negocio para la operatoria.
  • 422 Validation Error: alguno de los campos obligatorios tiene un formato inválido.
  • 500 Internal Server Error: ocurrió un error inesperado durante el procesamiento de la solicitud.

Siguiente paso

Usá GET /api/market/mep-order/{mep_market_order_id} para consultar el estado de una solicitud puntual.

Body Params
integer
required
number
required
≥ 0
integer
required
string
enum
required

Allowed market operations.

Allowed:
string
^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$

HH:MM on UTC

string
required
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json