Get Trades By Symbol
MngGetTradesBySymbol¶
Description:
Returns trades filtered by exact symbol name and trade type.
The response uses structure + rows format where each row is aligned to the structure fields.
Access Control¶
🛡️ Access Level Required:
SESSION_MANAGER,SESSION_ADMIN,SESSION_DEALER
Endpoint¶
GET /trades/symbol/
Request Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Exact trade symbol (for example, EURUSD) |
| type | int | Yes | Trade type filter, integer in range 0..5 |
Request Example¶
{
"symbol": "EURUSD",
"type": 1
}
Response¶
The response contains:
structure: array of column namesrows: array of trade rows (arrays aligned withstructure)
Structure Fields¶
| Field | Description |
|---|---|
| order | Trade order ID |
| login | Account login |
| cmd | Trade command |
| state | Trade state |
| symbol | Symbol name |
| reason | Reason code |
| volume | Volume in minimal lots |
| open_time | Open timestamp |
| close_time | Close timestamp |
| open_price | Open price |
| close_price | Close price |
| sl | Stop Loss |
| tp | Take Profit |
| profit | Profit/Loss |
| commission | Commission |
| storage | Swap/Storage |
| comment | Trade comment |
| digits | Price precision digits |
| expiration | Expiration timestamp |
Example Response¶
{
"structure": [
"order","login","cmd","state","symbol","reason","volume","open_time","close_time",
"open_price","close_price","sl","tp","profit","commission","storage","comment",
"digits","expiration"
],
"rows": [
[1001234,123456,0,1,"EURUSD",2,1000,1712000000,0,1.1010,0,1.0900,1.1200,0.0,-2.5,-1.2,"manual trade",5,0]
]
}
Error Responses¶
Validation Error¶
{
"error": "INVALID_DATA",
"message": "type is required"
}