Get Market Watch¶
Returns user market watch entries as a symbol-keyed object with short analytics fields.
GET
https://{some_domain}/market/watch/list
Authorization¶
This endpoint requires an authenticated session with one of the following access types:
SESSION_USERSESSION_MANAGERSESSION_ADMINSESSION_DEALER
Request¶
Query Parameters¶
| Field | Type | Required | Description |
|---|---|---|---|
login |
int | Yes | User account login ID |
prefix |
string | Yes | Request prefix/context identifier |
Request Example¶
GET https://{some_domain}/market/watch/list?login=100001&prefix=web
Authorization: <JWT_TOKEN>
Response¶
Success (200)¶
{
"assets": {
"EURUSD": {
"symbol": "EURUSD",
"sort_index": 1,
"color": "#22AA66",
"price1d": -0.12,
"high": 1.10523,
"low": 1.10211,
"prices": [1.10312, 1.10344, 1.10301, 1.10420]
},
"BTCUSD": {
"symbol": "BTCUSD",
"sort_index": 2,
"color": "#FFAA00",
"price1d": 2.31,
"high": 0,
"low": 0,
"prices": []
}
}
}
Response Field Notes¶
assets: object where each key is the symbol name.sort_index: display order in watch list.color: user/market-watch color tag.price1d: 1-day price metric from quote manager.prices: last 24h candles close values.high,low:- last candle high/low when candles exist,
0and0when no candles are available.
Error Responses¶
| HTTP | error |
Description |
|---|---|---|
| 400 | INVALID_DATA |
Request validation failed (login or prefix is missing/invalid) |
Error Example¶
{
"error": "INVALID_DATA",
"message": "prefix is required"
}
Notes¶
- Endpoint is internally handled by command
GetMarketWatch. - Route pattern supports optional trailing slash:
GET /market/watch/list/?. - Endpoint does not require extra permission flags (
permissions = {}).