Skip to main content

參數對照表

類別​

Class

Condition Object​

ParameterTypeMeaning
marketTypeTradingType監控類型 可選用參數 : REFERENCE 自動參考委託物件、SCHEDULED 時間
symbolstring股票代號
triggerTriggerContent觸發條件 可選用參數 : BID_PRICE 買進價、ASK_PRICE 賣出價、MATCHED_PRICE 成交價、TOTAL_QUANTITY 總量、TIME 時間
triggerValuestring監控條件數值 (若為時間則填入HHMMSS)
comparisonOperator比對值 可選用參數GREATER_THAN_OR_EQUAL 大於等於、LESS_THAN_OR_EQUAL小於等於 、 GREATER_THAN 大於 、 LESS_THAN 小於
info
  1. 選擇 REFERENCE時， trigger 可搭配 BID_PRICE 、ASK_PRICE 、MATCHED_PRICE 、TOTAL_QUANTITY 、 TIME，若 trigger 使用 TIME，則時間條件達成，且時間範圍內商品有交易產生才觸發
  2. 選擇SCHEDULED 時，symbol需填入空值""，trigger需帶入TIME，則會使用系統時間判斷，當時間條件達成即觸發

ConditionOrder Object​

ParameterTypeMeaning
buySellBsAction買賣別
symbolstring股票代號
pricestring委託價格
quantityint委託數量
marketTypeConditionMarketType盤別 可選用參數COMMON 整股、FIXING定盤、INTRADAY_ODD 盤中零股、ODD 盤後零股
priceTypeConditionPriceType價格別 : 可選參數 :BID_PRICE 買進價、 ASK_PRICE 賣出價、MATCHED_PRICE成交價、LIMIT 限價、LIMIT_UP 漲停、LIMIT_DOWN 跌停、MARKET 市價、REFERENCE 參考價(平盤價)
timeInForceTimeInForce委託條件 可選用參數為 ROD、FOK、IOC
orderTypeConditionOrderType委託類別 : 可選參數 :STOCK現貨、MARGIN融資、SHORT融券

ConditionDayTrade Object​

ParameterTypeMeaning
dayTradeEndTimestring收盤前沖銷時間，格式 "HHMMSS" (例 "130000")；可設定區間為 130100 ~ 132000
autoCancelbool洗價結束後是否刪除已觸發委託
pricestring委託價格 (若無指定價格，例如市價單，請填空字串 "")
priceTypeConditionPriceType價格別 : 可選參數 :BID_PRICE 買進價、 ASK_PRICE 賣出價、MATCHED_PRICE成交價、LIMIT 限價、LIMIT_UP 漲停、LIMIT_DOWN 跌停、MARKET 市價、REFERENCE 參考價(平盤價)
關於收盤前沖銷時間

可設定區間為 130100 ~ 132000

TpslOrder Object​

ParameterTypeMeaning
timeInForceTimeInforce委託條件 : 可選參數 :ROD、IOC、FOK
priceTypeConditionPriceType價格別 : 可選參數 :BID_PRICE 買進價、 ASK_PRICE 賣出價、MATCHED_PRICE成交價、LIMIT 限價、LIMIT_UP 漲停、LIMIT_DOWN 跌停、MARKET 市價、REFERENCE 參考價(平盤價)
orderTypeConditionOrderType委託類別 : 可選參數 :STOCK現貨、MARGIN融資、SHORT融券
targetPricestring停損/停利觸發價
pricestring停損/停利委託價
triggerTriggerContent停損/停利觸發條件 （詳見表末說明）
info

priceType 若為LIMIT時，price需填入價格；其餘price填入 std::nullopt

停損/停利觸發條件

2.2.0 以後版本新增（2.1.1及以前版本無此欄位），可設定停損/停利觸發價格別為 1. MATCHED_PRICE 2. 最佳買價（BID_PRICE）；3. 最佳賣價（ASK_PRICE）

若未設定則此欄位填入 null， 預設使用 成交價（MATCHED_PRICE）

TpslWrapper Object​

ParameterTypeMeaning
stopSignStopSign停止條件 : 可選用 FULL 全部成交為止、PARTIAL部分成交為止、UNTIL_END效期結束為止
tpTpslOrder Object (Optional)停利條件內容
slTpslOrder Object (Optional)停損條件內容
endDatestring (Optional : 空值同母單StartDate)條件停止日期
intradaybool (Optional)全部成交後日內當沖 ( * 配合當沖條件單使用時需設為 true)
日內當沖

使用當沖條件單時，intraday 需設定為 true

TrailOrder​

