此方法允許用戶取消之前提交,但尚未成交的交易訂單。
trade=api.FutOrder.cancel_order('wAaac')
trade
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'
)
| 參數 | 資料型態 | 說明 |
|---|---|---|
| order_id | str | 需要取消的委託的唯一識別碼。 |
當用戶提交改單請求後,系統將返回該筆委託對應的 Trade 物件,以便用戶持續追蹤該委託的最新狀態。
隨後,當市場處理完成並回報結果時,系統會推送對應的 Event 物件,用於通知刪單是否成功以及相關資訊。