SubOrder.update_order 修改委託

僅限交易美股商品
修改委託流程為刪除原訂單，再建立新委託單。

Example

input
trade =api.SubOrder.update_order('1018053' ,qty=1) 
trade
output
Trade(
	order=Order(
		action=<Action.Buy: 'B'>, 
		market=<Market.US: 1>, 
		symbol='AAPL', 
		quantity=3,
		price=230.0),
	order_status=OrderStatus(
		nid=None, 
		status=None, 
		modified_time='', 
		modified_quantity=None, 
		modified_price=None, 
		deals=[]), 
	operations=[Operation(
		nid=1766556379650509004, 
		task=<Task.NewOrder>, 
		status=<Status.Pending>, 
		op_time='140619')
])

#陸續收到系統主動回報：改量事件會先執行刪單-系統已將委託轉給境外合作券商（status='委託上手中'）
Event(
	task=<Task.CancelOrder>, 
	status='委託上手中', 
	org_seqnum='1018053', 
	seqno='1018054', 
	action=<Action.Buy: 'B'>, 
	market=<Market.US: 1>, 
	symbol='AAPL', 
	quantity=0, 
	price=230.0, 
	ts='140619'
)

#陸續收到系統主動回報：改量事件會先執行刪單-成功執行
Event(
	task=<Task.CancelOrder>, 
	status='委託成功', 
	org_seqnum='1018053', 
	seqno='1018054', 
	action=<Action.Buy: 'B'>, 
	market=<Market.US: 1>, 
	symbol='AAPL', 
	quantity=0, 
	price=230, 
	ts='1406190'
)

#陸續收到系統主動回報：改量事件刪單後建立新委託單-系統處理中(status='處理中'）
Event(
	task=<Task.NewOrder>, 
	status='處理中', 
	org_seqnum='1018055', 
	seqno='1018055', 
	action=<Action.Buy: 'B'>, 
	market=<Market.US: 1>, 
	symbol='AAPL', 
	quantity=3, 
	price=230, 
	ts='1406200'
)

#陸續收到系統主動回報：改量事件刪單後建立新委託單-系統已將委託送至交易室（status='已下單至交易室'）
Event(
	task=<Task.NewOrder>, 
	status='已下單至交易室', 
	org_seqnum='1018055', 
	seqno='1018055', 
	action=<Action.Buy: 'B'>, 
	market=<Market.US: 1>, 
	symbol='AAPL', 
	quantity=3, 
	price=230.0, 
	ts='140619'
)


#陸續收到系統主動回報：改量事件刪單後建立新委託單-系統已將委託轉給境外合作券商（status='委託上手中'）
Event(
	task=<Task.NewOrder>, 
	status='委託上手中', 
	org_seqnum='1018055', 
	seqno='1018055', 
	action=<Action.Buy: 'B'>, 
	market=<Market.US: 1>, 
	symbol='AAPL', 
	quantity=3, 
	price=230, 
	ts='1406200'
)

#陸續收到系統主動回報：改量事件刪單後建立新委託單-成功執行
Event(
	task=<Task.NewOrder>, 
	status='委託成功', 
	org_seqnum='1018055', 
	seqno='1018055', 
	action=<Action.Buy: 'B'>, 
	market=<Market.US: 1>, 
	symbol='AAPL', 
	quantity=3, 
	price=230, 
	ts='1406200'
)

Attribute

參數 資料型態 說明
org_seqnum str 需要修改委託的原始單號
price float 欲改變的新價格。
qty int 欲減少的數量。

※注意，price和qty僅能輸入其中一個，不可同時修改兩者。qty僅能設定不超過當前剩餘待成交數量。

Return Attribute

當用戶提交改單請求後，系統將返回該筆委託對應的 Trade 物件，以便用戶持續追蹤該委託的最新狀態。
隨後，當市場處理完成並回報結果時，系統會主動推送對應的 Event 物件
用於通知改單是否成功以及相關資訊。