Skip to main content
All these routes require a token, read permission, and an active verification for the login. They do not replace querying a request’s execution result.

​
Account data

GET /api/v1/accounts/{login} returns only retcode and answer. Within answer, only Login, Registration, LastAccess, Name, FirstName, Balance, and Credit are allowed. All other MT5 fields are excluded. Example successful response:
Values and types received from MT5 are preserved. Missing allowed fields are omitted; values are not invented. Registration and LastAccess are Unix timestamps in seconds. This field list applies only to the account query; errors retain the format described in Errors.

​
Open positions

GET /api/v1/accounts/{login}/positions returns a page of positions. A successful response contains only retcode and an answer array. Each position allows only these fields: Position, Symbol, Action, TimeCreate, PriceOpen, PriceCurrent, PriceSL, PriceTP, Volume, Profit, Storage. Additional MT5 fields are excluded. Received values and types are preserved; missing fields are omitted. With no positions, answer is []. TimeCreate and TimeUpdate are Unix timestamps in seconds; their Msc variants use milliseconds. Errors retain their usual format. Keep the Position ticket, owner Login, Symbol, Action, and Volume to prepare a closing order. The ticket is not the ID returned when submitting an order. GET /api/v1/accounts/{login}/positions/count queries the number of open positions. Its result reflects the time of the query and may change before you read a page.

​
Active orders

A successful response contains only retcode and an answer array. Each order allows only these fields: Order, Symbol, State, Type, TimeSetup, TimeExpiration, TypeTime, PriceOrder, PriceTrigger, PriceCurrent, PriceSL, PriceTP, VolumeInitial, VolumeCurrent. Additional MT5 fields are excluded. Received values and types are preserved; missing fields are omitted. With no orders, answer is []. Time fields use Unix seconds and Msc variants use milliseconds; received 0 values are preserved. Errors retain their usual format. GET /api/v1/accounts/{login}/orders queries active MT5 orders. It accepts offset from 0 and total between 1 and 100, defaulting to 100. It is not execution history. An executed market order does not necessarily remain in this list. Use POST /api/v1/orders/{order}/modify to modify a pending order and POST /api/v1/orders/{order}/cancel to cancel it.

​
Traverse all pages

  1. Start with offset=0 and a total within the route’s limit.
  2. Process the answer array in the MT5 response.
  3. If it contains fewer items than total, stop.
  4. If the page is full, increase offset by total and query the next page.
  5. Apply a defensive page limit and respect the permitted request frequency.
Pages are not a transactional snapshot. If trades occur concurrently, reconcile changes by ticket and query again when necessary.
For dated executions, swap and commissions, use deal history: GET /api/v1/accounts/{login}/deals?from=...&to=...&offset=0&total=100.