Saltar al contenido principal
POST
Enviar orden de mercado

Qué hace esta operación

Requiere cuenta verificada, trading habilitado e Idempotency-Key válida. El servicio devuelve 400 si falta el encabezado o su formato es inválido. Conserva clave y cuerpo antes de enviar; después guarda el ID MT5 y consulta su resultado.

Proceso completo

Consulta la guía paso a paso y los errores y su tratamiento. Los valores del explorador son ejemplos. Sustituye cuenta, símbolo, volumen y precio con datos válidos para tu integración.

SL y TP opcionales

sl y tp son precios absolutos. Puedes enviar uno o ambos al abrir; omitidos o null no se envían, y 0 indica ausencia del nivel. Se validan precisión y distancias; no se redondean precios inválidos. La protección de compra se valida respecto a Bid y la de venta respecto a Ask. Modificar órdenes o posiciones · Volumen en unidades MT5

Autorizaciones

Authorization
string
header
requerido

Envía el token entregado por el proveedor en el encabezado Authorization mediante autenticación Bearer.

Encabezados

Idempotency-Key
string
requerido

Persisted key for this intent. Reuse the same key and body when retrying; use a new key for another trading intent, including a modification.

Required string length: 16 - 128
Pattern: ^[A-Za-z0-9._:-]{16,128}$
Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

Cuerpo

application/json
login
integer
requerido

Login de la cuenta de trading.

Ejemplo:

104205

symbol
string
requerido

Nombre del símbolo MT5.

Required string length: 1 - 32
Pattern: ^[A-Za-z0-9._() -]+$
Ejemplo:

"EURUSD"

volume
integer
requerido

Integer MT5 units: 10000 = 1 lot, independent of contract size. Must match the symbol minimum, maximum and step.

Ejemplo:

100

side
enum<string>
requerido

Dirección de la orden.

Opciones disponibles:
buy,
sell
Ejemplo:

"buy"

sl
number | null

Optional absolute Stop Loss price. Omit or send null to skip; 0 specifies no SL.

Rango requerido: x >= 0
tp
number | null

Optional absolute Take Profit price. Omit or send null to skip; 0 specifies no TP.

Rango requerido: x >= 0
price
number | null
obsoleto

Precio explícito anterior; envíalo junto con digits u omite ambos para precio automático.

Rango requerido: x > 0
digits
integer | null
obsoleto

Decimales explícitos anteriores; omite este campo y price para usar la configuración del símbolo.

Rango requerido: 0 <= x <= 10
comment
string
predeterminado:REST API

Comentario de la orden guardado en MT5.

Maximum string length: 31

Respuesta

Respuesta satisfactoria

The response is of type Respuesta: Enviar orden de mercado · object.