Add Market Watch¶

Adds a symbol to the user's market watch list and returns snapshot analytics for that symbol.

POST

https://{some_domain}/market/watch

Authorization¶

This endpoint requires an authenticated session with one of the following access types:

SESSION_USER
SESSION_MANAGER
SESSION_ADMIN
SESSION_DEALER

Request¶

Content-Type: application/json

Body Parameters¶

Field	Type	Required	Description
`login`	int	Yes	User account login ID
`symbol`	string	Yes	Trading symbol to add (for example, `EURUSD`)

Request Example¶

{
  "login": 100001,
  "symbol": "EURUSD"
}

Response¶

Success (200)¶

The response returns one top-level key named by symbol.

{
  "EURUSD": {
    "symbol": "EURUSD",
    "price1d": -0.12,
    "high": 1.10523,
    "low": 1.10211,
    "prices": [1.10312, 1.10344, 1.10301, 1.10420]
  }
}

Response Field Notes¶

price1d: 1-day price metric from quote manager.
prices: close values from the last 24h candles.
high, low:
based on the latest candle when candles exist,
0 and 0 when candle data is empty.

Error Responses¶

HTTP	`error`	Description
400	`INVALID_DATA`	Request validation failed (`login` or `symbol` missing/invalid)
500	`INVALID_ADD_SYMBOL_TO_MARKET_WATCH`	Failed to add symbol to market watch (`message` contains internal details)

Error Example¶

{
  "error": "INVALID_ADD_SYMBOL_TO_MARKET_WATCH",
  "message": "<formatted internal error>"
}

Notes¶

Endpoint is internally handled by command AddMarketWatch.
Route pattern supports optional trailing slash: POST /market/watch/?.