post
https://example.com/api/market/mep-order
Crea una solicitud de compra o venta de dólar MEP desde una cuenta comitente.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Creá una solicitud de compra o venta de dólar MEP usando una cuenta comitente y un base_instrument_id.
Antes de empezar
- Tené a mano el
investment_account_idde la cuenta comitente que va a operar. - Obtené el
base_instrument_iddel instrumento conGET /api/instruments/market/all. - Definí si la operación va a ser
buypara comprar USD MEP osellpara vender USD MEP. - Generá un
external_idúnico para evitar duplicados y poder reconciliar la respuesta. - Si querés controlar el horario de la segunda orden, enviá
order_2_scheduled_timeen formatoHH:MMsobre UTC.
Cómo crear una solicitud de dólar MEP
POST /api/market/mep-order
Content-Type: application/jsonBody parameters
El body acepta un objeto InsertMEPMarketOrder.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
investment_account_id | integer | Sí | Identificador de la cuenta comitente en ApiBroker. |
amount | number | Sí | Importe de la operación. |
base_instrument_id | integer | Sí | Identificador del instrumento base con el que se realiza la operatoria. |
market_operation_type | string | Sí | Tipo de operación: buy o sell. |
order_2_scheduled_time | string | No | Horario UTC para la segunda orden, en formato HH:MM. |
external_id | string | Sí | 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_idymarket_operation_type.
Consideraciones sobre order_2_scheduled_time
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_timeparabuy, el horario por default es16:30UTC. - 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_timeparasell, el sistema toma como default 10 minutos después de creada la primera orden.
Posibles estados de la solicitud MEP
status | Descripción |
|---|---|
PENDING | La solicitud fue creada y todavía está en proceso de ejecución. |
COMPLETED | La operatoria se completó correctamente. |
CANCELLED | La solicitud fue cancelada. |
ERROR | Ocurrió un error durante la operatoria. |
RETRY | La 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.
| Campo | Tipo | Descripción |
|---|---|---|
mep_market_order_id | integer | Código identificador de la solicitud. |
investment_account_id | integer | Cuenta comitente que envió la solicitud. |
base_instrument_id | integer | Identificador del instrumento base. |
market_operation_type | string | Tipo de operación. |
amount | number | Importe operado. |
status | string | Estado actual de la solicitud. |
external_id | string | Identificador externo enviado en la request. |
market_order_id_1 | integer | Identificador de la primera orden generada. |
market_order_id_2 | integer | Identificador de la segunda orden generada. |
message | string | Mensaje asociado a la operación. |
error_code | string | Código de error, si corresponde. |
created_at | string | Fecha de creación de la solicitud. |
updated_at | string | Fecha 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 mismoexternal_ido 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.
