參數對照表

類別

Class

OrderObject

Parameter	Type	Meaning
buy_sell	BSAction	買賣別 可選用參數 Buy 買 、 Sell 賣
symbol	string	股票代號
price	string	委託價格 （若非使用 Limit 限價，此欄代入 None）
quantity	int	委託數量
market_type	MarketType	盤別 可選用參數 Common 整股、 Fixing 定盤、 IntradayOdd 盤中零股、 Odd 盤後零股、 Emg 興櫃 、 EmgOdd 興櫃零股
price_type	PriceType	價格旗標 可選用參數為 Limit 限價、LimitUp 漲停、 LimitDown 跌停、 Market 市價、 Reference 參考價
time_in_force	TimeInForce	委託條件 可選用參數為 ROD 、 FOK 、 IOC
order_type	OrderType	委託類別 可選用參數為 Stock 現股、 Margin 融資、 Short 融券、 DayTrade 現沖先賣、 SBL 借券
user_def (optional)	string	用戶自定義 (最長10個字元，不支援特殊字元及中文、不適用興櫃)

caution

不同 market_type 對應的 quantity 之單位及範圍不同，請參考盤別說明。

caution

當 market_type 爲 MarketType.Common, MarketType.Odd, MarketType.IntradayOdd 其中之一，且 priceType 爲 PriceType.Limit 時，需填入 price 欄位，其餘時候可不設定 price 欄位或設為 None。

現股當沖

「現沖先賣」賣出時, orderType = DayTrade , buySell 需為 Sell , marketType 需為 Common
(其餘現沖進出場操作, orderType = Stock)

OrderResult

委託列表，透過 get_order_result(accounts) 取得。

參數	類別	說明
function_type	int	功能別 : 0 新單 、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 90 失敗
date	string	交易日期
seq_no	string	委託單流水序號
branch_no	string	分公司代號
account	string	帳號
order_no	string	委託書號
asset_type	int	資產類別 : 0 證券
market	string	市場類型 : TAIEX 上市股票 、 TAISDAQ 上櫃股票 、 TAIEMG 興櫃股票
market_type	MarketType	盤別種類 : Common 整股 、 Fixing 定盤 、 IntradayOdd 盤中零股 、 Odd 盤後零股 、 Emg 興櫃 、 EmgOdd 興櫃零股
stock_no	string	股票代號
buy_sell	BSAction	買賣別 : Buy 買 、 Sell 賣
price_type	PriceType	原始委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價
price	float	價格
quantity	int	原始委託股數
time_in_force	TimeInforce	委託條件別 : ROD ROD 、 FOK FOK 、 IOC IOC
order_type	OrderType	委託單類型 : Stock 現股 、 Margin 融資 、 Short 融券 、 DayTrade 現沖先賣 、 SBL借券
is_pre_order	bool	是否為預約單
status	int	委託單狀態，詳細列表請參考 STATUS
after_price_type	PriceType	有效委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價
after_price	float	有效委託價格
unit	int	單位數
after_qty	int	有效委託股數（包含已成交部分）
filled_qty	int	成交股數
filled_money	int	成交價金
before_qty	int	改單前有效量
before_price	float	改單前有效價
user_def	string	自訂欄位
last_time	string	最後異動時間（格式請見表末說明）
error_message	string	錯誤訊息
details	list	委託歷程 (查詢order_result_detail or order_history才有值)
>> function_type	int	功能別 : 0 新單 、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 50 完全成交 、 90失敗
>> modified_time	string	修改時間（格式請見表末說明）
>> before_qty	int	原始委託股數
>> after_qty	int	有效委託股數（包含已成交部分）
>> before_price	float	原始委託價
>> after_price	float	有效委託價
>> filled_money	float	成交價金
>> status	int	委託單狀態
>> err_msg	string	錯誤訊息

時間格式說明

last_time 及 modified_time 時間格式： HH:MM:SS.fff 或 HH:MM:SS （即當 .fff = .000 時省略此部分）

BatchResult

批次委託列表，透過 batch_order_lists(accounts) 取得。

Parameter	Type	Meaning
function_type	int	功能別 : 0 新單、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 90 失敗
date	string	交易日期
branch_no	string	分公司代號
account	string	帳號
batch_seq_no	string	批次單流水序號

ModifyPriceObj

改價物件

