Get Market Symbol

GetMarketSymbol¶

GetMarketSymbol

Description: Returns detailed market information for one symbol in the context of a target account login.

Available for:

SESSION_USER
SESSION_MANAGER
SESSION_ADMIN
SESSION_DEALER

Note

Request should include Authorization token.

Request Parameters¶

Name	Type	Required	Description
login	int	Yes	Target account login
symbol	string	Yes	Symbol name

Request Example¶

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

Response Parameters¶

The response is a flat object with detailed symbol data, including:

description and currency fields
spread, swap and margin settings
ask, bid, tick fields
market_state, market_reason
lot and commission settings
performance
seasons
additional metadata such as exchange, category, industry, sector
sessions

Response Example (truncated)¶

{
  "symbol": "AAPL",
  "description": "Apple Inc.",
  "group": "Stocks",
  "digits": 2,
  "ask": 212.54,
  "bid": 212.48,
  "market_state": 1,
  "market_reason": 0,
  "performance": {
    "1W": 1.2,
    "1M": 4.8,
    "3M": 9.5,
    "6M": 13.1,
    "YTD": 7.4,
    "1Y": 21.7
  },
  "exchange": "NASDAQ",
  "sector": "Technology"
}

Error Responses¶

Code	Error	Description
400	`INVALID_DATA`	Missing or invalid `login` or `symbol`
403	`USER_NOT_FOUND_OR_INCORRECT`	Account was not found
403	`SYMBOL_NOT_ALLOWED`	Symbol is not allowed for the account group
404	`GROUP_NOT_FOUND`	Account group was not found