MngSetCustomQuote

MngSetCustomQuote

Description:
Sets a custom live quote for a symbol through the standard server quote pipeline.

The method builds a TickInfo record and passes it to Core::OnQoute, so the quote follows the same flow as feeder ticks: symbol tick update, alert processing, tick/candle storage, and quote publishing.

---

Access Control

Access Level Required: SESSION_ADMIN, SESSION_MANAGER, SESSION_DEALER

---

Parameters

Name	Type	Required	Description
symbol	string	Yes	Internal symbol name used to resolve symbol settings and default source mapping
bid	double	Yes	Bid price. Must be greater than 0
ask	double	Yes	Ask price. Must be greater than 0 and greater than or equal to bid
volume	double	No	Tick volume. Defaults to 0

The client does not pass ctm, source, or source_index. The server uses current server time for ctm, resolves quote source from the symbol settings, and uses the symbol feeder binding as source_index.

---

Example Request

{
  "symbol": "EURUSD",
  "bid": 1.0821,
  "ask": 1.0823,
  "volume": 0
}

---

Behavior

• The server validates the internal symbol through SymbolManager.
• The quote source must map to at least one server symbol.
• The symbol configuration decides which source is used.
• The symbol feeder binding is used as source_index.
• The server assigns ctm from current server time.
• The quote is rejected if market state or feeder binding validation rejects the tick.
• The method updates live quote state and can trigger downstream quote notifications.

---

Response

Field	Type	Description
accepted	bool	Always true on successful quote acceptance
symbol	string	Internal symbol requested by the client
source	string	Quote source used for OnQoute mapping
source_index	int	Source index passed to OnQoute
bid	double	Accepted bid value
ask	double	Accepted ask value
volume	double	Accepted volume value
ctm	int64	Accepted tick timestamp
mapped	int	Number of symbols mapped from the quote source

Example Successful Response

{
  "accepted": true,
  "symbol": "EURUSD",
  "source": "EURUSD",
  "source_index": 1,
  "bid": 1.0821,
  "ask": 1.0823,
  "volume": 0,
  "ctm": 1710000000,
  "mapped": 1
}

---

Errors

Code	Description
400	Invalid request payload, invalid bid/ask values, or quote rejected by runtime validation
404	Symbol not found or quote source is not mapped to any symbol

---

Notes

• This method does not edit historical candles directly; candle updates happen only through the regular quote storage flow.
• Source mapping and feeder binding are controlled by symbol settings, not by the request payload.