Listar posiciones

GET

api

accounts

{login}

positions

Listar posiciones abiertas

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

import requests

url = "https://api-trading.vexprofx.com/api/v1/accounts/{login}/positions"

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/accounts/{login}/positions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "retcode": "<string>",
  "answer": [
    {
      "Position": "<string>",
      "Symbol": "<string>",
      "Action": "<string>",
      "TimeCreate": "<string>",
      "PriceOpen": "<string>",
      "PriceCurrent": "<string>",
      "PriceSL": "<string>",
      "PriceTP": "<string>",
      "Volume": "<string>",
      "Profit": "<string>",
      "Storage": "<string>"
    }
  ]
}

{
  "detail": "Invalid request"
}

Qué hace esta operación

Usa offset desde 0 y total entre 1 y 1000 (100 por defecto). Recorre todas las páginas y conserva el ticket Position para cierres.

Campos de respuesta

La respuesta exitosa contiene únicamente retcode y un arreglo answer. Cada posición permite solo estos campos: Position, Symbol, Action, TimeCreate, PriceOpen, PriceCurrent, PriceSL, PriceTP, Volume, Profit, Storage. Los campos adicionales de MT5 se excluyen. Se conservan los valores y tipos recibidos; los campos ausentes se omiten. Sin posiciones, answer es []. TimeCreate y TimeUpdate son fechas Unix en segundos; sus variantes Msc usan milisegundos. Los errores mantienen su formato habitual.

{
  "retcode": "0 Done",
  "answer": [
    {
      "Position": "82313217",
      "Symbol": "XAUUSD",
      "Action": "1",
      "TimeCreate": "1790252238",
      "PriceOpen": "4269.64",
      "PriceCurrent": "4151.76",
      "PriceSL": "0.00",
      "PriceTP": "0.00",
      "Volume": "10000",
      "Profit": "11788.00",
      "Storage": "-260.88"
    }
  ]
}

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.

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

Parámetros de consulta

offset

integer

predeterminado:0

Rango requerido: x >= 0

total

integer

predeterminado:100

Rango requerido: 1 <= x <= 1000

Respuesta

Respuesta satisfactoria

retcode

string

requerido

answer

PositionData · object[]

requerido

Show child attributes

Listar posiciones abiertas

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

import requests

url = "https://api-trading.vexprofx.com/api/v1/accounts/{login}/positions"

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/accounts/{login}/positions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "retcode": "<string>",
  "answer": [
    {
      "Position": "<string>",
      "Symbol": "<string>",
      "Action": "<string>",
      "TimeCreate": "<string>",
      "PriceOpen": "<string>",
      "PriceCurrent": "<string>",
      "PriceSL": "<string>",
      "PriceTP": "<string>",
      "Volume": "<string>",
      "Profit": "<string>",
      "Storage": "<string>"
    }
  ]
}

{
  "detail": "Invalid request"
}

Disponibilidad

Cuentas

Mercado y estado de cuenta

Trading

Qué hace esta operación

Campos de respuesta

Proceso completo

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

​Qué hace esta operación

​Campos de respuesta

​Proceso completo

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

Qué hace esta operación

Campos de respuesta

Proceso completo