Consultar resultado

GET

api

trading

requests

{request_id}

Consultar resultado de solicitud

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

import requests

url = "https://api-trading.ap-markets.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.ap-markets.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": {},
  "summary": {
    "request_id": 123,
    "operation": "market_order",
    "status": "succeeded",
    "success": true,
    "mt5_code": 123,
    "message": "<string>",
    "execution": {
      "symbol": "<string>",
      "side": "buy",
      "order_type": "<string>",
      "requested_volume": "<string>",
      "executed_volume": "<string>",
      "requested_price": "<string>",
      "executed_price": "<string>",
      "sl": "<string>",
      "tp": "<string>"
    },
    "deal_id": "<string>",
    "order_id": "<string>",
    "position_id": "<string>",
    "position_resolution": "pending"
  }
}

{
  "status": "pending",
  "request_id": 123,
  "summary": {
    "request_id": 123,
    "operation": "market_order",
    "status": "succeeded",
    "success": true,
    "mt5_code": 123,
    "message": "<string>",
    "execution": {
      "symbol": "<string>",
      "side": "buy",
      "order_type": "<string>",
      "requested_volume": "<string>",
      "executed_volume": "<string>",
      "requested_price": "<string>",
      "executed_price": "<string>",
      "sl": "<string>",
      "tp": "<string>"
    },
    "deal_id": "<string>",
    "order_id": "<string>",
    "position_id": "<string>",
    "position_resolution": "pending"
  },
  "result": {
    "retcode": "<string>",
    "answer": {}
  }
}

{
  "code": "TRADE_RESULT_UNAVAILABLE",
  "request_id": 123,
  "detail": "<string>",
  "summary": {
    "request_id": 123,
    "operation": "market_order",
    "status": "succeeded",
    "success": true,
    "mt5_code": 123,
    "message": "<string>",
    "execution": {
      "symbol": "<string>",
      "side": "buy",
      "order_type": "<string>",
      "requested_volume": "<string>",
      "executed_volume": "<string>",
      "requested_price": "<string>",
      "executed_price": "<string>",
      "sl": "<string>",
      "tp": "<string>"
    },
    "deal_id": "<string>",
    "order_id": "<string>",
    "position_id": "<string>",
    "position_resolution": "pending"
  },
  "result": {
    "retcode": "<string>",
    "answer": {}
  }
}

{
  "detail": "Invalid request"
}

GET /api/v1/trading/requests/{request_id} consulta una solicitud enviada con el mismo token y una verificación de cuenta vigente. Usa el ID devuelto en answer.id o answer.ID; no es un ticket de orden o posición.

Confirmación

El envío devuelve un ID sin esperar la ejecución. Este GET lee el resultado guardado y puede repetirse; no hace una consulta de la posición actual.

Respuesta	Qué hacer
200	Leer `summary`: el resultado final puede ser éxito, rechazo o ejecución parcial.
202	Aún pendiente. Respetar `Retry-After` y repetir solo el GET, con un plazo máximo local.
409 / `TRADE_RESULT_UNAVAILABLE`	No hay resultado final conservado; puede haber datos parciales. Consultar órdenes y posiciones antes de decidir otra acción.
409 / `TRADE_RESULT_AMBIGUOUS`	El ID es ambiguo entre sesiones. Solicitar conciliación al proveedor.
403	Revisar token, permisos y vigencia de la verificación.

Un timeout o resultado no disponible no significa que la operación haya fallado. No reenvíes el POST con otra clave. Al agotar el plazo de seguimiento, marca la solicitud como incierta y consulta el estado de la cuenta.

Interpretar `summary`

HTTP 200 y el retcode exterior describen la consulta, no el éxito del trading.

`status`	`success`	Significado
`succeeded`	true	Acción completada; un cierre parcial solicitado no cierra toda la posición.
`placed`	true	Orden pendiente colocada, todavía sin confirmar ejecución en mercado.
`rejected`	false	Rechazada; revisar `mt5_code` y `message`.
`partially_executed`	null	Ejecutada parcialmente; comprobar el volumen restante.
`pending`	null	Esperando confirmación.
`no_change`	null	El broker no realizó cambios.
`unknown`	null	Resultado incierto.

message está en inglés. Códigos habituales: 10009 completada, 10008 pendiente colocada, 10010 ejecución parcial, 10019 margen insuficiente y 10025 sin cambios. success: null no equivale a éxito ni a rechazo. operation identifica market_order, place_pending, close_position, cancel_order, modify_order o modify_position. Solicitudes antiguas pueden usar modify_stops; una operación no reconocida usa unknown.

Encontrar la posición

