Skip to main content

圈券申請

ReserveStock

版本資訊

v2.2.9 起新增功能

使用限制
  • 申請服務時段為交易日 08:00 ～ 14:30，時段外送出會被後端拒絕。
  • 送出後無法透過 API 取消。
  • 完整作業特性見圈存與匯撥。

輸入參數​

參數類別說明
accountAccount帳號
stock_nostring股票代號
quantityint圈存股數，單位為股（1 張＝1,000 股），須大於 0

Result 回傳​

參數類別說明
is_successbool是否成功
dataReserveStockRecord回傳圈券申請資訊
messagestring當is_success = false 回傳錯誤訊息

圈券申請紀錄 ReserveStockRecord 欄位​

Return type : Object

參數類別說明
seq_nostring委託單流水序號
stock_nostring股票代號
reserved_shareint本次圈存股數（股）

請求範例​

auto reserve_stock_response = sdk->stock->reserve_stock(target_account, "2330", 599);

// 搭配自定義 .cpp & hpp  Output
if (!reserve_stock_response.is_success) {
    std::cout << "reserve stock failed reason: "
        << (reserve_stock_response.message.has_value() ? reserve_stock_response.message.value() : "No message")
        << std::endl;
}
else {
    if (reserve_stock_response.data.has_value()) {
        std::cout << reserve_stock_response.data.value() << std::endl;
    }
    else {
        std::cout << "Reserve stock success but no data returned." << std::endl;
    }
}

回傳範例​

// 搭配自定義 .cpp & hpp  Output
[ReserveStockRecord]
  seq_no: 417106                   // 委託單流水序號 (string)
  stock_no: 2330                   // 股票代號 (string)
  reserved_share: 599              // 本次圈存股數 (int)