Skip to content

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_USER
  • SESSION_MANAGER
  • SESSION_ADMIN
  • SESSION_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,
  • 0 and 0 when 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 = {}).