Order.cancel_order 刪除委託

此方法允許用戶取消之前提交,但尚未成交的交易訂單。

Example

input
trade=api.Order.cancel_order('Y0011') 
trade 
output
Trade( 
	order= 
		Order(order_id='Y0011',  
		action=<Action.Buy: 'B'>,  
		symbol='1101',  
		quantity=5,  
		price=23.0,  
		order_cond=<OrderCond.CASH: 0>,  
		time_in_force=<TimeInForce.ROD: 0>,  
		price_type=<PriceType.LMT: 0>,  
		odd_lot=<OddLot.Common: 0>),  
	order_status= 
		OrderStatus(nid='00006869',  
		status=<Status.Submitted>,  
		modified_time='174112',  
		modified_quantity=5, 
		modified_price=23.0,  
		deals=[]),  
	operations= 
		[Operation(nid='00006869', 
		task=<Task.NewOrder>,  
		status=<Status.Success>,  
		op_time='174112'),  
		Operation(nid=15390342880924456015,  
		task=<Task.CancelOrder>,  
		status=<Status.Pending>,  
		op_time='174143')] 
) 

#陸續收到系統主動回報:刪單事件-系統處理中 
Event( 
	task=<Task.CancelOrder>,  
	status=<Status.Pending>,  
	order_id='Y0011'  
	seqno='15390342880924456015', 
	action=<Action.Buy: 'B'>,  
	symbol='1101',  
	quantity=0,  
	price=23.0,  
	order_cond=<OrderCond.CASH: 0>,  
	time_in_force=<TimeInForce.ROD: 0>,  
	odd_lot=<OddLot.Common: 0>,  
	ts='174143' 
) 

#陸續收到系統主動回報:刪單事件-成功執行 
Event( 
	task=<Task.CancelOrder>,  
	status=<Status.Success>,  
	order_id='Y0011'  
	seqno='00006870', 
	action=<Action.Buy: 'B'>,  
	symbol='1101',  
	quantity=0,  
	price=23.0,  
	order_cond=<OrderCond.CASH: 0>,  
	time_in_force=<TimeInForce.ROD: 0>,  
	odd_lot=<OddLot.Common: 0>,  
	ts='174143' 
) 

Attribute

參數 資料型態 說明
order_id str 需要取消的訂單的唯一識別碼。

Return Attribute

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