Skip to main content
Todas estas rutas requieren token, permiso de lectura y verificación vigente del login. No sustituyen una consulta al resultado de ejecución de una solicitud.

​
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:
Se conservan los valores y tipos recibidos de MT5. Si falta un campo permitido, se omite; no se inventan valores. 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 únicamente retcode 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. El portal no expone modificación ni cancelación de órdenes.

​
Recorrer todas las páginas

  1. Empieza con offset=0 y un total dentro del límite de la ruta.
  2. Procesa el arreglo de answer de la respuesta MT5.
  3. Si contiene menos elementos que total, termina.
  4. Si la página está completa, incrementa offset en total y consulta otra página.
  5. Aplica un límite defensivo de páginas y respeta la frecuencia permitida.
Las páginas no son una instantánea transaccional. Si hay operaciones simultáneas, reconcilia cambios por ticket y vuelve a consultar cuando sea necesario.
No supongas un esquema de histórico, saldo o ejecución que no esté documentado.