查詢市場漲跌幅

query_symbol_snapshot

tip

此功能僅供漲跌停價等商品資訊查詢，無即時行情更新

輸入參數

參數	類別	說明
account	Account	帳號
market_type	MarketType (Optional)(default = Common)	市場別 ： 支援 Common 整股，IntradayOdd 盤中零股、Fixing 定盤
stock_type	List StockType (Optional)(default = Stock)	股票分類別 ： Stock 股票、ConvertBond 可轉債、ETF_and_ETN ETF 與 ETN

Result 回傳

參數	類別	說明
isSuccess	bool	是否成功
data	SymbolSnapshotResponse	回傳查詢資訊
message	string	當isSuccess : false 回傳錯誤訊息

商品資訊 SymbolQuote 欄位

Return type : Object

參數	類型	說明
market	string	市場別
symbol	string	股票代碼
is_tib_or_psb	bool	是否為創新版或戰略新板
market_type	string	市場類型
status	int	狀態 (bitmask 加總)
reference_price	double	參考價格
unit	int	交易單位
update_time	string	更新時間
limitup_price	double	漲停價
limitdown_price	double	跌停價
open_price	double	開盤價
high_price	double	最高價
low_price	double	最低價
last_price	double	最新成交價
total_volume	int	總成交量
total_transaction	int	總成交筆數
total_value	double	總成交金額
last_size	int	最新成交量
last_transaction	int	最新成交筆數
last_value	double	最新成交金額
bid_price	double	買1價格
bid_volume	int	買1數量
ask_price	double	賣1價格
ask_volume	int	賣1數量

請求範例

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

if (!query_snapshot.is_success) {
    std::cout << "get snapshot failed reason: "
        << (query_snapshot.message.has_value() ? query_snapshot.message.value() : "No message")
        << std::endl;
}
if (query_snapshot.data.has_value()) {
    // std::cout << "Data list size: " << query_snapshot.data.value().size() << std::endl << std::endl;

    const auto& quotes = query_snapshot.data.value();  // vector<SymbolQuote>
    for (const auto& quote : quotes) {
        std::cout << quote << std::endl;
    }
}
else {
    std::cout << "get snapshot success but no data returned." << std::endl;
}

回傳範例

{
    isSuccess = True,
    message = ,
    data =  SymbolQuote{ 
        market = TAIEX,                    // string - 市場別 
        symbol = 2330,                     // string - 股票代碼 
        istibOrPsb = False,               // bool - 是否為創新板或戰略新板
        marketType = Common,              // string - 市場類型 (現股)
        status = 15,                      // int - 狀態 (bitmask 加總: 1+2+4+8 = 可融券賣出+可借券賣出+可先買後賣當沖+可先賣後買當沖)
        referencePrice = 780,             // double - 參考價格 (前一交易日收盤價)
        unit = 1000,                      // int - 交易單位 
        updateTime = ,                    // string - 更新時間 
        limitupPrice = 858,               // double - 漲停價
        limitdownPrice = 702,             // double - 跌停價
        openPrice = 1155,                 // double - 開盤價
        highPrice = 1160,                 // double - 最高價
        lowPrice = 1145,                  // double - 最低價
        lastPrice = 1145,                 // double - 最新成交價
        totalVolume = 20501,              // int - 總成交量 
        totalTransaction = 0,             // int - 總成交筆數
        totalValue = 23551095000,         // int - 總成交金額 
        lastSize = 6673,                  // int - 最新成交量 
        lastTransaction = 0,              // int - 最新成交筆數
        lastValue = 7640585000,           // int - 最新成交金額 
        bidPrice = 1145,                  // double - 買一價格 
        bidVolume = 1549,                 // int - 買一數量 
        askPrice = 1150,                  // double - 賣一價格 
        askVolume = 4169                  // int - 賣一數量 
    },
    {
        market = TAIEX,                    // string - 市場別 
        symbol = 2330,                     // string - 股票代碼 
        ...
    }
}