> ## Documentation Index
> Fetch the complete documentation index at: https://api-trading-docs.vexprofx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar posiciones

> Consulta las posiciones abiertas de una cuenta verificada.

## 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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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](/es/accounts) y [los errores y su tratamiento](/es/errors).

Los valores del explorador son ejemplos. Sustituye cuenta, símbolo, volumen y precio con datos válidos para tu integración.


## OpenAPI

````yaml es/openapi.json GET /api/v1/accounts/{login}/positions
openapi: 3.1.0
info:
  title: API MT5 — Portal de partners
  description: >-
    Endpoints seguros para verificar la propiedad de cuentas, consultar el
    mercado y operar en cuentas previamente verificadas.
  version: 0.1.0
servers:
  - url: https://api-trading.vexprofx.com
    description: API Trading · Partners
security: []
paths:
  /api/v1/accounts/{login}/positions:
    get:
      tags:
        - Posiciones
      summary: Listar posiciones abiertas
      operationId: positions_api_v1_accounts__login__positions_get
      parameters:
        - name: login
          in: path
          required: true
          schema:
            type: integer
            title: Login
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
            title: Desplazamiento
        - name: total
          in: query
          required: false
          schema:
            type: integer
            maximum: 1000
            minimum: 1
            default: 100
            title: Total
      responses:
        '200':
          description: Respuesta satisfactoria
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PositionsResponse'
        '422':
          description: Solicitud inválida o parámetros de cierre incompatibles.
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    type: string
              example:
                detail: Invalid request
      security:
        - HTTPBearer: []
components:
  schemas:
    PositionsResponse:
      properties:
        retcode:
          type: string
          title: Retcode
        answer:
          items:
            $ref: '#/components/schemas/PositionData'
          type: array
          title: Answer
      additionalProperties: false
      type: object
      required:
        - retcode
        - answer
      title: PositionsResponse
    PositionData:
      properties:
        Position:
          anyOf:
            - type: string
            - type: integer
            - type: 'null'
          title: Posición
        Symbol:
          anyOf:
            - type: string
            - type: 'null'
          title: Símbolo
        Action:
          anyOf:
            - type: string
            - type: integer
            - type: 'null'
          title: Action
        TimeCreate:
          anyOf:
            - type: string
            - type: integer
            - type: 'null'
          title: Timecreate
        PriceOpen:
          anyOf:
            - type: string
            - type: integer
            - type: number
            - type: 'null'
          title: Priceopen
        PriceCurrent:
          anyOf:
            - type: string
            - type: integer
            - type: number
            - type: 'null'
          title: Pricecurrent
        PriceSL:
          anyOf:
            - type: string
            - type: integer
            - type: number
            - type: 'null'
          title: Pricesl
        PriceTP:
          anyOf:
            - type: string
            - type: integer
            - type: number
            - type: 'null'
          title: Pricetp
        Volume:
          anyOf:
            - type: string
            - type: integer
            - type: 'null'
          title: Volumen
        Profit:
          anyOf:
            - type: string
            - type: integer
            - type: number
            - type: 'null'
          title: Profit
        Storage:
          anyOf:
            - type: string
            - type: integer
            - type: number
            - type: 'null'
          title: Storage
      additionalProperties: false
      type: object
      title: PositionData
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
      description: >-
        Envía el token entregado por el proveedor en el encabezado Authorization
        mediante autenticación Bearer.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.