Guarda summary.position_id cuando position_resolution sea resolved. Comprueba que coincide con Position en las posiciones actuales antes de cerrarla o modificarla. No lo deduzcas de order_id o deal_id.

`position_resolution`	Significado
`pending`	Asociación todavía en proceso; repetir el GET más tarde.
`resolved`	Ticket asociado confirmado.
`not_applicable`	Esta solicitud no requiere asociar una ejecución a una posición.
`unavailable`	No pudo resolverse con los datos o intentos disponibles.
`mismatch`	Datos incompatibles; no se publica el ticket.

La asociación se obtiene en segundo plano y es histórica: no garantiza que la posición siga abierta. En netting, varias operaciones pueden compartir posición. No lista todos los fills de una ejecución parcial ni sigue la activación futura de una pendiente. Un fallo de asociación no justifica repetir la operación.

Datos de solicitud y ejecución

summary.execution contiene lo informado por MT5 en el resultado guardado:

Campo	Valor
`symbol`, `side`, `order_type`	Símbolo, buy/sell y código del tipo de orden.
`requested_volume`, `executed_volume`	Volumen solicitado y ejecutado, en unidades MT5: 10000 = 1 lote.
`requested_price`, `executed_price`	Precio solicitado y precio de ejecución informado.
`sl`, `tp`	Protección informada en esa solicitud; no son los niveles actuales.

Precios y volúmenes pueden ser cadenas. null significa dato no disponible; no se sustituye por cero. Un cero informado por MT5 se conserva. Los SL/TP no guardados en resultados antiguos permanecen null. retcode y answer se mantienen por compatibilidad, con campos públicos limitados. Para conocer el estado vigente, consulta las órdenes o posiciones de la cuenta. Idempotencia · Volumen

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

summary

TradeOutcome · object

requerido

Show child attributes

Consultar resultado de solicitud

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

import requests

url = "https://api-trading.ap-markets.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.ap-markets.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": {},
  "summary": {
    "request_id": 123,
    "operation": "market_order",
    "status": "succeeded",
    "success": true,
    "mt5_code": 123,
    "message": "<string>",
    "execution": {
      "symbol": "<string>",
      "side": "buy",
      "order_type": "<string>",
      "requested_volume": "<string>",
      "executed_volume": "<string>",
      "requested_price": "<string>",
      "executed_price": "<string>",
      "sl": "<string>",
      "tp": "<string>"
    },
    "deal_id": "<string>",
    "order_id": "<string>",
    "position_id": "<string>",
    "position_resolution": "pending"
  }
}

{
  "status": "pending",
  "request_id": 123,
  "summary": {
    "request_id": 123,
    "operation": "market_order",
    "status": "succeeded",
    "success": true,
    "mt5_code": 123,
    "message": "<string>",
    "execution": {
      "symbol": "<string>",
      "side": "buy",
      "order_type": "<string>",
      "requested_volume": "<string>",
      "executed_volume": "<string>",
      "requested_price": "<string>",
      "executed_price": "<string>",
      "sl": "<string>",
      "tp": "<string>"
    },
    "deal_id": "<string>",
    "order_id": "<string>",
    "position_id": "<string>",
    "position_resolution": "pending"
  },
  "result": {
    "retcode": "<string>",
    "answer": {}
  }
}

{
  "code": "TRADE_RESULT_UNAVAILABLE",
  "request_id": 123,
  "detail": "<string>",
  "summary": {
    "request_id": 123,
    "operation": "market_order",
    "status": "succeeded",
    "success": true,
    "mt5_code": 123,
    "message": "<string>",
    "execution": {
      "symbol": "<string>",
      "side": "buy",
      "order_type": "<string>",
      "requested_volume": "<string>",
      "executed_volume": "<string>",
      "requested_price": "<string>",
      "executed_price": "<string>",
      "sl": "<string>",
      "tp": "<string>"
    },
    "deal_id": "<string>",
    "order_id": "<string>",
    "position_id": "<string>",
    "position_resolution": "pending"
  },
  "result": {
    "retcode": "<string>",
    "answer": {}
  }
}

{
  "detail": "Invalid request"
}

Disponibilidad

Cuentas

Mercado y estado de cuenta

Trading

Confirmación

Interpretar `summary`

Encontrar la posición

Datos de solicitud y ejecución

Autorizaciones

Parámetros de ruta

Respuesta

​Confirmación

​Interpretar summary

​Encontrar la posición

​Datos de solicitud y ejecución

Autorizaciones

Parámetros de ruta

Respuesta

Confirmación

Interpretar `summary`

Encontrar la posición

Datos de solicitud y ejecución