Parameter	Type	Meaning
order_result	Object	委託列表
price	string	改單後的價格
price_type	PriceType	改單後的價格類型 : Limit限價 、 LimitUp漲停 、 LimitDown跌停 、 Market市價 、 Reference參考價

ModifyQuantityObj

改量物件

Parameter	Type	Meaning
order_result	Object	委託列表
quantity	int	改單後的委託量

FilledData

成交回報物件

參數	類別	說明
date	string	日期
branch_no	string	分公司代號
account	string	帳號
seq_no	string	委託單流水序號 (只有主動回報才回傳此欄位)
order_no	string	委託書號
stock_no	string	股票代號
buy_sell	BSAction	買賣別 : Buy 買 、 Sell 賣
order_type	OrderType	委託單類型 : Stock 現股 、 Margin 融資 、 Short 融券 、 DayTrade 現沖先賣 、 SBL借券
filled_no	string	成交流水號
filled_avg_price	float	成交均價
filled_qty	int	成交股數
filled_price	float	成交單價
filled_time	string	成交時間
user_def	string	用戶自定義 (只有主動回報才回傳此欄位)

Account

帳號資訊

Parameter	Type	Meaning
name	string	客戶姓名
account	string	帳號
branch_no	string	分公司代號
account_type	string	帳號類型 ，回傳 stock證券 、futopt期貨

Constants ( 欄位對應數值 )

BSAction

買賣別 (buySell)

Name	Meaning
Buy	買
Sell	賣

MarketType

盤別

Name	Meaning
Common	整股
Fixing	定盤
IntradayOdd	盤中零股
Odd	盤後零股
Emg	興櫃
EmgOdd	興櫃零股

使用不同 MarketType 時，相對應的Quantity所代表的單位及範圍也會不同，詳如下表:

Name	Quantity Unit	Quantity Ranges
Common	千股	1000 ~ 499000
Fixing	千股	1000 ~ 499000
IntradayOdd	股	1 ~ 999
Odd	股	1 ~ 999
Emg	千股	1000 ~ 499000
EmgOdd	股	1 ~ 999

使用不同 MarketType 時，可使用的 PriceType , TimeInForce 會不同，詳如下表：

MarketType	Available PriceType	Available TimeInForce
Common	Limit 、 LimitUp 、 LimitDown 、 Market 、 Reference	ROD 、 IOC 、 FOK
Fixing	Reference	ROD
IntradayOdd	Limit 、 LimitUp 、 LimitDown 、 Reference	ROD
Odd	Limit 、 LimitUp 、 LimitDown 、 Reference	ROD
Emg	Limit	ROD
EmgOdd	Limit	ROD

PriceType

價格類型 (priceType)

Name	Meaning
Limit	限價
LimitUp	漲停
LimitDown	跌停
Market	市價
Reference	參考價 (定盤時為定盤價)

TimeInForce

委託條件 (TimeInForce)

Name	Meaning
ROD	當日有效(Rest of Day)
FOK	全部成交否則取消(Fill-or-Kill)
IOC	立即成交否則取消(Immediate-or-Cancel)

OrderType

委託類別 (orderType)

Name	Meaning
Stock	現股
Margin	融資
Short	融券
DayTrade	現沖先賣
SBL	借券

function_type

功能類別

Name	Value
新單	0
新單執行	10
改價	15
改量	20
刪單	30
完全成交（for 委託單歷程查詢）	50
失敗	90

market

市場

Name	Value
上市股票	TAIEX
上櫃股票	TAISDAQ
興櫃股票	TAIEMG

status

委託單狀態

Name	Value
預約單	0
系統將委託送往後台	4 ( 請用GetOrderResult查詢狀態 )
後台傳送中	8 ( 請用GetOrderResult查詢狀態 )
連線逾時	9 ( 請稍後再使用GetOrderResult查詢狀態 or 聯絡您的營業員 )
委託成功	10
未成交刪單成功	30
部分成交，剩餘取消	40
完全成交	50
失敗	90
委託單歷程查詢標示	14 - 改價ACK、24 - 改量ACK、34 - 刪單ACK
改價成功 （歷史委託單查詢）	15
改量成功 （歷史委託單查詢）	20
改價失敗 （主動回報）	19
改量失敗 （主動回報）	29
刪單失敗 （主動回報）	39