Consultar resultado

GET

api

trading

requests

{request_id}

Consultar resultado de solicitud

curl --request GET \
  --url https://api-trading.vexprofx.com/api/v1/trading/requests/{request_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api-trading.vexprofx.com/api/v1/trading/requests/{request_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-trading.vexprofx.com/api/v1/trading/requests/{request_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "retcode": "<string>",
  "answer": {}
}

{
  "status": "pending",
  "request_id": 123,
  "result": {
    "retcode": "<string>",
    "answer": {}
  }
}

{
  "code": "TRADE_RESULT_UNAVAILABLE",
  "request_id": 123,
  "detail": "<string>",
  "result": {
    "retcode": "<string>",
    "answer": {}
  }
}

{
  "detail": "Invalid request"
}

Recogida persistente y consultas repetidas

La API recoge eventos MT5 por lotes en segundo plano usando la conexión física que envió la solicitud. El GET del cliente lee RDS: no consume eventos de MT5. El envío devuelve su ID sin esperar la ejecución. Puede haber una breve demora hasta que el recolector guarde el resultado.

200: resultado final guardado, incluso rechazo o ejecución parcial. Revisar códigos MT5.
202: {"status":"pending","request_id":1586,"result":null}. Esperar al menos lo indicado en Retry-After (un segundo) y repetir únicamente este GET.
409 con TRADE_RESULT_UNAVAILABLE: no se conservó un resultado final. El campo result puede contener la última instantánea pública. Reconciliar posiciones y órdenes; no reenviar automáticamente la operación.
409 con TRADE_RESULT_AMBIGUOUS: MT5 reutilizó un ID entre sesiones para ese token. Reconciliar sin adivinar a qué operación corresponde.

El resultado final guardado se puede consultar después de reiniciar mientras el token y la verificación sigan vigentes. Los resultados consumidos antes de instalar esta mejora no se recuperan con la caché. Una caída entre consumir y guardar un evento todavía puede perderlo; no disponible no significa operación fallida.

Qué hace esta operación

Usa el ID de answer.id o answer.ID, no un ticket de posición. Solo el token que envió la solicitud puede consultarla, con verificación vigente de la cuenta. HTTP 200 no implica ejecución exitosa.

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.

Respuesta reducida

La respuesta usa una lista explícita de campos públicos. Mantiene retcode y answer; si MT5 devuelve eventos agrupados por ID, conserva ese formato solo para la solicitud consultada. También admite resultados planos y listas de eventos. Los campos ausentes se omiten; no se inventan estados ni valores. En result se conservan ID, Retcode, DealID, OrderID, Volume y Price; los resultados planos también admiten ResultRetcode, ResultDeal, ResultOrder, ResultVolume y ResultPrice. En el evento answer se conservan IDClient, Symbol, Type, TypeFill, Volume, PriceOrder, Position y esos cinco campos Result*. Se excluyen cuentas, login Manager, IP, comentarios, datos del gateway, volúmenes extendidos, ApiData y campos nuevos no autorizados. Volume en el evento answer es el volumen solicitado; ResultVolume es el volumen ejecutado informado. Un ID de solicitud, orden o deal no debe confundirse con el ticket de posición. Consulta posiciones para reconciliar el resultado.

{
  "retcode": "0 Done",
  "answer": {
    "1584": [
      {
        "result": {
          "ID": "1584",
          "Retcode": "10009",
          "Volume": "100",
          "Price": "1.12806000"
        }
      },
      {
        "answer": {
          "IDClient": "1584",
          "Symbol": "EURUSD",
          "Type": "0",
          "TypeFill": "1",
          "Volume": "100",
          "PriceOrder": "1.12806",
          "Position": "0",
          "ResultRetcode": "10009",
          "ResultDeal": "84335209",
          "ResultOrder": "84668447",
          "ResultVolume": "100",
          "ResultPrice": "1.12806"
        }
      }
    ]
  }
}

Autorizaciones

Authorization

string

header

requerido

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

Parámetros de ruta

request_id

integer

requerido

Respuesta

Respuesta satisfactoria

retcode

string

requerido

answer

Answer · object

requerido

Answer · object
TradeResultEvent · object[]
TradeExecutionData · object

Show child attributes

Consultar resultado de solicitud

curl --request GET \
  --url https://api-trading.vexprofx.com/api/v1/trading/requests/{request_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api-trading.vexprofx.com/api/v1/trading/requests/{request_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-trading.vexprofx.com/api/v1/trading/requests/{request_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "retcode": "<string>",
  "answer": {}
}

{
  "status": "pending",
  "request_id": 123,
  "result": {
    "retcode": "<string>",
    "answer": {}
  }
}

{
  "code": "TRADE_RESULT_UNAVAILABLE",
  "request_id": 123,
  "detail": "<string>",
  "result": {
    "retcode": "<string>",
    "answer": {}
  }
}

{
  "detail": "Invalid request"
}

Disponibilidad

Cuentas

Mercado y estado de cuenta

Trading

Recogida persistente y consultas repetidas

Qué hace esta operación

Proceso completo

Respuesta reducida

Autorizaciones

Parámetros de ruta

Respuesta

​Recogida persistente y consultas repetidas

​Qué hace esta operación

​Proceso completo

​Respuesta reducida

Autorizaciones

Parámetros de ruta

Respuesta

Recogida persistente y consultas repetidas

Qué hace esta operación

Proceso completo

Respuesta reducida