Datos de cuenta
GET /api/v1/accounts/{login} devuelve únicamente retcode y answer.
Dentro de answer solo se permiten Login, Registration, LastAccess, Name,
FirstName, Balance y Credit. Los demás campos de MT5 se excluyen.
Ejemplo de respuesta exitosa:
Registration y LastAccess representan fechas
Unix en segundos. Esta lista de campos aplica solo a la consulta de cuenta;
los errores conservan el formato descrito en Errores.
Posiciones abiertas
GET /api/v1/accounts/{login}/positions devuelve la página de posiciones.
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.
Conserva el ticket
Position, el propietario Login, Symbol, Action y Volume
para preparar un cierre. El ticket no es el ID devuelto al enviar una orden.
GET /api/v1/accounts/{login}/positions/count consulta el número de posiciones abiertas.
Su resultado corresponde al momento de la consulta y puede cambiar antes de leer una página.
Órdenes activas
La respuesta exitosa contiene únicamenteretcode y un arreglo answer.
Cada orden permite solo estos campos: Order, Symbol, State, Type, TimeSetup, TimeExpiration, TypeTime, PriceOrder, PriceTrigger, PriceCurrent, PriceSL, PriceTP, VolumeInitial, VolumeCurrent.
Los campos adicionales de MT5 se excluyen. Se conservan los valores y tipos
recibidos; los campos ausentes se omiten. Sin órdenes, answer es [].
Los campos de tiempo usan segundos Unix y las variantes Msc, milisegundos;
los valores 0 recibidos se conservan. Los errores mantienen su formato habitual.
GET /api/v1/accounts/{login}/orders consulta las órdenes activas de MT5.
Admite offset desde 0 y total entre 1 y 100, con 100 por defecto.
No es un histórico de ejecuciones. Una orden de mercado ya ejecutada no tiene por qué
permanecer en esta lista. Usa POST /api/v1/orders/{order}/modify para modificar una pendiente y POST /api/v1/orders/{order}/cancel para cancelarla.
Recorrer todas las páginas
- Empieza con
offset=0y untotaldentro del límite de la ruta. - Procesa el arreglo de
answerde la respuesta MT5. - Si contiene menos elementos que
total, termina. - Si la página está completa, incrementa
offsetentotaly consulta otra página. - Aplica un límite defensivo de páginas y respeta la frecuencia permitida.
GET /api/v1/accounts/{login}/deals?from=...&to=...&offset=0&total=100.
