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