ParameterTypeMeaning
symbolstring股票代號
pricestring基準價 (Note. 只可輸入至多小數點後兩位，若超出將造成系統洗價失敗)
directionDirection方向 : 可選用 UP 上漲、DOWN 下跌
percentageint上漲 / 下跌 % 數
buysellBsAction買賣別 : 可選用 BUY 買進 、SELL 賣出
quantityint委託股數
PriceTypeConditionPriceType價格類別 : 可選用 BID_PRICE 買進價、ASK_PRICE 賣出價、MATCHED_PRICE 成交價、MARKET 市價、LIMIT_UP 漲停價、LIMIT_DOWN 跌停價、REFERENCE 參考價(平盤價)
diffint委託買賣價格檔數 (根據 priceType 加減檔數) ，正值為向上加檔數、負值為向下加檔數
timeInForceTimeInForce委託條件 可選用參數為 ROD、FOK、IOC
orderTypeConditionOrderType委託類別 可選用參數為 STOCK現股、MARGIN融資、SHORT融券

SplitDescription​

ParameterTypeMeaning
methodSliceTypeSlice Condition : 可選用 :
TYPE1 從 startTime 開始，每隔幾秒送一筆，總共totalQuantity，每筆送 singleQuantity
TYPE2 從 startTime 開始到 endTime 結束，每隔 interval 秒送一筆，總共 totalQuantity，剩餘張數加總至最後一筆
TYPE3 從 startTime 開始到 endTime 結束，每隔 interval 秒送一筆，總共 totalQuantity，剩餘張數從最後一筆往前分配.

intervalint下單間隔時間 (秒)
singleQuantityint單筆下單量 (股數)
totalQuantityint (Optional)總共下單量 (股數)
startTimestring開始時間
endTimestring (Optional)結束時間
caution

請注意，總共下單量需大於單筆下單量。

ConditionOrderResult​

ParameterTypeMeaning
guidstring條件單號

Constants ( 欄位對應數值 )​

BsAction​

買賣別

NameValueMeaning
BUY1買
SELL2賣
UN_SUPPORTED3不支援此型別
UN_DEFINED4未定義此型別

ConditionMarketType​

盤別

NameValueMeaning
COMMON1一般盤
FIXING2定盤
INTRADAY_ODD3盤中零股
ODD4盤後零股

TradingType​

監控類型

NameValueMeaning
REFERENCE1自動參考委託物件
SCHEDULED3時間

TriggerContent​

觸發條件

NameValueMeaning
BID_PRICE1買進價
ASK_PRICE2賣出價
MATCHED_PRICE3成交價
TOTAL_QUANTITY4總量
TIME5時間

Operator​

NameValueMeaning
GREATER_THAN_OR_EQUAL1大於等於
LESS_THAN_OR_EQUAL2小於等於
GREATER_THAN3大於
LESS_THAN4小於

StopSign​

NameValueMeaning
FULL1全部成交為止
PARTIAL2部分成交為止
UNTIL_END3效期結束為止

TimeInForce​

委託條件 (TimeInForce)

NameValueMeaning
ROD1當日有效(Rest of Day)
FOK2全部成交否則取消(Fill-or-Kill)
IOC3立即成交否則取消(Immediate-or-Cancel)
UN_SUPPORTED4不支援此型別
UN_DEFINED5未定義此型別

ConditionPriceType​

價格類型 (ConditionPriceType)

NameValueMeaning
LINIT1限價
BID_PRICE2買進價
ASK_PRICE3賣出價
MARKET4市價
MATCHED_PRICE5成交價
LIMIT_UP6漲停價
LIMIT_DOWN7跌停價
REFERENCE8參考價(平盤價)

ConditionOrderType​

委託類型 (orderType)

NameValueMeaning
STOCK1現貨
MARGIN2融資
SHORT3融券
DAY_TRADE4現股當沖

Direction​

移動鎖利上漲/下跌追蹤 (direction)

NameValueMeaning
Up1上漲
Down2下跌

SliceType​

分單型態 (SliceType)

NameMeaning
Type1從開始時間，每隔幾秒送一筆，總共送N筆，每筆送M張
Type2從開始到結束，每隔X秒送一筆，總共N張，剩餘張數加總至最後一筆
Type3從開始到結束，每隔X秒送一筆，總共N張，剩餘張數從最後一筆往前分配

ConditionStatus​

條件單狀態 (ConditionStatus)

NameMeaning
Type1今日相關查詢
Type2尚有效單
Type3條件比對中
Type4委託處理中
Type5委託成功
Type6已通知
Type7委託失敗
Type8已有成交
Type9刪除成功
Type10異常
Type11失效

HistoryStatus​

歷史條件單狀態 (HistoryStatus)

NameMeaning
Type1所有條件單 ( 不包含已刪除、失效)
Type2選擇期間內全部成交單
Type3選擇期間內部分成交單
Type4選擇期間刪除單
Type5選擇期間失效單
Type6選擇期間內已觸發記錄