Skip to main content

Query Market Snapshot

query_symbol_snapshot

tip

This function only queries product information such as daily price limits; it does not provide real-time quote updates.

Input Parameters​

ParameterTypeDescription
accountAccountAccount
market_typeMarketType (Optional)(default = Common)Market type: supports Common, IntradayOdd, Fixing
stock_typesList StockType (Optional)(default = STOCK)Stock category: STOCK, COVERT_BOND, ETF_AND_ETN

Result Response​

ParameterTypeDescription
is_successboolWhether successful
datastd::vector<SymbolQuote>Returned snapshot information
messagestringError message when is_success = False

SymbolQuote Fields​

Return type: Object

ParameterTypeDescription
marketstringMarket
symbolstringStock code
istib_or_psbboolWhether TIB or PSB
market_typestringMarket type
statusintStatus (bitmask)
reference_pricedoubleReference price
unitintTrading unit
update_timestringUpdate time
limitup_pricedoubleUpper limit price
limitdown_pricedoubleLower limit price
open_pricedoubleOpening price
high_pricedoubleHighest price
low_pricedoubleLowest price
last_pricedoubleLast traded price
total_volumeintTotal volume
total_transactionintTotal transactions
total_valuedoubleTotal value
last_sizeintLast trade size
last_transactionintLast transaction count
last_valuedoubleLast trade value
bid_pricedoubleBid price
bid_volumeintBid volume
ask_pricedoubleAsk price
ask_volumeintAsk volume

Request Example​

auto query_snapshot = sdk->stock->query_symbol_snapshot(account, MarketType::COMMON, std::vector<StockType>{ StockType::COVERT_BOND });

Response Example​

{
is_success = True,
message = ,
data = SymbolQuote{
market = TAIEX,
symbol = 2330,
istib_or_psb = False,
market_type = Common,
status = 15,
reference_price = 780,
unit = 1000,
update_time = ,
limitup_price = 858,
limitdown_price = 702,
open_price = 1155,
high_price = 1160,
low_price = 1145,
last_price = 1145,
total_volume = 20501,
total_transaction = 0,
total_value = 23551095000,
last_size = 6673,
last_transaction = 0,
last_value = 7640585000,
bid_price = 1145,
bid_volume = 1549,
ask_price = 1150,
ask_volume = 4169
}
}