Get account trade history
GET /api/v2/MT4/{tradePlatform}/TradesUserHistory/{login}
Closed trades history for a single account in a time range.
Manager (live) call — round-trips to MT4 server. Default time range
is "everything" (epoch → MaxValue) when query params are omitted.
Returns an empty list if the account has no closed trades in the
window. Trades are mapped to the curated MT4Trade DTO; same
shape as live TradesGetByMarket / TradesGetBySymbol.
Timeout: 30 s by default, adjustable per request with the X-Request-Timeout header. When the trade server does not answer in time: Nothing was changed; the request is safe to repeat.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| tradePlatform | path | string (uuid) | yes | Trade platform id (GUID) |
| login | path | integer (int32) | yes | Account login (positive integer) |
| fromTime | query | string (date-time) | no | Window start (UTC, ISO 8601). Optional. |
| toTime | query | string (date-time) | no | Window end (UTC, ISO 8601). Optional. |
| X-Request-Timeout | header | number (double) | no | How long to wait for the trade server, in seconds (1–300). Default for this operation: 30 s (history or report). The query parameter requestTimeout does the same for clients that cannot set headers. The applied value is returned in the X-Request-Timeout-Applied response header. |
Responses
- 200 Success — MT4TradeListApiResponse
Example
curl "https://cloud.mywebapi.com/api/v2/MT4/$TRADE_PLATFORM_ID/TradesUserHistory/$LOGIN" \
-H "Authorization: Bearer $TOKEN"