Skip to content

Get Market Watch

GetMarketWatch

GetMarketWatch

Description: Returns market watch entries for the effective login.

Available for:

  • SESSION_USER
  • SESSION_MANAGER
  • SESSION_ADMIN
  • SESSION_DEALER

Note

Request should include Authorization token.

For access resolution:

  • SESSION_USER: server uses the authenticated session login
  • SESSION_MANAGER, SESSION_ADMIN, SESSION_DEALER: request should provide target login

Request Parameters

Name Type Required Description
prefix string Yes Request context/prefix
login int No Target account login for staff sessions

Request Example

{
  "prefix": "terminal",
  "login": 100001
}

Response Parameters

Name Type Description
assets object Symbol-keyed object with watch list entries

Each assets.<symbol> object may contain:

  • symbol
  • sort_index
  • color
  • market_state
  • market_reason
  • price1d
  • high
  • low
  • prices

Response Example

{
  "assets": {
    "EURUSD": {
      "symbol": "EURUSD",
      "sort_index": 1,
      "color": "#22AA66",
      "market_state": 1,
      "market_reason": 0,
      "price1d": -0.12,
      "high": 1.10523,
      "low": 1.10211,
      "prices": [1.10312, 1.10344, 1.10301]
    }
  }
}

Error Responses

Code Error Description
400 INVALID_DATA Invalid request fields
401 PERMISSION_DENIED Missing or invalid access context