FutOrder.cancel_order 刪除委託

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

Example

input
trade=api.FutOrder.cancel_order('wAaac') 
trade 
output
Trade( 
	order=Order( 
		order_id='wAaac',  
		action=<Action.Buy: 'B'>,  
		category=<Category.FUTURE: 0>, 
		symbol='TXFH5', 
		quantity=2, 
		price=23500.0, 
		time_in_force=<TimeInForce.ROD: 0>, 
		price_type=<PriceType.LMT: 0>,  
		trade_hour=<TradeHour.REGULAR: 'R'>),  
	order_status=OrderStatus( 
		nid='00009795', 
		status=<Status.Cancelled>, 
		modified_time='094715',  
		modified_quantity=0, 
		modified_price=23500.0,  
		deals=[]),  
	operations=[ 
		Operation( 
		nid='00009795', 
		task=<Task.NewOrder>, 
		status=<Status.Success>,  
		op_time='093502'), 
		Operation( 
		nid='00009795', 
		task=<Task.CancelOrder>, 
		status=<Status.Success>, 
		op_time='094715')] 
) 
 
#陸續收到系統主動回報:刪單事件-系統處理中 
Event( 
	task=<Task.CancelOrder>, 
	status=<Status.Pending>, 
	order_id='wAaac', 
	seqno=1753767591724963001, 
	action=<Action.Buy: 'B'>, 
	category=<Category.FUTURE: 0>, 
	symbol='TXFH5',  
	quantity=0,  
	price=23500.0,  
	time_in_force=<TimeInForce.ROD: 0>, 
	trade_hour=<TradeHour.REGULAR: 'R'>, 
	ts='135426' 
) 
 
#陸續收到系統主動回報:刪單事件-成功執行 
Event( 
	task=<Task.CancelOrder>, 
	status=<Status.Success>, 
	order_id='wAaac', 
	seqno='00009795', 
	action=<Action.Buy: 'B'>, 
	category=<Category.FUTURE: 0>, 
	symbol='TXFH5',  
	quantity=0,  
	price=23500.0,  
	time_in_force=<TimeInForce.ROD: 0>, 
	trade_hour=<TradeHour.REGULAR: 'R'>, 
	ts='135426' 
) 

Attribute

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

Return Attribute

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